SyncroMSP MCP服务器
A. FastMCP 服务器将Claude连接到您的SyncroMSP帐户，让您通过自然对话管理门票、客户、发票、付款、RMM警报等。
______________________________________________________________________
可用工具
| 类别 | 工具 |
|---|---|
| 门票 | list_tickets、get_ticket、create_ticket、update_ticket和add_ticket_comment |
| 客户 | list_customers、get_customer、create_customer、update_customer |
| 联系人 | list_contacts、get_contact、create_contact |
| 发票 | list_invoices、get_invoice、create_invoice、update_invoice和add_invoice_line_item |
| 支付 | 申请_付款 |
| RMM警报 | list_rmm_alert、get_rmm_aalert、mute_rm_alert和resolve_rmm_allert |
| 估计 | list_estimates、get_estimate、create_estimate |
| 产品 | 产品列表 |
| 资产 | list_asset，获取资产 |
______________________________________________________________________
设置
1.安装Python依赖项
pip install -r requirements.txt2.配置您的凭据
cp .env.example .env编辑 .env 并填写：
SYNCRO_API_KEY--生成at 管理>API>API代币 在SyncroSYNCRO_SUBDOMAIN--之前的部分.syncromsp.com在您的URL中
3.测试其工作情况
python server.py您应该看到FastMCP服务器启动。按Ctrl+C停止。
______________________________________________________________________
连接到克劳德桌面
- 打开您的Claude Desktop配置文件：
- 窗户： %APPDATA%\Claude\claude_desktop_config.json - macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
- 添加以下内容（更新保存server.py的路径）：
{
"mcpServers": {
"syncromsp": {
"command": "python",
"args": ["C:/path/to/syncromsp-mcp/server.py"],
"env": {
"SYNCRO_API_KEY": "your_api_key_here",
"SYNCRO_SUBDOMAIN": "your_subdomain_here"
}
}
}
}提示： 您可以使用.env文件，而不是将凭据放入配置中——只需确保.env文件与位于同一文件夹中server.py.
- 重新启动克劳德桌面。
- 寻找🔌 Claude界面中的（插入）图标，以确认服务器已连接。
______________________________________________________________________
示例提示
一旦连接，试着问克劳德这样的问题：
- *“给我看所有未结的票”*
- *“为Acme Corp创建工单——他们的电子邮件服务器已关闭，请将其标记为高优先级”*
- *“获取客户12345的所有未付发票”*
- *“为Acme Corp创建发票，并添加一个2小时工时的行项目，价格为150美元/小时”*
- *“向发票67890申请300美元的支票付款”*
- *“列出所有活动的RMM警报”*
- *“解决RMM警报111”*
- *“查找客户Acme Corp的所有资产”*
______________________________________________________________________
API费率限制
SyncroMSP允许 每个IP地址每分钟180个API请求对于正常的会话使用，这已经足够了。
______________________________________________________________________
故障排除
“缺少必需的环境变量”错误 → 确保 SYNCRO_API_KEY 和 SYNCRO_SUBDOMAIN 已设置，无论是在 .env 或在Claude Desktop配置中 env 块。
401未经授权的错误 → 您的API密钥可能已过期或权限不足。检查 管理>API>API代币 在Syncro。
Claude Desktop未显示服务器 → 确保路径 server.py 您的配置是正确的，并且使用了正确的Python可执行文件。试着跑步 python server.py 手动确认它启动时没有错误。