Connectwise MCP Server

🚀 ConnectWise 管理 MCP 服務器

這是一個提供與 ConnectWise Manage API 集成的模型上下文協議 (Model Context Protocol) 服務器。它允許 Claude 通過 ConnectWise Manage API 執行操作，如檢索票證、公司、聯繫人等，為相關業務流程提供了便利。

🚀 快速開始

本服務器允許 Claude 藉助 ConnectWise Manage API 開展操作，如檢索票證、公司、聯繫人等。使用前需完成安裝與配置。

✨ 主要特性

• 使用 API 密鑰進行身份驗證，保障系統安全。
• 支持檢索票證、公司、聯繫人和其他實體，滿足多樣化的數據獲取需求。
• 能夠創建、更新和刪除實體，實現對數據的全面管理。
• 提供查詢過濾和分頁支持，方便數據的篩選與查看。

📦 安裝指南

使用 NPM

npm install -g connectwise-mcp-server

手動設置

1. 克隆此倉庫。
2. 安裝依賴項：npm install。
3. 構建項目：npm run build。
4. 啟動服務器：npm start。

📚 詳細文檔

配置

要使用此 MCP 服務器，您需要提供 ConnectWise Manage API 憑據：

• 公司 ID
• 公共密鑰
• 私有密鑰
• ConnectWise 管理 URL（例如 api - na.myconnectwise.net）

Claude 桌面配置

將以下內容添加到您的 Claude 桌面配置文件中（通常位於 ~/Library/Application Support/Claude/claude_desktop_config.json，macOS）：

{
  "mcpServers": {
    "connectwise": {
      "command": "npx",
      "args": ["-y", "connectwise-mcp-server"],
      "env": {
        "CW_COMPANY_ID": "your_company_id",
        "CW_PUBLIC_KEY": "your_public_key",
        "CW_PRIVATE_KEY": "your_private_key",
        "CW_URL": "api-na.myconnectwise.net"
      },
      "options": {
        "autoStart": true,
        "logLevel": "info"
      }
    }
  }
}

可用功能

💻 使用示例

基礎用法

以下是一些基礎功能的使用示例：

搜索票證

在 ConnectWise 管理中搜索服務票證。

cw_search_tickets(conditions, page_size, page)

獲取票證

通過 ID 檢索特定的服務票證。

cw_get_ticket(ticket_id)

創建票證

創建新的服務票證。

cw_create_ticket(summary, description, board_id, company_id)

搜索公司

在 ConnectWise 管理中搜索公司。

cw_search_companies(conditions, page_size, page)

獲取公司

通過 ID 檢索特定的公司。

cw_get_company(company_id)

📄 許可證

本項目採用 MIT 許可證。