Hatchable

Hatchable MCP

通过任意 MCP 客户端，在 Hatchable 上构建并托管全栈 Web 应用和网站。每个项目都拥有独立的 Postgres 数据库、身份验证、存储、域名、定时任务和电子邮件，并能在几秒内获得一个可访问的 URL。免费套餐，无需积分。

此仓库包含两部分：Hatchable 的 Claude Code 插件（本目录就是该插件），以及适用于其他所有 MCP 客户端的连接说明。Hatchable 的代码运行在我们的基础设施上，而非你的设备上；无需在本地构建或安装任何内容。

端点	https://hatchable.com/mcp
传输方式	Streamable HTTP（MCP 2025-03-26）
身份验证	通过 PKCE 和动态客户端注册（RFC 7591）实现 OAuth 2.1。支持 Bearer 回退方式。
注册表	com.hatchable/hatchable
主页	hatchable.com
文档	hatchable.com/docs/developers

Claude Code 插件

/plugin marketplace add anthropics/claude-plugins-community
/plugin install hatchable@claude-community

然后连接你的账户：运行 /mcp，选择 hatchable，并完成登录。新账户免费，你发布到开放 Web 的第一个应用也免费。

此插件提供：

• 预配置的 Hatchable MCP 服务。 提供 34 个工具，可用于创建项目、编写文件、运行 SQL、部署、读取日志和派生模板。完整参考请参阅 hatchable.com/docs/developers/mcp。
• /hatchable:new <description>：根据自然语言描述构建并部署应用。返回可访问的 URL。
• /hatchable:import：部署你当前所在目录中的代码库。将文件映射到平台结构、运行验证器，并引导你解决所有阻碍。
• /hatchable:fix <what's wrong>：使用平台自己的日志和试运行验证器，诊断被拒绝的部署或已损坏的线上应用。
• hatchable:builder Agent：Claude 可将整个构建任务委派给它的应用构建器。它会在云端创建、编写代码、部署并验证，然后返回可访问的 URL。使用 @hatchable:builder 提及它，也可以让 Claude 自行选择。

Hatchable 项目就是一个文件夹：路径会成为路由，SQL 文件会成为架构，一个 TOML 文件会声明其余配置。平台会通过 MCP（list_skills、read_skill）向你的 Agent 提供自身的构建模式，因此 Claude 会在构建时读取当前约定，而不是依赖训练数据。

若要在安装插件前从检出目录试用，请在此目录中运行：claude --plugin-dir .。

按客户端设置

Claude Code（终端）

安装插件（见上文），或者直接添加服务。其余步骤由 OAuth 处理：

claude mcp add --transport http hatchable https://hatchable.com/mcp

还没有 Claude Code？在此安装。

Claude.ai（网页）

1. 打开 claude.ai/customize/connectors，点击 Connectors 旁边的 +。
2. 在 Add custom connector 对话框中，将其命名为 Hatchable，粘贴 https://hatchable.com/mcp，然后点击 Add。
3. Claude 会将你重定向到 hatchable.com 进行授权，此操作会创建你的免费账户。

支持 Free（1 个连接器）、Pro、Max、Team 和 Enterprise 套餐。在 Team/Enterprise 套餐中，需由所有者通过 Organization settings → Connectors 添加。

ChatGPT

1. 打开 chatgpt.com/apps#settings/Connectors/Advanced，开启 Developer Mode，然后点击 Create app。
2. 将其命名为 Hatchable，在 MCP Server URL 下粘贴 https://hatchable.com/mcp，保留 OAuth，勾选同意框，然后点击 Create。
3. ChatGPT 会将你重定向到 hatchable.com 进行授权，此操作会创建你的免费账户。

需要 Plus、Pro、Business、Enterprise 或 Edu 套餐（Developer Mode 的前提条件）。

Codex

