关于 Synchroteam MCP by usefulapi
Synchroteam MCP by usefulapi 是面向 Synchroteam 外勤服务团队的托管 MCP 服务,涵盖工单、客户、站点、设备和零件等记录,并支持创建、排程、开始和完成工单。
主要功能
- 01浏览工单、客户和站点
- 02查看设备、零件和仓库
- 03查看发票、报价和合同
- 04创建客户、站点和设备
- 05创建、排程、开始并完成工单
适用场景
- 01查看工单和技术人员活动
- 02为新建服务工单排程
- 03完成工单并检查相关记录
MCP 相关
它向 MCP 客户端提供 Synchroteam 记录查询和工单管理操作。托管服务使用用户的 Synchroteam 凭据连接。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://synchroteam.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-synchroteam https://synchroteam.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-synchroteam":{"type":"http","url":"https://synchroteam.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-synchroteam":{"type":"http","url":"https://synchroteam.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-synchroteam":{"type":"http","url":"https://synchroteam.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-synchroteam":{"serverUrl":"https://synchroteam.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
33| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name | string | 否 | 按通配符搜索名称。 |
| page | integer | 否 | 页码,从 1 开始(默认值为 1)。传入上一条回复中的 next_page。 |
| sort | enum | 否 | name | dateModified | dateCreated | myId |
| string | 否 | 精确的联系邮箱。 | |
| active | boolean | 否 | 启用的客户(默认 true);false 表示列出已停用的客户。 |
| page_size | integer | 否 | 每页结果数,范围为 1-100(默认值为 25)。 |
| sort_order | enum | 否 | 排序顺序(默认升序;发票和报价单默认降序)。ascending | descending |
| changed_since | string | 否 | 仅返回在此 UTC 日期时间之后修改的客户。 |
详细介绍
usefulapi 提供的 Synchroteam MCP
通过 Claude、Cursor 或任何 MCP 客户端使用 Synchroteam——管理工单、客户、站点、设备、技术人员、零件、发票和报价,还可创建和安排工单。 托管服务,无需本地安装:使用你自己的 Synchroteam 凭据连接。
实时端点: https://synchroteam.usefulapi.io/mcp · 主页: https://usefulapi.io/synchroteam
连接
- Claude(claude.ai、桌面版):打开 自定义 → 连接器,点击 + 添加 → 添加自定义连接器,然后粘贴
https://synchroteam.usefulapi.io/mcp。 - Claude Code:
claude mcp add --transport http synchroteam https://synchroteam.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code: 添加到 VS Code。
- Cursor 和其他客户端: 将该 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"synchroteam": {
"url": "https://synchroteam.usefulapi.io/mcp"
}
}
}
只添加 URL。请勿在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 Synchroteam 凭据。
分步设置说明、凭据查找位置和常见问题解答:https://usefulapi.io/synchroteam/
工具
| 工具 | 类型 | 功能 |
|---|---|---|
synchroteam_list_customers | 读取 | 列出客户 |
synchroteam_get_customer | 读取 | 获取客户 |
synchroteam_list_sites | 读取 | 列出站点 |
synchroteam_get_site | 读取 | 获取站点 |
synchroteam_list_equipment | 读取 | 列出设备 |
synchroteam_get_equipment | 读取 | 获取设备 |
synchroteam_list_jobs | 读取 | 列出工单 |
synchroteam_get_job | 读取 | 获取工单 |
synchroteam_get_job_photos | 读取 | 获取工单照片 |
synchroteam_list_job_types | 读取 | 列出工单类型 |
synchroteam_list_users | 读取 | 列出用户(技术人员和员工) |
synchroteam_get_user | 读取 | 获取用户 |
synchroteam_list_teams | 读取 | 列出团队 |
synchroteam_list_parts | 读取 | 列出零件和服务 |
synchroteam_get_part | 读取 | 获取零件 |
synchroteam_list_depots | 读取 | 列出库存仓库 |
synchroteam_get_depot | 读取 | 获取仓库库存 |
synchroteam_list_part_requests | 读取 | 列出零件请求 |
synchroteam_list_invoices | 读取 | 列出发票 |
synchroteam_get_invoice | 读取 | 获取发票 |
synchroteam_list_quotations | 读取 | 列出报价 |
synchroteam_get_quotation | 读取 | 获取报价 |
synchroteam_list_contracts | 读取 | 列出合同 |
synchroteam_list_projects | 读取 | 列出项目 |
synchroteam_list_activities | 读取 | 列出技术人员活动 |
synchroteam_create_customer | 写入 | 创建客户 |
synchroteam_update_customer | 写入 | 更新客户 |
synchroteam_create_site | 写入 | 创建站点 |
synchroteam_create_equipment | 写入 | 创建设备 |
synchroteam_create_job | 写入 | 创建工单 |
synchroteam_schedule_job | 写入 | 安排工单 |
synchroteam_start_job | 写入 | 开始工单 |
synchroteam_complete_job | 写入 | 完成工单 |
synchroteam_usage_status | 元数据 | 使用情况状态(免费套餐用量计量) |
synchroteam_request_feature | 元数据 | 请求添加缺失功能 |
synchroteam_upgrade | 元数据 | 升级到 Pro(无限制*) |
synchroteam_cancel_subscription | 元数据 | 取消 Pro 订阅 |
read 工具为只读;write 工具会更改数据(客户端应在执行前确认);meta 工具用于报告使用情况、管理订阅或提交功能请求。
定价
| 方案 | 价格 | 限额 |
|---|---|---|
| 免费版 | $0 | 每月 50 次工具调用 |
| Pro(每个账户) | $9/mo 或 $90/yr(免费使用 2 个月) | 无限制* |
*Pro 在此服务上的公平使用限额为每月 10,000 次工具调用。如需更多,请发送邮件至 [email protected]。
Pro 仅适用于此服务。使用 synchroteam_upgrade 订阅(该命令会返回 Stripe Checkout 链接)。可随时使用 synchroteam_cancel_subscription 取消:Pro 权益会持续到付费周期结束,当前周期不予退款;在此之前运行 synchroteam_upgrade 可撤销取消。也可发送邮件至 [email protected]。
许可证
MIT © usefulapi。与 Synchroteam 无关联,也未获其认可。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。