Shipcloud MCP by usefulapi

usefulapi 提供的 Shipcloud MCP

连接

• Claude（claude.ai、Desktop）：打开 Customize → Connectors，点击 + Add → Add custom connector，然后粘贴 https://shipcloud.usefulapi.io/mcp。
• **Claude Code：**运行 claude mcp add --transport http shipcloud https://shipcloud.usefulapi.io/mcp，然后运行 /mcp 登录。
• VS Code：添加到 VS Code。
• **Cursor 和其他客户端：**将该 URL 添加为远程 MCP 服务：

{
  "mcpServers": {
    "shipcloud": {
      "url": "https://shipcloud.usefulapi.io/mcp"
    }
  }
}

只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥：服务会通过 OAuth 为你登录，登录页面会要求你输入 Shipcloud 凭据。

分步设置说明、凭据查找位置和常见问题解答：https://usefulapi.io/shipcloud/

工具

工具	类型	功能
shipcloud_get_account	read	获取账户信息
shipcloud_list_carriers	read	列出承运商
shipcloud_get_default_address	read	获取默认地址
shipcloud_list_shipments	read	列出货件
shipcloud_get_shipment	read	获取货件
shipcloud_get_shipment_quote	read	获取货件报价
shipcloud_create_prepared_shipment	write	创建待处理货件（不含运单标签）
shipcloud_create_shipment_with_label	write	购买运单标签（需要付费）
shipcloud_delete_shipment	write	删除货件／取消其运单标签
shipcloud_list_trackers	read	列出追踪器
shipcloud_get_tracker	read	获取追踪器
shipcloud_create_tracker	write	根据追踪号码追踪货件
shipcloud_list_pickup_requests	read	列出取件请求
shipcloud_get_pickup_request	read	获取取件请求
shipcloud_create_pickup_request	write	请求承运商取件
shipcloud_find_dropoff_locations	read	查找取件点和投递点
shipcloud_list_addresses	read	列出已保存的地址
shipcloud_get_address	read	获取已保存的地址
shipcloud_create_address	write	保存地址
shipcloud_list_orders	read	列出订单
shipcloud_get_order	read	获取订单
shipcloud_list_webhooks	read	列出 Webhook
shipcloud_usage_status	meta	使用情况（免费额度计数器）
shipcloud_request_feature	meta	申请添加缺失功能
shipcloud_upgrade	meta	升级到 Pro 或 Pro+
shipcloud_cancel_subscription	meta	取消 Pro 订阅

read 工具为只读；write 工具会修改数据（客户端应要求确认）；meta 工具用于报告使用情况、管理订阅或提交功能申请。

定价

套餐	价格	限额
Free（每位 Shipcloud 客户）	$0	每月 50 次工具调用
Pro（每位 Shipcloud 客户）	$9/mo 或 $90/yr（免费 2 个月）	无限制*

*Pro 在此服务上的公平使用限额为每月 10,000 次工具调用。如需更多，请发送邮件至 [email protected]。

Pro 仅适用于此服务。使用 shipcloud_upgrade 订阅（它会返回 Stripe Checkout 链接）。可随时使用 shipcloud_cancel_subscription 取消：Pro 将持续到已付费周期结束，当前周期不予退款；在此之前运行 shipcloud_upgrade 可撤销取消操作。也可发送邮件至 [email protected]。

许可证

MIT

账户访问和数据

仅在获得授权并遵循处理指示的情况下，连接您自己的客户控制密钥。在您的账户邮箱下查找密钥 → API Key。沙盒密钥会生成测试标签；正式密钥可能产生实际承运商费用。供应商套餐、承运商资格和费用彼此独立。这是由客户授权的独立连接，不代表已获得合作伙伴批准。

密钥经过加密。请求中的寄件人／收件人地址、订单和跟踪信息会发送到您连接的 AI 客户端和大模型提供商。仅连接您有权在这些服务中处理的数据。在 Shipcloud 中撤销密钥即可停止访问；断开 UsefulAPI 即可停止此连接。计费依据客户编号，通常适用于沙盒／正式密钥和密钥轮换。

购买标签、删除货件／取消标签以及请求承运商上门取件，都需要明确确认。取件可能收费，且无法通过这些工具取消。已准备的货件不会生成标签或产生标签费用。可选的通知邮件会使 Shipcloud 向该地址发送跟踪邮件。说明和结果会解释不确定的情况；不会自动重放任何操作。

参考信息查询和同一实例保护机制可以减少重复购买标签的情况，但无法在多个 Worker 实例之间保证原子性。请按每个参考编号串行处理购买操作。承运商处理缓慢时，可能会在操作完成前发生超时；重复购买前请先检查 Shipcloud。只有在获得有效的创建 ID 和 HTTPS 标签 URL 后，才会报告已购买标签；删除操作则需要收到文档规定的 204 确认。

所有 22 个工具均已根据当前供应商文档和本地模拟环境进行检查。未使用真实客户的运输数据、标签、取件或费用进行测试。