1. 打开 Codex → Settings → MCP servers → + Add server。
2. 将其命名为 Hatchable，选择 Streamable HTTP，粘贴 https://hatchable.com/mcp，然后点击 Save。
3. 点击新行中的 Authenticate，并在 hatchable.com 上批准弹窗 — 这会创建你的免费账户。

还没有 Codex？点击此处下载。

Cursor

粘贴到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "hatchable": {
      "url": "https://hatchable.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_HATCHABLE_TOKEN"
      }
    }
  }
}

注册后，从 hatchable.com/console/settings?tab=api-keys 获取你的令牌（只需 10 秒，无需信用卡）。

Google Antigravity

1. 打开命令面板（Cmd/Ctrl + Shift + P）。

2. 选择 Antigravity: Manage MCP Servers，然后点击 View raw config。

3. 粘贴并保存：

   {
     "mcpServers": {
       "hatchable": {
         "serverUrl": "https://hatchable.com/mcp"
       }
     }
   }
   

4. 重新打开 Manage MCP Servers，点击 hatchable 行中的 Authenticate，并在 hatchable.com 上批准。

还没有 Antigravity？从 Google 下载 — 免费，无需信用卡。

其他 MCP 客户端

任何支持 Streamable HTTP + OAuth 的客户端都可以使用。将 https://hatchable.com/mcp 配置为端点，然后由客户端处理 OAuth 流程。仅支持 bearer token 的客户端应发送 Authorization: Bearer <API_KEY>，密钥可从控制台获取。

你可以做什么（工具功能）

端点实时提供 34 个工具：

• 项目生命周期：create_project、get_project、list_projects、update_project、fork_project、create_preview_link
• 文件：write_file、write_files、patch_file、read_file、grep、list_files、delete_file、upload_file、list_pending_uploads、import_file_from_url
• 数据库：execute_sql、get_schema
• 部署和可观测性：dry_run_deploy、deploy、list_deployments、get_deployment、list_functions、run_function、run_code、view_logs、list_cron_jobs
• Agent 任务：list_agent_tasks、update_agent_task（项目所有者在控制台中提交的自然语言请求）
• 指导和发现：list_skills、read_skill、search_documentation、search_projects、submit_platform_feedback

每个项目都配有专用的 Postgres 数据库、内置身份验证（电子邮件验证码和 OAuth 提供商）、定时任务调度、对象存储、电子邮件发送和 AI 路由；这些功能都可通过处理程序中的 hatchable SDK 使用。无需 npm install，也无需构建步骤。请参阅 hatchable.com/docs/developers，了解 SDK 和处理程序契约。

清单

• server.json — MCP Registry 清单（架构版本 2025-12-11），也通过 hatchable.com/server.json 和 hatchable.com/.well-known/mcp/server.json 提供。
• smithery.yaml — Smithery 提交配置。

安全与身份验证

• OAuth 元数据（RFC 8414）：/.well-known/oauth-authorization-server
• 受保护资源元数据（RFC 9728）：/.well-known/oauth-protected-resource
• 支持动态客户端注册（RFC 7591）— MCP 客户端可以自动注册。

Bearer token 按账户限定范围。你可以在控制台中轮换或撤销它们。

Docker（用于注册表和扫描器）

此仓库中的 Dockerfile 是一个小型 stdio-to-HTTP 代理（proxy.mjs）。它的作用是让需要可运行容器的注册表和质量扫描器（Glama、Smithery 等）检查工具功能。最终用户无需构建它 — 直接在 MCP 客户端中配置 https://hatchable.com/mcp，并让客户端使用原生 HTTP 传输与服务通信。

docker build -t hatchable-mcp .
docker run --rm -i hatchable-mcp  # stdio ↔ https://hatchable.com/mcp

许可证

MIT。参见 LICENSE。

联系方式

• 网站： hatchable.com
• 电子邮件： [email protected]
• 问题： 有关 MCP 集成的问题，请在此仓库中提交 issue；有关账户或账单的问题，请使用控制台内的支持流程。