关于 Shopmonkey MCP by usefulapi
连接 Shopmonkey 与 MCP 客户端的托管式服务,涵盖客户、车辆、工单、零件查询,以及订单和预约管理。
主要功能
- 01按信息搜索客户
- 02查询客户车辆和订单
- 03查询预约、零件及服务项目
- 04创建和更新客户、订单及预约
适用场景
- 01查找客户车辆及订单历史
- 02查看零件库存或预约详情
- 03创建工单并预约服务
MCP 相关
向 MCP 客户端提供 Shopmonkey 查询及记录管理工具。服务托管于远程端点,并通过 OAuth 使用用户的 Shopmonkey 凭据进行身份验证。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://shopmonkey.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-shopmonkey https://shopmonkey.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-shopmonkey":{"type":"http","url":"https://shopmonkey.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-shopmonkey":{"type":"http","url":"https://shopmonkey.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-shopmonkey":{"type":"http","url":"https://shopmonkey.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-shopmonkey":{"serverUrl":"https://shopmonkey.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
23此工具无需参数。
详细介绍
usefulapi 提供的 Shopmonkey MCP
通过 Claude、Cursor 或任何 MCP 客户端使用 Shopmonkey——查找客户、车辆、工单、预约和零件库存,并创建客户、订单和预约。 托管服务,无需本地安装:使用你自己的 Shopmonkey 凭据连接。
实时端点: https://shopmonkey.usefulapi.io/mcp · 主页: https://usefulapi.io/shopmonkey
连接
- Claude(claude.ai、Desktop):打开 Customize → Connectors,点击 + Add → Add custom connector,然后粘贴
https://shopmonkey.usefulapi.io/mcp。 - Claude Code:
claude mcp add --transport http shopmonkey https://shopmonkey.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code: 添加到 VS Code。
- Cursor 和其他客户端: 将该 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"shopmonkey": {
"url": "https://shopmonkey.usefulapi.io/mcp"
}
}
}
只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 Shopmonkey 凭据。
分步设置说明、凭据查找位置和常见问题解答:https://usefulapi.io/shopmonkey/
首次连接时,你需要提供 Shopmonkey API 密钥(Settings → Integration → API Keys;由店铺管理员创建)。 系统会验证密钥、按用户存储并限定为你本人使用——配置文件中不会包含密钥。
工具
| 工具 | 类型 | 功能 |
|---|---|---|
shopmonkey_get_current_user | read | 获取当前用户 |
shopmonkey_search_customers | read | 搜索客户 |
shopmonkey_find_customers_by_phone | read | 按电话号码查找客户 |
shopmonkey_find_customers_by_email | read | 按电子邮件查找客户 |
shopmonkey_get_customer | read | 获取单个客户 |
shopmonkey_list_customer_vehicles | read | 列出客户的车辆 |
shopmonkey_list_customer_orders | read | 列出客户的订单 |
shopmonkey_get_vehicle | read | 获取单辆车辆 |
shopmonkey_list_orders | read | 列出订单 |
shopmonkey_get_order | read | 获取单个订单 |
shopmonkey_find_order_by_number | read | 按订单编号查找订单 |
shopmonkey_list_order_services | read | 列出订单的服务项目 |
shopmonkey_search_appointments | read | 搜索预约 |
shopmonkey_search_inventory_parts | read | 搜索库存零件 |
shopmonkey_list_canned_services | read | 列出预设服务 |
shopmonkey_list_workflow_statuses | read | 列出工作流状态 |
shopmonkey_list_users | read | 列出用户 |
shopmonkey_create_customer | write | 创建客户 |
shopmonkey_update_customer | write | 更新客户 |
shopmonkey_add_customer_email | write | 为客户添加电子邮件 |
shopmonkey_create_vehicle | write | 创建车辆 |
shopmonkey_create_order | write | 创建订单 |
shopmonkey_update_order | write | 更新订单 |
shopmonkey_create_appointment | write | 预约 |
shopmonkey_update_appointment | write | 更新或重新安排预约 |
shopmonkey_delete_appointment | write | 删除(取消)预约 |
shopmonkey_add_service | write | 为订单添加服务项目(作业) |
shopmonkey_add_labor | write | 为服务项目添加工时明细 |
shopmonkey_usage_status | meta | 使用情况状态(免费套餐用量计量) |
shopmonkey_request_feature | meta | 请求添加缺失功能 |
shopmonkey_upgrade | meta | 升级到 Pro(无限使用*) |
shopmonkey_cancel_subscription | meta | 取消 Pro 订阅 |
read 工具为只读;write 工具会修改数据(客户端应在执行前确认);meta 工具用于报告使用情况、管理订阅或提交功能请求。
定价
| 方案 | 价格 | 限额 |
|---|---|---|
| 免费版 | $0 | 每月 50 次工具调用 |
| 专业版(每位用户) | $9/mo 或 $90/yr(免费 2 个月) | 不限量* |
*专业版在此服务上的公平使用限额为每月 10,000 次工具调用。如需更多,请联系 [email protected]。
专业版仅适用于此服务。使用 shopmonkey_upgrade 订阅(它会返回 Stripe Checkout 链接)。随时可使用 shopmonkey_cancel_subscription 取消。专业版会持续到已付费周期结束,当前周期不予退款;在此之前运行 shopmonkey_upgrade 可撤销取消操作。或者联系 [email protected]。
许可证
MIT © usefulapi。与 Shopmonkey 无关联,也未获其认可。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。