Skip to main content
Glama
Mfrostbutter

connectwise-sell-mcp

by Mfrostbutter

ConnectWise Sell MCP 服务器

封装 ConnectWise Sell (Quosal) REST API 的 FastMCP HTTP 服务器。包含 12 个工具,涵盖报价、行项目、标签页、客户、条款、模板、经常性收入和税码。

注意: 报价无法通过 Sell API 从零创建 —— 新报价必须从现有报价或模板中复制。请使用 get_templates 浏览模板,然后使用 copy_quote 进行创建。

安装

通过 uvx(推荐 —— 无需克隆,无需 venv):

uvx connectwise-sell-mcp

通过环境变量或工作目录中的 .env 文件设置凭据。

通过 pip:

pip install connectwise-sell-mcp
connectwise-sell-mcp

从源码安装:

git clone https://github.com/Mfrostbutter/connectwise-sell-mcp
cd connectwise-sell-mcp
cp .env.example .env
# fill in your SELL_* credentials
python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt
python3 server.py
# verify: curl http://localhost:8086/health

Related MCP server: sherweb-mcp

传输模式

模式

设置方式

适用场景

http (默认)

MCP_TRANSPORT=http

在会话或团队成员间共享的持久化服务器

stdio

MCP_TRANSPORT=stdio

Cursor、VS Code、Zed、Continue 或任何基于 stdio 的 MCP 客户端

在 stdio 模式下,服务器由客户端按会话启动 —— 无端口,无持久化进程。

环境变量

变量

必需

默认值

说明

SELL_ACCESS_KEY

是

—

登录后在 Sell URL 参数中找到

SELL_USERNAME

是

—

Sell API 用户名(必须是 API 用户)

SELL_PASSWORD

是

—

Sell API 密码

SELL_BASE_URL

否

https://sellapi.quosalsell.com

如果您的实例使用不同的主机,请覆盖此项

MCP_AUTH_TOKEN

否

—

用于 MCP 客户端认证的 Bearer 令牌;省略则无需认证运行

SELL_MCP_PORT

否

8086

HTTP 监听端口

如何查找您的访问密钥 (Access Key)

登录 ConnectWise Sell 并查看 URL —— 它将包含类似 accessKey=XXXXXXXX 的参数。该值即为您的 SELL_ACCESS_KEY。

认证

Sell API 使用带有复合凭据的 HTTP Basic 认证:

Authorization: basic base64(accessKey+username:password)

服务器会自动根据您的环境变量构建此凭据。

工具 (12)

报价 (5): list_quotes, get_quote, get_quote_versions, copy_quote, update_quote

报价详情 (4): get_quote_items, get_quote_tabs, get_quote_customers, get_quote_terms

参考 (3): get_templates, get_recurring_revenues, get_tax_codes

客户端配置

HTTP 模式 — Claude Desktop, Claude Code(服务器持久运行):

claude_desktop_config.json / .claude/settings.json:

{
  "mcpServers": {
    "connectwise-sell": {
      "type": "http",
      "url": "http://localhost:8086/mcp",
      "headers": { "Authorization": "Bearer your_token_here" }
    }
  }
}

stdio 模式 — Cursor, VS Code, Zed, Continue 或任何 stdio 客户端(服务器按会话启动):

{
  "mcpServers": {
    "connectwise-sell": {
      "command": "uvx",
      "args": ["connectwise-sell-mcp"],
      "env": {
        "SELL_ACCESS_KEY": "your_access_key",
        "SELL_USERNAME": "your_api_username",
        "SELL_PASSWORD": "your_password",
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

作为服务运行

[Unit]
Description=ConnectWise Sell MCP
After=network.target

[Service]
User=mcp
WorkingDirectory=/opt/connectwise-sell-mcp
EnvironmentFile=/opt/connectwise-sell-mcp/.env
ExecStart=/opt/connectwise-sell-mcp/venv/bin/python3 server.py
Restart=always

[Install]
WantedBy=multi-user.target

相关项目

  • connectwise-mcp — ConnectWise Manage MCP 服务器(工单、协议、公司、时间、财务)

许可证

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    A
    maintenance
    MCP server for Sherweb Partner API - distributor billing, service provider management, customer subscriptions, and payable charges
    12
    Apache 2.0
  • A
    license
    Not graded
    quality
    C
    maintenance
    MCP server exposing Accelo quote tools (list, get, create, update) with per-user OAuth authentication for natural language interaction.
    1
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    This MCP server simplifies interaction with the ConnectWise Manage API through API discovery, execution, and a fast memory system for efficient workflows.
    8 npm
    -