Connectwise MCP

连接MCP

ConnectWise MCP服务器，配备HTTP网关和Cloudflare隧道。

结构

.
├── deploy/
│   ├── cwm-mcp/              # Core MCP tools (ConnectWise API gateway)
│   ├── http-gateway/         # HTTP gateway (OAuth + token auth)
│   └── supergateway/         # Legacy/optional
├── docs/
│   ├── README.md             # Docs index
│   ├── chatgpt-connector.md  # ChatGPT connector setup
│   ├── claude-setup.md       # Claude MCP setup
│   ├── azure-ad-checklist.md # Azure AD setup checklist
│   ├── troubleshooting.md    # Common issues and checks
│   └── n8n-setup.md           # n8n setup
└── README.md

建筑

┌──────────────────────────┐    HTTPS    ┌──────────────────────┐    HTTP    ┌──────────────────────┐
│ MCP Clients              │────────────▶│ Cloudflare Tunnel     │──────────▶│ HTTP Gateway (FastAPI)│
│ (ChatGPT / Claude / etc) │             │ connectwisemcp...     │           │ - OAuth 2.1 + PKCE    │
└──────────────────────────┘             └──────────────────────┘           │ - DCR endpoints       │
                                                                            │ - Azure AD login      │
                                                                            │ - /mcp + /sse         │
                                                                            └───────────┬──────────┘
                                                                                        │
                                                                                        ▼
                                                                            ┌──────────────────────┐
                                                                            │ MCP Tools (cwm-mcp)  │
                                                                            │ ConnectWise API      │
                                                                            └──────────────────────┘

Docker设置（网关+隧道）

Docker设置位于 deploy/http-gateway/docker-compose.yml 并运行：

• mcp-gateway （FastAPI HTTP网关）
• cloudflared （Cloudflare隧道）

步骤：

1. 复制env模板并填写值：

cp deploy/http-gateway/.env.example deploy/http-gateway/.env

所需值：

• MCP_STATIC_TOKEN （强随机令牌）
• JWT_SECRET_KEY （OAuth令牌需要）
• CONNECTWISE_* 变量
• CLOUDFLARE_TUNNEL_TOKEN

1. 构建+运行：

cd deploy/http-gateway
docker compose up -d --build

1. 验证：

curl http://127.0.0.1:8000/health

笔记：

• 网关绑定到 127.0.0.1:8000 并且仅通过Cloudflare公开。
• 确保您的Cloudflare隧道路由 connectwisemcp.funcshun.com 对于这项服务。

本地macOS安装（Homebrew+Docker）

如果您想在本地运行MCP网关并将Claude连接到 127.0.0.1.

1. 安装Homebrew+工具：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install git
brew install --cask docker

打开 Docker 桌面版 一次，等待它开始。

1. 克隆仓库：

git clone https://github.com/luckyludev/ConnectwiseMCP.git
cd ConnectwiseMCP

1. 配置本地环境：

cp deploy/http-gateway/.env.example deploy/http-gateway/.env

编辑 deploy/http-gateway/.env 并设置：

• MCP_STATIC_TOKEN （强随机令牌）
• JWT_SECRET_KEY （强随机秘密）
• CONNECTWISE_* 价值观
• SERVER_URL=http://127.0.0.1:8000
• MCP_RESOURCE_URL=http://127.0.0.1:8000

1. 启动本地网关（Docker）：

cd deploy/http-gateway
docker compose up -d --build mcp-gateway

验证：

curl http://127.0.0.1:8000/health

1. 在Claude中添加本地MCP服务器：

• 姓名： ConnectwiseMCP (Local)
• 服务器URL: http://127.0.0.1:8000/sse
• 认证： 持有者代币
• 令牌： 你的 MCP_STATIC_TOKEN

如果您也想要Cloudflare隧道，请设置 CLOUDFLARE_TUNNEL_TOKEN 并运行 docker compose up -d --build 没有服务名称。

快速启动（令牌认证）

1. 本地测试：

curl -H "Authorization: Bearer YOUR_TOKEN" http://127.0.0.1:8000/mcp

1. 通过Cloudflare进行测试：

curl -H "Authorization: Bearer YOUR_TOKEN" https://connectwisemcp.funcshun.com/mcp

复制/粘贴JSON-RPC示例

列出工具：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list",
  "params": {}
}

调用工具：

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "search_api_endpoints",
    "arguments": {
      "query": "tickets",
      "max_results": 5
    }
  }
}

OAuth+客户端指南

• ChatGPT docs/chatgpt-connector.md
• 克劳德： docs/claude-setup.md
• n8n： docs/n8n-setup.md
• Copilot工作室+Azure： docs/copilot-studio-azure.md
• Azure AD检查表： docs/azure-ad-checklist.md
• 故障排除： docs/troubleshooting.md

安全说明

• 不要承诺 .env 文件夹。
• 旋转以前提交的所有凭据。

遗产

deploy/supergateway 保留以供参考。