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

传输模式

模式	设置方式	适用场景
`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

许可证

MIT

This server cannot be installed

A

license - permissive license

-

quality - not tested

C

maintenance

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

connectwise-sell-mcp