Keelen

keelen-mcp

在聊天中指挥 Keelen——面向 GitHub 的 AI 编码 Agent。

构建应用和内部工具，或按照你选择的审批和合并控制，持续推进已定义的待办事项。Keelen 会将请求转化为持续推进的路线图，规划任务、运行检查，并在你的代码库中创建拉取请求。

将 SETUP.md 粘贴到兼容的 MCP 客户端中，然后说 “帮我完成设置。” 你的 Agent 会引导你设置账户并创建项目。你需要在浏览器中确认电子邮件、完成 AI 凭据连接、GitHub 审批以及任何账单步骤。连接完成后，你可以通过聊天提交请求、设置优先级并回答有关工作的提问。

使用你自己的受支持 AI 订阅或 API 密钥连接 Claude Code、 Codex、GLM、Kimi 或 Grok。Keelen 不会在 AI 使用费用上加价。 了解 MCP 工作流的运作方式。

此代码库仅包含文档。它介绍的是托管的 Model Context Protocol（MCP）服务，地址为 https://keelen.ai/mcp。Keelen 以托管服务的形式运行编码工作流； 此代码库包含相关文档和客户端配置示例。

录屏展示的是较早版本的设置流程。账户验证和浏览器审批请遵循下方的当前说明。

可以交由 Keelen 处理的工作

• 构建应用，或推进个人项目路线图中的修复、测试和小型功能开发。
• 构建内部请求门户、报告仪表板或集成，让你专注于主要工作。部署、同事登录和访问规则取决于你构建的软件和选择的托管服务。
• 为团队或客户的代码库排入明确的工作，包括非工作时间，然后审查生成的拉取请求和决策。
• 开展安全、法律和控制审查，对发现的问题分类，并将选定的代码工作纳入路线图。这些都是范围有限的审查，并非渗透测试、法律建议或认证。你自己的 Agent 或外部调度器可以通过 MCP 触发重复审查；Keelen 没有内置扫描调度器。

这些是使用示例，并非客户部署或现成模板。你可以为每个项目设置优先级，并选择计划审批、手动合并或其他受支持的控制方式。Keelen 会在更改合并前进行检查，并暂缓未通过检查的更改。容量、服务提供商限制、信息缺失和决策都可能导致工作暂停；排入队列并不意味着工作会在特定时间前完成。

AI 引擎和凭据

请在 Keelen 控制面板中连接凭据，切勿在 MCP 聊天中提供。MCP 客户端使用的工作区 API 密钥与这些凭据相互独立。

AI 引擎	支持的连接方式
Claude Code	使用 Claude Pro 或 Max 登录，或使用 Anthropic API 密钥
Codex	使用 ChatGPT 登录，或使用 OpenAI API 密钥
GLM	Z.ai API 密钥
Kimi	Kimi Code 会员密钥或 Moonshot Open Platform API 密钥
Grok	使用 SuperGrok 登录或使用 xAI API 密钥

不同角色可用的引擎可能有所不同。这里的 Grok 指编码引擎； 这并不表示兼容作为 MCP 客户端的 Grok Bot。目前，OpenRouter 仅限用于 Keelen 自己的测试和基准测试项目，尚未对客户代码库启用。

连接和设置

对于无头 / API 密钥客户端（包括使用 bearer 密钥的 Claude Code）， 请先在不使用令牌的情况下连接完整功能，然后将设置说明交给你的 Agent：

claude mcp add --transport http keelen https://keelen.ai/mcp

然后将 SETUP.md 的内容粘贴到你的 Agent 中，并说 “帮我设置”。它会询问你的电子邮件地址，以及发送到你收件箱中的 验证码。接着，它会引导你连接 AI 引擎、批准 GitHub 访问权限、创建或导入项目，并进行配置。 对于需要使用浏览器完成的步骤，请按照控制面板中的链接操作。

完整流程和 50 秒演示请见： https://keelen.ai/mcp-server/?utm_source=mcp-server&utm_medium=github-readme&utm_campaign=setup

使用其他客户端？请参阅对应的客户端指南：

• Claude Code
• Claude Desktop
• Codex
• Cursor
• Windsurf
• 通用 / 其他 MCP 客户端

Claude（连接器和 Claude Code 插件）

Claude 通过 OAuth 连接，无需粘贴 API 密钥。请通过 URL 添加连接器，并以工作区所有者身份在浏览器授权页面登录：

• Claude（网页、Desktop、移动端）/ MCP 连接器： https://keelen.ai/claude/mcp
• Claude Code： claude mcp add --transport http keelen https://keelen.ai/claude/mcp

