Connectwise Manage MCP

ConnectWise管理MCP服务器

 ](https://nodejs.org/)

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

这是一个 模型上下文协议（MCP） 为Claude（或任何兼容MCP的AI）提供34个工具的服务器，涵盖了ConnectWise Manage商店所依赖的日常运营。可与两者配合使用 云托管和自托管 CWM实例——只需将其指向您的服务器即可。

一键部署



用于部署到 Azure容器应用 使用Entra ID OAuth 2.1，请参阅 AZURE_ACA_部署.md.

配置

环境变量

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. 从获取您的客户ID ConnectWise开发人员门户

可用工具

门票

• cw_search_tickets --搜索有条件的服务票
• cw_get_ticket --凭身份证买票
• cw_create_ticket --创建新的服务票证
• cw_update_ticket --更新票证（JSON补丁）
• cw_get_ticket_notes --获取门票上的所有备注（包括儿童门票备注）
• cw_add_ticket_note --在工单上添加注释（讨论、内部或决议）

公司

• cw_search_companies --搜索公司
• cw_get_company --通过ID获取公司
• cw_create_company --创建新公司
• cw_update_company --更新公司（JSON补丁）

联系人

• 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_test_connection --测试连接（点击 /system/info)

用法

使用克劳德桌面

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "connectwise-manage": {
      "command": "npx",
      "args": ["@wyre-technology/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-technology/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. 分叉存储库
2. 创建要素分支(git checkout -b feature/amazing-feature)
3. 提交您的更改(git commit -m 'Add amazing feature')
4. 推到分支(git push origin feature/amazing-feature)
5. 打开拉取请求

许可证

阿帕奇-2.0

______________________________________________________________________