connectwise-sell-mcp MCP 服务说明文档

1. 服务概述一句话简介ConnectWise Sell REST API的FastMCP HTTP服务器包装器提供12个工具管理报价、行项目、标签、客户、条款、模板、经常性收入和税码服务名称connectwise-sell-mcp版本号最新版本通过PyPI发布开发者/提供方Mfrostbutter协议类型MCP (Model Context Protocol)2. 核心功能该MCP服务提供12个工具分为三大类2.1 报价管理5个工具list_quotes列出所有报价get_quote获取特定报价的详细信息get_quote_versions获取报价的版本信息copy_quote从现有报价或模板复制创建新报价update_quote更新现有报价2.2 报价详情4个工具get_quote_items获取报价中的行项目get_quote_tabs获取报价的标签页信息get_quote_customers获取报价关联的客户信息get_quote_terms获取报价的条款信息2.3 参考数据3个工具get_templates获取报价模板列表get_recurring_revenues获取经常性收入项目get_tax_codes获取税码信息3. 使用场景该服务适合在以下情况下使用报价管理列出、查看和管理ConnectWise Sell中的报价报价创建从模板或现有报价创建新报价注意不能从头创建报价更新更新现有报价的详细信息、行项目和条款客户管理查看和管理报价关联的客户信息模板浏览浏览可用的报价模板选择合适的模板创建报价财务分析查看经常性收入和税码信息进行财务分析4. 接入方式4.1 服务端点该服务支持两种传输模式模式设置方式适用场景HTTP默认MCP_TRANSPORThttp持久服务器跨会话或团队成员共享stdioMCP_TRANSPORTstdioCursor、VS Code、Zed、Continue等stdio客户端4.2 认证与权限该服务使用ConnectWise Sell API的HTTP Basic认证认证方式HTTP Basic Auth凭据格式base64(accessKeyusername:password)API用户必须是Sell API用户非普通用户4.3 数据格式服务使用以下数据格式请求格式JSON响应格式JSONAPI基础URLhttps://sellapi.quosalsell.com可自定义4.4 环境变量配置变量名必需默认值说明SELL_ACCESS_KEY是-从Sell URL参数中获取的访问密钥SELL_USERNAME是-Sell API用户名必须是API用户SELL_PASSWORD是-Sell API密码SELL_BASE_URL否https://sellapi.quosalsell.comAPI基础URL可自定义MCP_AUTH_TOKEN否-MCP客户端认证的Bearer令牌SELL_MCP_PORT否8086HTTP监听端口4.5 服务器配置HTTP模式配置Claude Desktop、Claude Code{ mcpServers: { connectwise-sell: { type: http, url: http://localhost:8086/mcp, headers: { Authorization: Bearer your_token_here } } } }stdio模式配置Cursor、VS Code、Zed、Continue{ 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 } } } }5. 接口定义工具名称功能描述参数说明list_quotes列出所有报价可选过滤参数get_quote获取特定报价详情quote_id: 报价IDget_quote_versions获取报价版本信息quote_id: 报价IDcopy_quote复制创建新报价source_quote_id: 源报价ID或模板IDupdate_quote更新报价quote_id: 报价ID, update_data: 更新数据get_quote_items获取报价行项目quote_id: 报价IDget_quote_tabs获取报价标签页quote_id: 报价IDget_quote_customers获取报价客户quote_id: 报价IDget_quote_terms获取报价条款quote_id: 报价IDget_templates获取报价模板列表无参数get_recurring_revenues获取经常性收入可选过滤参数get_tax_codes获取税码信息可选过滤参数6. 快速开始6.1 环境要求Python 3.8或更高版本ConnectWise Sell账户和API凭据uvx推荐或pip包管理器6.2 获取API凭据如何找到访问密钥登录ConnectWise Sell查看URL找到类似accessKeyXXXXXXXX的参数该值即为您的SELL_ACCESS_KEY6.3 安装步骤方法1使用uvx安装推荐uvx connectwise-sell-mcp方法2使用pip安装pip install connectwise-sell-mcp connectwise-sell-mcp方法3从源码安装git clone https://github.com/Mfrostbutter/connectwise-sell-mcp cd connectwise-sell-mcp cp .env.example .env # 编辑.env文件填入SELL_*凭据 python3 -m venv venv source venv/bin/activate # Linux/macOS # 或 venv\Scripts\activate # Windows pip install -r requirements.txt python3 server.py # 验证curl http://localhost:8086/health6.4 配置环境变量创建.env文件SELL_ACCESS_KEYyour_access_key_here SELL_USERNAMEyour_api_username SELL_PASSWORDyour_api_password MCP_TRANSPORThttp SELL_MCP_PORT80866.5 使用示例示例1列出最近的报价 列出我最近的报价 示例2从模板创建新报价 从模板创建一个新报价使用模板ID 12345 示例3查看报价详情 获取报价ID 67890的详细信息 示例4更新报价 更新报价ID 67890将状态改为已发送7. 注意事项重要提醒报价创建限制报价不能通过Sell API从头创建新报价必须从现有报价或模板复制。使用get_templates浏览模板然后使用copy_quote创建API用户要求必须是Sell API用户普通用户凭据无法使用认证格式服务器自动构造复合凭据 base64(accessKeyusername:password)传输模式选择HTTP模式适合持久服务器可跨会话或团队成员共享stdio模式适合Cursor、VS Code、Zed、Continue等stdio客户端服务器按会话生成无端口无持久进程作为系统服务运行创建systemd服务文件/etc/systemd/system/connectwise-sell-mcp.service[Unit] DescriptionConnectWise Sell MCP Afternetwork.target [Service] Usermcp WorkingDirectory/opt/connectwise-sell-mcp EnvironmentFile/opt/connectwise-sell-mcp/.env ExecStart/opt/connectwise-sell-mcp/venv/bin/python3 server.py Restartalways [Install] WantedBymulti-user.target相关项目connectwise-mcpConnectWise Manage MCP服务器工单、协议、公司、时间、财务总结connectwise-sell-mcp是一个功能完整的ConnectWise Sell API包装器提供了12个工具覆盖报价管理的各个方面。通过支持HTTP和stdio两种传输模式它可以灵活地集成到各种MCP客户端中。需要注意的是由于Sell API的限制新报价必须从模板或现有报价复制创建这要求用户在使用前先了解可用的模板。