CWM API Gateway MCP

ConnectWise API网关MCP服务器，提供简化的API发现、执行和管理接口，支持自然语言搜索和快速记忆常用查询。

开发者工具客户支持 #API网关 #快速查询 #自然语言 #自动化 .Python

评分 : 2.5分

下载量 : 20

更新时间 : 2025-04-28

什么是ConnectWise API Gateway?

这是一个专为ConnectWise Manage系统设计的API智能网关，通过自然语言处理技术简化复杂的API操作流程。它能自动翻译用户需求为API调用，显著降低技术门槛。

如何使用API Gateway?

通过简单的自然语言指令或预设命令即可操作，系统会自动匹配最佳API端点并处理认证、参数转换等复杂过程。

适用场景

特别适合： - 非技术人员执行复杂API操作 - 快速构建与ConnectWise的集成 - 高频重复性API任务自动化 - 探索ConnectWise API功能

核心功能

智能API发现通过关键词或自然语言描述快速定位API端点，无需记忆复杂路径

快速记忆系统自动保存常用API查询，支持一键调用历史操作

智能错误处理自动解析API错误并提供修复建议，降低调试难度

自适应学习系统会记录您的使用习惯，优先推荐常用功能

优势与局限性

优势

降低90%的API学习成本

将典型API调用时间从分钟级缩短到秒级

无需编写代码即可完成复杂集成

自动维护API认证凭据

局限性

仅支持ConnectWise Manage系统

部分边缘功能仍需直接调用原生API

首次配置需要技术协助

使用指南

环境准备

确保已安装Node.js 16+或Python 3.10+运行环境

安装服务

推荐使用NPM一键安装（需管理员权限）

配置认证

设置环境变量（以下为示例值，请替换为实际值）

典型应用场景

工单管理快速查询和处理服务工单

客户报告自动生成客户活动报告

常见问题解答

需要编程经验才能使用吗？

如何获得API认证信息？

系统会自动更新吗？

学习资源

官方API文档

ConnectWise官方API参考文档

GitHub仓库

项目源代码和问题追踪

视频教程

10分钟快速入门视频

安装

复制以下命令到你的Client进行配置

{
  "mcpServers": {
    "CWM-API-Gateway-MCP": {
      "command": "npx",
      "args": [
        "-y",
        "@jasondsmith72/CWM-API-Gateway-MCP"
      ],
      "env": {
        "CONNECTWISE_API_URL": "https://na.myconnectwise.net/v4_6_release/apis/3.0",
        "CONNECTWISE_COMPANY_ID": "your_company_id",
        "CONNECTWISE_PUBLIC_KEY": "your_public_key",
        "CONNECTWISE_PRIVATE_KEY": "your_private_key",
        "CONNECTWISE_AUTH_PREFIX": "yourprefix+"
      }
    }
  }
}

{
  "mcpServers": {
    "CWM-API-Gateway-MCP": {
      "command": "node",
      "args": ["C:/path/to/CWM-API-Gateway-MCP/bin/server.js"],
      "env": {
        "CONNECTWISE_API_URL": "https://na.myconnectwise.net/v4_6_release/apis/3.0",
        "CONNECTWISE_COMPANY_ID": "your_company_id",
        "CONNECTWISE_PUBLIC_KEY": "your_public_key",
        "CONNECTWISE_PRIVATE_KEY": "your_private_key",
        "CONNECTWISE_AUTH_PREFIX": "yourprefix+"
      }
    }
  }
}

{
  "mcpServers": {
    "CWM-API-Gateway-MCP": {
      "command": "python",
      "args": ["C:/path/to/CWM-API-Gateway-MCP/api_gateway_server.py"],
      "env": {
        "CONNECTWISE_API_URL": "https://na.myconnectwise.net/v4_6_release/apis/3.0",
        "CONNECTWISE_COMPANY_ID": "your_company_id",
        "CONNECTWISE_PUBLIC_KEY": "your_public_key",
        "CONNECTWISE_PRIVATE_KEY": "your_private_key",
        "CONNECTWISE_AUTH_PREFIX": "yourprefix+"
      }
    }
  }
}

{
  "mcpServers": {
    "CWM-API-Gateway-MCP": {
      "command": "python3",
      "args": ["/path/to/CWM-API-Gateway-MCP/api_gateway_server.py"],
      "env": {
        "CONNECTWISE_API_URL": "https://na.myconnectwise.net/v4_6_release/apis/3.0",
        "CONNECTWISE_COMPANY_ID": "your_company_id",
        "CONNECTWISE_PUBLIC_KEY": "your_public_key",
        "CONNECTWISE_PRIVATE_KEY": "your_private_key",
        "CONNECTWISE_AUTH_PREFIX": "yourprefix+"
      }
    }
  }
}

