SyncroMSP连接服务

一个连接Claude到SyncroMSP账户的服务,通过自然对话管理票据、客户、发票、付款等。

  • by bizz3n
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 bizz3n/SyncroMSP_MCP

使用说明

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代币 在Syncro
  • SYNCRO_SUBDOMAIN --之前的部分 .syncromsp.com 在您的URL中

3.测试其工作情况

python server.py

您应该看到FastMCP服务器启动。按Ctrl+C停止。


连接到克劳德桌面

  1. 打开您的Claude Desktop配置文件:

    • 窗户: %APPDATA%\Claude\claude_desktop_config.json
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  2. 添加以下内容(更新保存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.

  1. 重新启动克劳德桌面。

  2. 寻找🔌 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 手动确认它启动时没有错误。