使用说明
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.txt
2.配置您的凭据
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 手动确认它启动时没有错误。