BerthTime

BerthTime MCP 服务

询问 AI 助手您的海运集装箱在哪里。

BerthTime 跟踪各大承运商的海运集装箱。其远程 MCP 服务让 ChatGPT、Claude、Cursor、VS Code 及任何其他 MCP 客户端都能用日常语言查询您的货运信息：集装箱在哪里、本周有哪些货物到港、哪些货物延误，以及完整的承运商事件历史。您还可以开始跟踪新的集装箱。

本仓库包含公开的连接信息、注册表元数据和客户端配置示例。该服务由 BerthTime 托管；您无需自行安装或运行任何内容。

端点	https://berthtime.com/api/v1/mcp
传输方式	Streamable HTTP
身份验证	OAuth 2.1（使用 BerthTime 账户登录），或 BerthTime API 密钥
MCP 注册表	com.berthtime/berthtime
配置指南	https://berthtime.com/ai-assistant
要求	BerthTime 账户（注册）

您可以询问什么

• “集装箱 MSCU1234566 现在在哪里？”
• “我的哪些集装箱本周到港？”
• “有延误超过两天的货物吗？”
• “向我展示 Felixstowe 货物的全部动态。”
• “开始跟踪订舱号 123456789。”

工具

读取： list_companies、list_shipments、list_shared_shipments、get_shipment、get_shipment_events、list_arriving_shipments、list_delayed_shipments、detect_reference、list_carriers、get_usage、list_alert_rules、list_support_requests。

写入（需要在登录时选择读写权限，并且在公司中拥有所有者或管理员角色；或者使用读权限 + 写权限的 API 密钥）：track_shipment、update_shipment_identifiers（为货运设置订舱号、提单号或集装箱号）、get_share_link（如果不存在则创建链接；付费套餐）、create_share_link（付费套餐）、create_support_request、archive_shipment。

BerthTime 会在后台自动更新货运信息；无需手动刷新。

2026 年 11 月 6 日，多个工具进行了重命名；旧名称（arriving_soon、delayed_shipments、list_notification_rules、list_tickets、create_ticket）仍然有效。

每个工具都会声明 MCP 注解（readOnlyHint、destructiveHint、idempotentHint、openWorldHint）。如果您属于多家公司，可以传入可选的 company 参数（ID、@handle 或准确名称）。

连接

ChatGPT 和 Claude

使用 URL https://berthtime.com/api/v1/mcp 添加自定义连接器，并选择 OAuth。分步说明及屏幕截图：https://berthtime.com/ai-assistant

Claude Code

claude mcp add --transport http berthtime https://berthtime.com/api/v1/mcp

Cursor

~/.cursor/mcp.json：参见 examples/cursor-mcp.json。

VS Code

.vscode/mcp.json：参见 examples/vscode-mcp.json。

使用 API 密钥而非 OAuth

在 BerthTime 中创建 API 密钥（Settings → API keys），并将其作为 bearer token 发送：参见 examples/api-key-header.json。一个 API 密钥仅代表一家公司的身份。

安全与隐私

• 登录时，您可以选择一家公司或您所属的所有公司，并设置助手是否只能读取数据，还是也可以进行更改。令牌仅在 MCP 端点上有效；访问令牌有效期为一小时，刷新令牌会轮换。
• 在 Settings → AI assistants 中断开已登录的应用，或在 Settings → API keys 中撤销 API 密钥。两种操作都会立即生效。
• 该服务只会读取和更改您在 BerthTime 中的数据。它不会存储您的对话；每次工具调用（工具名称和参数）都会记录在您公司的审计日志中。
• 速率限制：每个 API 密钥或令牌每分钟 120 次请求、每小时 600 次请求，并与 REST API 共用限额。
• 隐私政策 · 服务条款

支持

[email protected]，或 BerthTime 应用内的支持页面。

---

BerthTime 由 Majorbird Vietnam Company Limited 运营。本仓库中的示例采用 MIT 许可证；BerthTime 服务本身为专有服务。