Kody MCP Server

什么是 Kody MCP Server？

Kody MCP 服务器将你的 AI 代理连接到 Kody。Kody 是一个共享云，可在多次对话之间保存代理的记忆、凭据、代码包和定时任务。推理由你的代理完成；Kody 存储代理所需的内容，并让一个代理完成的工作可以被其他代理复用。

Kody 对自身定位很明确：它“does not reason, chat, or decide”。任何支持 MCP 的代理，无论是编程代理还是聊天助手，都可以连接 https://kody.codes/mcp，获得已保存的上下文、无需读取即可使用的密钥、运行 TypeScript 的环境，以及发布和调度代码的方式。

如何使用 Kody MCP Server？

你需要一个邮箱已验证的 Kody 账户；邮箱验证前，授权和 MCP 都无法使用。Kody 只支持 OAuth：当客户端打开 OAuth 流程时，你登录 Kody 并批准访问。Kody 提醒，批准操作“gives that agent full access to this Kody account”，而不是有限的权限集合。

最简单的方式是在 kody.codes 上打开 /onboarding 并选择你的代理；Kody 会显示该宿主的具体步骤（插件、厂商 CLI 命令或原始 MCP URL）。下面是标准的远程配置。

服务器 URL：

https://kody.codes/mcp

Claude Code

claude mcp add --transport http kody https://kody.codes/mcp

运行 /mcp，选择 kody 并在浏览器中批准访问。

Claude Desktop

打开 Settings，进入 Connectors，选择 Add custom connector 并粘贴 https://kody.codes/mcp，然后连接并登录。Claude Desktop 在对话开始时绑定工具，因此如果看不到 Kody 的工具，请新建一个对话。

Cursor

{
  "mcpServers": {
    "kody": {
      "url": "https://kody.codes/mcp"
    }
  }
}

将其添加到 ~/.cursor/mcp.json；Cursor 会在浏览器中打开 Kody 登录页面。

VS Code

{
  "servers": {
    "kody": {
      "type": "http",
      "url": "https://kody.codes/mcp"
    }
  }
}

将其添加到 .vscode/mcp.json，启动服务器即可开始 OAuth 流程。

Kody MCP Server 的主要功能

• 共享记忆： 关于你的已保存上下文，可通过 search 和 execute 调用返回给任何已连接的代理。
• 代理永远读不到的凭据： 搜索密钥只返回元数据；代码通过 {{secret:githubAccessToken}} 这类占位符引用密钥，只有在已批准的宿主上才会填入真实值。
• 代码执行： execute 工具在 Kody 内运行 TypeScript，例如使用已保存的令牌调用 GitHub API。
• 代码包： 代理编写的代码会保存为你拥有的代码包（包含 package.json、README 和源码），其他代理可以导入并调用。
• 仓库会话： 对现有代码包进行定点编辑、提交、检查和发布，无需重写整个文件。
• 任务与 Webhook： 在代码包的 package.json 中用 cron 计划和时区声明定时任务，并支持入站 Webhook URL 以及从代码包发送邮件。
• 适用于任何 MCP 宿主： Kody 支持所有使用 MCP 的代理，并在引导选择器中提供各宿主的具体步骤。

Kody MCP Server 的使用场景

• 在代理之间复用工作：“把这个 GitHub issue 分拣脚本保存为 Kody 代码包，让我的聊天助手也能运行。”
• 使用 API 而不暴露密钥：“用我在 Kody 中保存的 GitHub 令牌，列出分配给我的未合并 Pull Request。”
• 每日自动化：“创建一个 Kody 任务，每天早上检查我的仓库，只有出现新版本时才给我发邮件。”
• 持久上下文：“记住我偏好的部署目标是 staging，下次直接使用。”
• Webhook 处理：“在 Kody 中生成一个 Webhook URL，记录来自支付服务商的请求内容。”

Kody MCP Server 常见问题排查

• 授权失败。 请验证 Kody 账户的邮箱；验证前授权和 MCP 都无法使用。
• Claude Desktop 中看不到 Kody 的工具。 工具在对话开始时绑定，连接后请新建一个对话。
• 你的宿主不在引导列表中。 在 /onboarding 中选择“Not listed”，并使用原始 MCP URL。
• 免费方案下任务停止运行。 Free 方案允许 5 个定时任务、最短 15 分钟间隔和 1 个并发工作流；Pro 会提高这些限制。