你的智能体，接入任意 MCP 服务器。
Hoody Agent 内置生产就绪的 Model Context Protocol 客户端。连接 GitHub、Slack、Jira、自定义 API 或任意 MCP 兼容服务器——工具在运行时动态发现，并与智能体的内置能力合并。
本地 stdio + 远程 StreamableHTTP / SSE · OAuth 支持已认证服务器 · 破坏性操作需确认
# POST against your agent container
$ curl -X POST https://PROJECT-CONTAINER-agent-1.SERVER.containers.hoody.com/api/v1/agent/mcp/servers \
-H "Content-Type: application/json" \
-d '{ "name": "linear", "enabled": true }'
<< 201 Created
{ "id": "srv_...", "name": "linear", "status": "connecting" }——智能体在启动时对每个已连接服务器调用 listTools()。新工具在下一个推理轮次中出现。
一次 POST，工具即现。
智能体对每个已连接 MCP 服务器调用 listTools()。服务器返回的一切——文件系统、Slack 消息、Jira 工单、自定义 API——与智能体原生 HTTP 能力合并，用于下一个推理步骤。
1. 注册服务器
向 /api/v1/agent/mcp/servers POST，提供名称和 enabled 标志，Hoody 解析并建立连接。
2. 发现工具
MCP 客户端对服务器调用 listTools()，Schema 是动态的——无需预声明清单。
3. 与原生工具合并
发现的工具加入智能体的内置工具集。同一条提示词可同时调用 GitHub 工具、文件系统工具和智能体自己的容器控制工具。
4. 带安全保障地调用
破坏性操作——文件写入、外部 API 变更——需要明确确认。智能体不会悄无声息地破坏状态。
POST/api/v1/agent/mcp/servers
四项关键能力。
MCP 客户端小而有主见。每项功能的存在，是因为智能体在工具集不断扩展的同时必须保持可靠。
动态工具发现
没有固定列表。智能体向每个已连接服务器询问其提供的工具，工具目录无需重新部署即可演进。
本地 + 远程协议
本地服务器使用 stdio，跨网络远程服务器使用 StreamableHTTP + SSE。一个客户端，两种场景兼顾。
OAuth 认证
完整 OAuth 流程支持已认证远程服务器——连接 GitHub MCP 服务器、Google Drive MCP 服务器，或任何以用户身份为门槛的工具。
安全优先的调用
破坏性工具调用在执行前需要确认。智能体暂停，呈现操作详情，等待信号后再触碰状态。
任意 MCP 客户端均可接入。
Hoody Agent 与外部服务器通过 MCP 通信——将服务器 URL 或 stdio 命令嵌入智能体，其工具在下一轮对话中即可使用。通过官方 MCP 注册表、社区目录或你自己的内部工具库连接。
Claude Desktop
Anthropic 的参考 MCP 客户端——粘贴服务器配置，Hoody 工具即出现在 Claude 的工具选择器中。
Cursor
AI 原生 IDE，完整支持 MCP——通过一个配置即可访问文件、终端、exec 等所有功能。
Cline
VS Code 中的自主编码智能体——通过 MCP 跨 Hoody 容器读写文件。
Windsurf
Codeium 的智能体 IDE——MCP 工具直接加入其 Cascade 流程。
Continue.dev
开源 AI 编码助手——MCP 优先集成，自带模型。
Hoody Agent + 自定义
针对同一协议编写自定义 MCP 客户端，或使用 hoody-agent 的内置客户端。
{
"mcpServers": {
"hoody": {
"url": "https://CONTAINER.SERVER.containers.hoody.com/mcp",
"auth": { "type": "oauth" }
}
}
}协议是开放的——以上每个客户端访问同一工具界面，无需供应商适配器。
一次工具调用，全程追踪。
智能体请求工具、选择工具、调用工具、读取结果。这四步就是 MCP 协议，仅此而已。
发现
智能体对每个已连接 MCP 服务器调用 listTools()，每个服务器返回其工具 Schema——客户端无需维护目录。
选择
模型基于工具描述进行推理，选择符合当前步骤的工具。无需手动路由逻辑。
调用
调用以 MCP 消息形式发出，Hoody 客户端透明处理传输（stdio / HTTP / SSE）和认证。
反馈
类型化 JSON 响应返回，智能体读取并继续——成功的工具调用成为又一个推理输入。
→ listTools()
← [ { name: "read_file", schema: {...} },
{ name: "write_file", schema: {...} },
{ name: "run_shell", schema: {...} }, ... ]
→ callTool("read_file", { path: "/hoody/storage/readme.md" })
← { content: "# Project readme\n\nSee ..." }
→ callTool("run_shell", { cmd: "pytest tests/" })
⟳ requires confirmation — destructive-op gate
← { exitCode: 0, stdout: "... 42 passed ..." }智能体不会悄然执行破坏性操作。
MCP 暴露的是利刃——文件写入、Shell 执行、API 变更。Hoody 客户端强制执行三道关卡，使智能体拥有能力而不失控。
破坏性操作确认
任何涉及写入、删除或外部副作用的工具调用都会暂停等待明确审批。智能体显示清晰提示；用户先确认或查看 diff，再签字放行。
远程服务器 OAuth
远程 MCP 服务器通过完整 OAuth 流程认证——GitHub、Slack、Jira，任何以身份为门槛的工具。Token 保留在你的服务器上，智能体永远看不到原始凭据。
按服务器白名单
每个 MCP 服务器必须通过 POST /agent/mcp/servers 显式注册。未审批的服务器无法连接。通过 DELETE 撤销，下一轮智能体执行时其工具即消失。
完整审计轨迹
每次工具调用（发现、调用、结果）均通过 Hoody 代理记录。可查阅、可导出、防篡改。
接入 MCP 世界。
任意 MCP 兼容服务器——来自官方注册表、社区或内部工具——接入方式相同。将服务器 URL 或 stdio 命令添加到智能体，下一轮次即可使用其工具。
消息、频道、私信团队成员
工单、Sprint、状态更新
官方参考服务器（本地文件）
对真实数据库的只读查询
无需抓取的网络搜索
无头浏览器自动化
为任意已有 REST / gRPC 界面编写 MCP 服务器
以下是今日可接入的示例。每周都有新的 MCP 服务器出现，此列表在 Hoody 侧没有硬编码。
一次 POST，更多工具唾手可得。
启动一个 Hoody Agent 容器，POST 你需要的 MCP 服务器，下一个推理轮次即可使用。无需安装 SDK，无需重启智能体，无需额外基础设施。
另见——/platform/ai-gateway（模型层）、/platform/control-plane（治理 API）、/kit/agent（智能体运行时）。