OAuth 授权默认请求读写权限；需要管理员权限的操作会要求重新授权并提升权限。Claude Code 通过随机分配端口上的 localhost 回调完成 OAuth。

https://keelen.ai/claude/mcp 是 Claude 目录的功能界面。它省略了两个工具，因此始终提供 40 个工具：get_billing（账单由 Keelen 控制面板处理）和 project_digest。包含这两个工具在内的完整功能界面是 https://keelen.ai/mcp——无头 / API 密钥路径请使用此地址，具体说明见上文。

此仓库也包含 Claude Code 插件包。这里提供了两组清单文件，分别指向不同的功能界面：

文件	生态系统	MCP 功能界面
.claude-plugin/plugin.json + .mcp.json	Claude Code 插件	https://keelen.ai/claude/mcp
plugin.json + mcp.json	agent-plugins.org	https://keelen.ai/mcp

Claude Code 插件将在 Anthropic 的插件目录中上架后即可安装；在此之前，请使用上文所述的客户端设置方式。指南：Claude Code、 Claude Desktop。

正在制作 Roblox 游戏？Keelen 可以根据自然语言请求生成美术、音频、网格、天空盒和动画角色——请参阅 roblox-assets.md。

工具（简要）

该服务默认提供 41 个工具；启用默认关闭的 project_digest 标志后，则提供 42 个工具。**project_digest 默认关闭， 且通常不可用。**其中两个工具（signup、verify_email）完全不需要密钥； 其余工具需要使用 verify_email 返回的 bearer 密钥。包含参数和行为的完整参考文档： TOOLS.md。

分组	工具
入门	signup、verify_email
引导设置	get_onboarding_status、open_dashboard、connect_github、list_github_repos、import_project、get_provisioning_status、get_billing
项目与路线图	project_digest、list_projects、create_project、archive_project、delete_project、submit_request、get_request_status、answer_request、refine_request、set_product_vision、set_product_goal、get_product_vision、get_product_goal、list_roadmap、reorder_roadmap、cancel_roadmap_item、clear_horizon_pin、project_status、list_escalations、resolve_escalation、retry_blocked_task、rearm_roadmap_item、resolve_platform_policy_conflict、replan_task、close_task、control_scheduler、set_ui_review_scenario_cap、rollback_roblox_place
审查	run_security_review、run_legal_exposure_review、get_legal_exposure_findings、run_control_gap_review、get_control_gap_findings

该服务支持 MCP 协议修订版 2026-07-28 以及更早的握手修订版，均通过同一端点提供——客户端无需采取任何操作即可使用。详情请参阅 clients/generic.md；重要的契约变更记录在 CHANGELOG.md 中。

Portfolio Manager 0.4.1 是用于管理所选现有公开或私有项目的手动模板。打开已发布的 0.4.1 模板，并按照指南连接自己的账户。另有独立的 Portfolio OAuth 接口可供使用。 Portfolio 参考文档介绍了其受限接口和可选的 0.4 管理功能。委托操作需要所有者额外选择加入，复制手动模板不会启用这些操作；手动管理读取操作则使用所选项目的授权。上文的主要 MCP 设置方式保持不变。

常见问题

**在我同意任何事项之前，我的代码会被访问吗？**不会。连接 MCP 服务时无需提供令牌，这只能让你注册并验证电子邮件——服务无法查看、读取或修改任何代码仓库。connect_github 需要你在浏览器中明确批准安装 GitHub App；之后的每次构建都会在独立的、按租户隔离的沙箱中运行，该沙箱仅限于你自己的工作区。

**费用是多少？**注册、连接 GitHub 和创建项目均免费。实际运行自主循环（计算）需要有效订阅——准备就绪时，get_billing() 会返回 Stripe 结账链接。免费／未付费的工作区可以完成项目创建之前的所有操作。账单处于有效状态、项目的循环已启用且满足设置要求后，即可开始工作。

**如何撤销访问权限？**通过此流程或控制面板生成的每个密钥都可以单独撤销。前往 Keelen 控制面板 → 设置 → API 密钥，然后删除相应密钥。撤销会立即生效；你的 Agent 需要新的密钥（重新运行注册流程，或从控制面板生成新密钥）才能继续调用该服务。

请参阅 SECURITY.md，了解完整的安全模型：MCP 服务能够和不能访问的内容、速率限制以及密钥处理方式。

支持

如有问题或遇到故障，请联系：[email protected]