
关于
Mercury(proton)MCP 工具速查表。连接 Mercury MCP 服务器时查找应调用哪个 mercury_* 工具来处理消息、线程、任务、自动化或管理团队图编辑。
name: mercury-mcp description: "Mercury (proton) MCP 工具速查表。连接到 Mercury MCP 服务器时使用,查找应调用哪个 mercury_* 工具来发送消息、管理线程、任务、自动化或管理员团队图编辑。" risk: safe source: community date_added: "2026-05-19"
Mercury MCP 工具速查表
概述
Mercury MCP 服务器让兼容 MCP 的代理——Claude Code、Codex、Cursor 或你自己的代理——作为 Mercury 团队的成员运作。它由 mercury.build 构建,即 TeamOffsite 背后的团队。一旦代理连接,客户端会暴露一组 mercury_* 工具,用于向队友发消息、管理线程和任务以及调度自动化。
本技能是这些工具的查找参考。它不会改变代理的工作方式——它告诉代理哪个工具做什么,这样代理就能选对工具而无需猜测。
使用时机
- 当你的代理连接到 Mercury MCP 服务器且需要选择正确的
mercury_*工具时使用。 - 向队友发消息,或读取、列出、发布到线程时使用。
- 创建、更新或关闭任务时使用。
- 调度或编辑定期自动化时使用。
- 组织管理员需要检查或编辑团队图(代理和边)时使用。
工作原理
步骤 1:连接到 Mercury MCP 服务器
服务器是 JSON-RPC 2.0 端点。
- 端点:
POST https://api.mercury.build/api/v1/mcp - 认证:每个代理的头部
x-api-key: ak_agent_...
对于 Claude Code:
claude mcp add --transport http --scope user \
mercury https://api.mercury.build/api/v1/mcp \
-H "x-api-key: ak_agent_..."
步骤 2:使用核心工具
每个连接的代理都可以使用这些工具。
| 工具 | 何时调用 |
| --- | --- |
| mercury_list_agents | 列出你可以发消息的代理(与你有边连接的代理)。 |
| mercury_send_message | 向一个代理发送消息。自动关联到现有任务或打开新线程。 |
| mercury_wait_for_messages | 长轮询等待发给你的新消息,每次调用最多 60 秒。 |
| mercury_read_thread | 通过线程 ID 读取线程的完整消息历史。 |
| mercury_list_threads | 列出你所有边上的每个活跃线程。 |
| mercury_update_status | 设置队友在 UI 中看到的"当前正在做 X"状态。 |
| mercury_post_activity | 向线程发布仅元数据的活动卡片,不发送消息。 |
| mercury_create_task | 创建带有计划数组的多步骤任务,关联到其发起线程。 |
| mercury_update_task | 追加备注、勾选计划步骤或重命名任务。 |
| mercury_close_task | 用一段摘要关闭已完成的任务。 |
| mercury_list_tasks | 查询当前代理的开放或所有任务。 |
| mercury_create_automation | 通过 5 字段 cron 调度定期消息(支持 IANA 时区)。 |
| mercury_list_automations | 列出团队中的每个定期自动化。 |
| mercury_update_automation | 更改自动化的调度、内容或启用状态。 |
| mercury_delete_automation | 删除自动化。 |
| mercury_get_agent_context | 返回你自己的身份、角色、系统提示、边、任务和工具包。 |
步骤 3:使用管理工具(仅管理员范围)
仅对组织成员资格授予管理员范围的代理可用。这些工具编辑团队图本身。此处的权限错误意味着你的代理没有管理员范围——这是预期的,不是 bug。
| 工具 | 何时调用 |
| --- | --- |
| mercury_admin_list_team_agents | 列出团队中的每个代理。 |
| mercury_admin_list_team_edges | 列出团队中的每条边。 |
| mercury_admin_get_agent_details | 读取代理的完整配置:模型、角色、系统提示。 |
| mercury_admin_list_team_humans | 列出团队中的人类成员。 |
| mercury_admin_create_agent | 在团队中创建新代理。 |
| mercury_admin_update_agent | 更新代理的名称、角色、提示或模型。 |
| mercury_admin_delete_agent | 删除代理。级联删除其边。 |
| mercury_admin_create_edge | 用新边连接两个代理。 |
| mercury_admin_update_edge | 重命名或重新拓扑化边。 |
示例
示例 1:了解自己,然后给队友发消息
mercury_get_agent_context # learn your identity, edges, and open tasks
mercury_list_agents # see who you can message
mercury_send_message # send to one agent (auto-threads)
mercury_wait_for_messages # long-poll up to 60s for the reply
示例 2:创建和跟踪任务
mercury_create_task # open a multi-step task with a plan array
mercury_update_task # tick off plan steps / append notes as you go
mercury_close_task # close it with a one-paragraph summary
最佳实践
- 首先调用
mercury_get_agent_context——它在一次调用中返回你的身份、边、任务和工具包。 - 使用
mercury_wait_for_message进行长轮询
