关于 ServiceBridge MCP by usefulapi
ServiceBridge MCP by usefulapi 将 ServiceBridge 账户连接到 MCP 客户端,用于读取业务记录并创建指定记录。服务托管运行,使用 ServiceBridge API 用户凭据进行验证。
主要功能
- 01读取客户、工单和发票
- 02访问估价单、付款和任务
- 03创建或更新客户
- 04添加潜在客户、任务和活动备注
- 05托管服务与 OAuth 登录
适用场景
- 01查询工单或发票
- 02创建潜在客户或跟进任务
- 03为活动记录添加备注
MCP 相关
向 MCP 客户端提供读取客户、工单、估价单、发票、任务等记录的工具,以及用于客户、潜在客户、任务和备注的写入工具。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://servicebridge.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-servicebridge https://servicebridge.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-servicebridge":{"type":"http","url":"https://servicebridge.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-servicebridge":{"type":"http","url":"https://servicebridge.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-servicebridge":{"type":"http","url":"https://servicebridge.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-servicebridge":{"serverUrl":"https://servicebridge.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
原文在翻译后有更新,译文可能不是最新。
usefulapi 的 ServiceBridge MCP
通过 Claude、Cursor 或任何 MCP 客户端使用你的 ServiceBridge 账户。读取客户、工单、估价单、发票和任务,并添加潜在客户、任务和备注。托管服务,无需本地安装:使用你自己的凭据连接。
在线端点: https://servicebridge.usefulapi.io/mcp · 主页: https://usefulapi.io
连接
- Claude(claude.ai、桌面版):打开 Customize → Connectors,点击 + Add → Add custom connector,然后粘贴
https://servicebridge.usefulapi.io/mcp。 - Claude Code:
claude mcp add --transport http servicebridge https://servicebridge.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code: 添加到 VS Code。
- Cursor 和其他客户端: 将 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"servicebridge": {
"url": "https://servicebridge.usefulapi.io/mcp"
}
}
}
只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 ServiceBridge 凭据。
分步设置说明、凭据查找位置和常见问题解答:https://usefulapi.io/servicebridge/
首次连接时,你需要提供 API User ID 和 API User password(ServiceBridge → Settings → Public API Settings → API Users)。服务会验证凭据,并按用户存储。配置文件中无需放置任何密钥。
工具
| 工具 | 类型 | 功能 |
|---|---|---|
servicebridge_whoami | read | 当前 API 用户 |
servicebridge_list_customers | read | 列出客户 |
servicebridge_get_customer | read | 获取客户 |
servicebridge_list_contacts | read | 列出联系人 |
servicebridge_list_locations | read | 列出地点 |
servicebridge_list_work_orders | read | 列出工单 |
servicebridge_get_work_order | read | 获取工单 |
servicebridge_list_estimates | read | 列出估价单 |
servicebridge_get_estimate | read | 获取估价单 |
servicebridge_list_invoices | read | 列出发票 |
servicebridge_get_invoice | read | 获取发票 |
servicebridge_list_payments | read | 列出付款 |
servicebridge_list_tasks | read | 列出任务 |
servicebridge_get_task | read | 获取任务 |
servicebridge_list_leads | read | 列出潜在客户 |
servicebridge_get_lead | read | 获取潜在客户 |
servicebridge_list_employees | read | 列出员工 |
servicebridge_list_activity_notes | read | 列出活动备注 |
servicebridge_list_teams | read | 列出团队 |
servicebridge_list_payment_methods | read | 列出付款方式 |
servicebridge_get_invoice_statistics | read | 发票统计 |
servicebridge_create_customer | write | 创建客户 |
servicebridge_update_customer | write | 更新客户 |
servicebridge_create_lead | write | 创建潜在客户 |
servicebridge_create_task | write | 创建任务 |
servicebridge_add_activity_note | write | 添加活动备注 |
servicebridge_usage_status | meta | 使用情况(免费层级用量计量) |
servicebridge_request_feature | meta | 申请添加缺失功能 |
servicebridge_upgrade | meta | 升级到 Pro(无限制*) |
servicebridge_cancel_subscription | meta | 取消 Pro 订阅 |
read 工具为只读;write 工具会修改数据(客户端应在执行前确认);meta 工具用于报告用量、管理订阅或提交功能申请。
定价
| 方案 | 价格 | 限额 |
|---|---|---|
| 免费 | $0 | 每月 50 次工具调用 |
| Pro(按用户计费) | $9/mo 或 $90/yr(免费赠送 2 个月) | 不限量* |
*Pro 在此服务上的公平使用限额为每月 10,000 次工具调用。如需更多,请发送邮件至 [email protected]。
Pro 仅适用于此服务。使用 servicebridge_upgrade 订阅(它会返回 Stripe Checkout 链接)。可随时使用 servicebridge_cancel_subscription 取消:Pro 会持续到已付费周期结束,当前周期不予退款;在此之前运行 servicebridge_upgrade 可撤销取消操作。或者发送邮件至 [email protected]。
许可证
MIT——请参阅 LICENSE。仅提供文档;服务由托管方运行。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。