5dive-mcp 是 5dive 的 MCP（Model Context Protocol）服务器，用于把 5dive 的 agent-fleet CLI 暴露为 MCP 工具。5dive 本身是运行自主编码代理舰队的 CLI 与控制平面，目标是让代理像自治公司一样运作。这个服务器是一个轻量、诚实的适配器：每个工具都会调用本地 5dive 二进制的机器可读 --json 接口并返回结果，因此自动继承 CLI 的认证、权限和审计日志，自身从不处理密钥。
用途与主要能力 它把 5dive CLI 中与任务、代理、摘要相关的功能以 stdio MCP 工具的形式提供。任何 MCP 客户端（Claude Desktop、Cursor、Cline 或自研客户端）都可以指向这个 stdio 服务器，从而在模型上下文中直接提交任务、查看和向代理发消息，以及读取舰队摘要。它只镜像 CLI 的一个精选切片（tasks、agents、digest），并非完整接口，也不是新 API，而是一个分发与便利层。其他功能需直接使用 5dive CLI（5dive --help）。
使用方式 前提是已安装 5dive CLI 并加入 PATH，安装命令为：curl https://install.5dive.ai | sudo bash。 客户端配置（Claude Desktop / Cursor / Cline）：将 MCP 客户端指向该 stdio 服务器即可。 远程模式：5dive-mcp serve。运行在他人云端的客户端无法在你的机器上启动 stdio 进程，serve 会把同样的六个工具放在 MCP 的 Streamable HTTP 传输上，绑定回环地址，供你的反向代理以 HTTPS 发布。 如果使用托管版 5dive，则不需要这个服务器：直接连接 https://api.5dive.com/mcp 并登录即可。 客户端接入方式：能发送请求头的客户端（Claude Code、MCP inspector、多数 SDK）使用 https://agents.example.com/mcp 并携带 Authorization: Bearer <token>。ChatGPT 开发者模式只提供 OAuth 或“无认证”，因此需把 token 放进 URL 并选择“无认证”：https://agents.example.com/mcp/<token>。可用 5dive-mcp token list 查看 token，用 5dive-mcp token revoke --name=chatgpt 撤销，运行中的服务器会从下一个请求起拒绝该 token。
安全与限制 权限方面：只读 token 可以列出代理和任务、读取任务、读取摘要；带 --write 的 token 还可以提交任务（task_create）和向代理发消息（agent_send）。任何 token 都不能回答 gate、更改设置、花钱，或运行这六个 CLI 调用之外的任何东西，每个调用都以固定 argv 构建且不经过 shell。远程客户端声称的发送者会被丢弃：其消息会标记为 mcp-<token name>，其任务会在正文中说明由哪个连接提交。 运行身份：工具以运行 serve 的用户权限执行，当 FIVEDIVE_SUDO=1 时还拥有 sudo 的 root 权限。服务器只会运行那六个子命令，但被攻破的服务器进程会持有该用户的权限，因此应以专用用户运行，且其 sudo 授权仅覆盖 5dive 二进制。 速率限制：默认每个 token 每分钟 60 次调用（--rate），按 JSON-RPC 消息计数；批量请求会在执行前被拒绝。超过 1 MiB 的正文会被拒绝。 审计：每次工具调用，无论允许还是拒绝，都会向 audit.jsonl 追加一行：时间、token 名称、工具、结果、客户端 IP（当代理在回环时取自 X-Forwarded-For），以及涉及的 id 和名称。消息文本和任务正文从不写入。 静态存储：tokens.json（权限 0600）保存每个 token 的 SHA-256，而非 token 本身。两个文件都位于 $FIVEDIVE_MCP_HOME，默认 ~/.config/5dive-mcp。 URL 中的 token 等于 URL 中的密码。反向代理的访问日志会记录请求路径，因此应为 /mcp/* 关闭路径日志，或在客户端支持时使用请求头认证。持有 URL 的人就持有 token。 明文 HTTP 仅限回环：serve 默认拒绝公网绑定，因为 token 会以未加密方式穿越网络。 如果不想开放任何入站端口，OpenAI 的 Secure MCP Tunnel 会在服务器旁运行一个小客户端并向外连接 OpenAI。其 tunnel-client 可以直接启动 stdio 服务器（--mcp-command "npx -y @5dive/mcp"），但需要一个拥有 tunnel 权限的 OpenAI Platform 组织。
配置 参数以 argv 数组形式传给 CLI，不经过 shell，因此工具输入永远不会被解释为 shell 语法。服务器从不接触密钥：CLI 从本机读取自己的凭据。
适用场景 适合已经在使用 5dive 管理自主编码代理舰队、并希望通过 MCP 客户端在模型上下文中直接操作任务、代理和摘要的用户。也适合需要把这类能力通过反向代理安全地暴露给远程 MCP 客户端的场景。
限制 仅覆盖 tasks、agents、digest 的精选切片，不是完整 CLI 接口；需要预先安装 5dive CLI；远程模式需要自行配置反向代理与 token 管理；默认速率限制为每 token 每分钟 60 次调用；正文上限 1 MiB；明文 HTTP 仅限回环。
许可证：MIT。