注意：您的密钥属于敏感信息，请勿与任何人分享。

🚀 连接器使用说明

本项目是一个与ConnectWise平台集成的连接器，能够实现自动化数据同步、智能查询优化等功能，帮助用户高效地与ConnectWise平台进行交互。

🚀 快速开始

要将此连接器与ConnectWise平台集成，请按照以下步骤操作：

📦 安装指南

安装必要的软件包

确保您已安装Python 3.x版本，并运行以下命令安装所需依赖项：

pip install requests jsonschema

设置环境变量

在系统环境中设置以下变量：

CONNECTWISE_COMPANY_ID=your_company_id
CONNECTWISE_PUBLIC_KEY=your_public_key
CONNECTWISE_PRIVATE_KEY=your_private_key
CONNECTWISE_AUTH_PREFIX=your_auth_prefix

配置数据库连接

确保api_gateway.db文件存在于项目目录中。如果文件不存在，请运行以下命令生成初始数据库：

python build_database.py

启动服务

在终端或命令提示符下，运行以下命令启动连接器：

python api_gateway.py

访问接口

打开浏览器并导航到http://localhost:8080。
使用您的ConnectWise凭证登录。

✨ 主要特性

自动化数据同步

实时更新：系统会自动检测和同步ConnectWise中的最新数据。
批处理操作：支持大量数据的高效处理，减少API调用次数。
错误恢复：具备断点续传功能，确保数据传输的完整性。

智能查询优化

自适应过滤器：根据历史查询行为动态调整搜索条件。
字段选择：仅请求相关字段，提升响应速度和减少带宽使用。
结果分页：支持大容量数据集的高效处理，通过page和pageSize参数控制返回的数据量。

快速故障排除

数据库连接问题

sqlite3.OperationalError: unable to open database file

解决方法：

确保api_gateway.db文件位于正确的位置。
检查文件权限，确保服务有读写权限。

认证失败

Unauthorized Error 401

解决方法：

验证所有环境变量是否正确设置：
- CONNECTWISE_COMPANY_ID、CONNECTWISE_PUBLIC_KEY和CONNECTWISE_PRIVATE_KEY。
确认API密钥具有正确的权限。
检查CONNECTWISE_AUTH_PREFIX是否为有效的前缀。

连接超时

Request timed out

解决方法：

优化网络连接，确保互联网稳定。
减少请求数据量，使用过滤和分页功能。
在非高峰时段进行大量数据操作。

📚 详细文档

系统要求

操作系统

支持的平台：Linux、Windows、macOS。
最低版本：Python 3.6或更高版本。

硬件需求

处理器：1 GHz或更快。
内存：至少2 GB RAM。
存储：至少500 MB的可用空间。

安全注意事项

数据加密：所有API请求和响应均使用SSL/TLS加密。
访问控制：通过IP白名单限制对管理接口的访问。
日志记录：详细记录所有操作，便于审计和故障排除。

文档更新历史

版本 1.0 (2023年1月15日)

初始版本发布。

版本 2.0 (2023年6月10日)

新增功能：智能查询优化和断点续传。
修复问题：解决数据库连接超时和认证失败的问题。

联系支持

如需帮助或报告问题，请联系我们的支持团队：

电子邮件：support@connectwise.com
电话：+1 (800) 123-4567

精选MCP服务推荐

Duckduckgo MCP Server

已认证

DuckDuckGo搜索MCP服务器，为Claude等LLM提供网页搜索和内容抓取服务

Framelink Figma MCP Server是一个为AI编程工具（如Cursor）提供Figma设计数据访问的服务器，通过简化Figma API响应，帮助AI更准确地实现设计到代码的一键转换。

Firecrawl MCP Server是一个集成Firecrawl网页抓取能力的模型上下文协议服务器，提供丰富的网页抓取、搜索和内容提取功能。

百度地图MCP Server是国内首个兼容MCP协议的地图服务，提供地理编码、路线规划等10个标准化API接口，支持Python和Typescript快速接入，赋能智能体实现地图相关功能。

MiniMax Model Context Protocol (MCP) 是一个官方服务器，支持与强大的文本转语音、视频/图像生成API交互，适用于多种客户端工具如Claude Desktop、Cursor等。

Python

1.1K

4.8分

Edgeone Pages MCP Server

EdgeOne Pages MCP是一个通过MCP协议快速部署HTML内容到EdgeOne Pages并获取公开URL的服务

Context7 MCP是一个为AI编程助手提供实时、版本特定文档和代码示例的服务，通过Model Context Protocol直接集成到提示中，解决LLM使用过时信息的问题。

Exa MCP Server是一个为AI助手（如Claude）提供网络搜索功能的服务器，通过Exa AI搜索API实现实时、安全的网络信息获取。

智启未来，您的人工智能解决方案智库