ConnectWise Manage MCP Server

让您的 AI 助手直接使用 ConnectWise Manage 工作。 通过自然对话搜索工单、记录时间、查找公司和联系人、管理项目——而不是在 CWM 界面中反复点击。

这是一个 Model Context Protocol (MCP) 服务器，为 Claude（或任何兼容 MCP 的 AI）提供 51 个工具，涵盖 ConnectWise Manage 机构日常运营所依赖的操作。它同时支持云托管和自托管的 CWM 实例——只需将其指向您的服务器即可。

属于 MSP Claude Plugins 生态系统的一部分——一个不断壮大的 MSP 技术栈 AI 集成套件，包括 Autotask、Datto RMM、IT Glue、HaloPSA、NinjaOne、Huntress 等。由 MSP 构建，为 MSP 服务。

一键部署

关于注册表认证的说明： 此服务器仅依赖公共 npm 包，因此 Cloudflare 和 DigitalOcean 云构建器会匿名安装其依赖项——一键部署无需任何令牌。（如果未来版本添加了私有 @wyre-ai/* 依赖，您需要提供一个具有 read:packages 权限的 GitHub PAT 作为构建变量——Cloudflare Workers 使用 NODE_AUTH_TOKEN，DigitalOcean 使用构建时的 GITHUB_TOKEN 密钥。）

安装已发布的包： 发布的包发布在 GitHub Packages npm 注册表上，每次安装都需要认证（即使是公共包）。要安装它，请使用具有 read:packages 权限的 GitHub PAT 对 npm.pkg.github.com 进行 npm 认证：

export NODE_AUTH_TOKEN=$(gh auth token)
npm install @wyre-ai/connectwise-manage-mcp

要部署到 Azure Container Apps（配合 Entra ID OAuth 2.1），请参阅 AZURE_ACA_DEPLOYMENT.md。

Related MCP server: Autotask MCP Server

配置

环境变量

API 基础 URL（CW_MANAGE_URL）

对于自托管实例，请将 CW_MANAGE_URL 设置为服务器的基本 URL。服务器会自动追加 /v4_6_release/apis/3.0，除非 URL 已包含该路径。

如果您的自托管实例使用自签名证书，请同时设置 CW_MANAGE_REJECT_UNAUTHORIZED=false。

获取您的 API 密钥

1. 登录您的 ConnectWise Manage 实例

2. 导航至 系统 > 成员 > API 成员

3. 使用适当的权限创建新的 API 成员

4. 为该成员生成 API 密钥

5. 从 ConnectWise Developer Portal 获取您的客户端 ID

可用工具

交互式工单卡片（MCP 应用）

cw_get_ticket 在 MCP Apps 主机（Claude Desktop/web）中呈现为交互式卡片，可通过 cw_add_ticket_note 在卡片内进行“添加备注”的往返操作，该操作始终发布仅内部可见（internalAnalysisFlag）的备注；在其他主机中，纯 JSON 行为保持不变。该卡片默认外观中性，可通过 window.__BRAND__ 注入或 MCP_BRAND_* 环境变量（MCP_BRAND_NAME、MCP_BRAND_LOGO_URL、MCP_BRAND_PRIMARY_COLOR、MCP_BRAND_ACCENT_COLOR、MCP_BRAND_BG、MCP_BRAND_TEXT）进行品牌化定制——无需重新构建。

工单

• cw_search_tickets — 按条件搜索服务工单

• cw_get_ticket — 按 ID 获取工单

• cw_create_ticket — 创建新的服务工单

• cw_update_ticket — 更新工单（JSON Patch）

• cw_get_ticket_notes — 获取工单上的所有备注（包括子工单备注）

• cw_add_ticket_note — 向工单添加备注（讨论、内部或解决）

公司

• cw_search_companies — 搜索公司

• cw_get_company — 按 ID 获取公司

• cw_create_company — 创建新公司

• cw_update_company — 更新公司（JSON Patch）

联系人

• cw_search_contacts — 搜索联系人

• cw_get_contact — 按 ID 获取联系人

• cw_create_contact — 创建新联系人

项目

• cw_search_projects — 搜索项目

• cw_get_project — 按 ID 获取项目

• cw_create_project — 创建新项目

• cw_search_project_tickets — 搜索项目下的工单

• cw_get_project_ticket — 按 ID 获取特定的项目工单

• cw_get_project_ticket_notes — 获取项目工单上的所有备注（包括子工单备注）

• cw_add_project_ticket_note — 向项目工单添加备注（讨论、内部或解决）

时间条目

• cw_search_time_entries — 搜索时间条目

• cw_get_time_entry — 按 ID 获取时间条目

• cw_create_time_entry — 创建新时间条目

成员

• cw_search_members — 搜索成员/技术人员

• cw_get_member — 按 ID 获取成员

配置项

• cw_search_configurations — 搜索配置项（资产）

• cw_get_configuration — 按 ID 获取配置项

服务参考数据

• cw_list_boards — 列出服务面板

• cw_list_priorities — 列出工单优先级

• cw_list_statuses — 列出某个面板的状态

活动

• cw_search_activities — 搜索活动

• cw_get_activity — 按 ID 获取活动

• cw_create_activity — 创建新活动

协议

• cw_search_agreements — 搜索协议

• cw_get_agreement — 按 ID 获取协议

• cw_get_agreement_additions — 获取协议上的附加项（行项目）

发票

• cw_search_invoices — 搜索发票

• cw_get_invoice — 按 ID 获取发票

商机

• cw_search_opportunities — 搜索商机

• cw_get_opportunity — 按 ID 获取商机

• cw_search_opportunity_forecasts — 搜索商机预测行

• cw_search_opportunity_notes — 搜索商机上的备注

• cw_search_sales_stages — 列出销售管道阶段

目录（产品）

• cw_search_catalog_items — 搜索产品目录项

• cw_get_catalog_item — 按 ID 获取目录项

• cw_create_catalog_item — 创建新的目录项

• cw_update_catalog_item — 更新目录项（JSON Patch）

• cw_list_catalog_categories — 列出目录类别

• cw_list_catalog_subcategories — 列出目录子类别

• cw_list_manufacturers — 列出制造商

健康检查

• cw_test_connection — 测试连接（请求 /system/info）

用法

使用 Claude Desktop

添加到您的 claude_desktop_config.json：

{
  "mcpServers": {
    "connectwise-manage": {
      "command": "npx",
      "args": ["@wyre-ai/connectwise-manage-mcp"],
      "env": {
        "CW_MANAGE_COMPANY_ID": "your-company-id",
        "CW_MANAGE_PUBLIC_KEY": "your-public-key",
        "CW_MANAGE_PRIVATE_KEY": "your-private-key",
        "CW_MANAGE_CLIENT_ID": "your-client-id"
      }
    }
  }
}

对于自托管实例：

{
  "mcpServers": {
    "connectwise-manage": {
      "command": "npx",
      "args": ["@wyre-ai/connectwise-manage-mcp"],
      "env": {
        "CW_MANAGE_URL": "https://cwm.yourcompany.com",
        "CW_MANAGE_COMPANY_ID": "your-company-id",
        "CW_MANAGE_PUBLIC_KEY": "your-public-key",
        "CW_MANAGE_PRIVATE_KEY": "your-private-key",
        "CW_MANAGE_CLIENT_ID": "your-client-id",
        "CW_MANAGE_REJECT_UNAUTHORIZED": "false"
      }
    }
  }
}

使用 Docker

docker compose up -d

HTTP 传输（网关模式）

使用 HTTP 传输运行，适用于多租户网关部署：

MCP_TRANSPORT=http AUTH_MODE=gateway node dist/index.js

通过请求头按请求传递凭据：X-CW-Company-Id、X-CW-Public-Key、X-CW-Private-Key、X-CW-Client-Id，以及可选的 X-CW-URL。

开发

# Install dependencies
npm install

# Build
npm run build

# Run in development
npm run dev

# Type check
npm run typecheck

# Run tests
npm test

贡献

1. Fork 此仓库

2. 创建功能分支（git checkout -b feature/amazing-feature）

3. 提交您的更改（git commit -m 'Add amazing feature'）

4. 推送到分支（git push origin feature/amazing-feature）

5. 打开一个 Pull Request

许可证

Apache-2.0

由 WYRE Technology 构建——属于 MSP Claude Plugins 生态系统的一部分