The Deployer

The Deployer MCP 服务

让 Claude Code、Codex、Cursor、VS Code 或任何 AI 编码 Agent 使用 The Deployer 部署并运行你的应用。只需让它把应用上线，它就会检查代码、修复可能导致部署失败的问题、创建项目、设置环境变量，并向你展示托管方案及每月费用。在你确认后，它会将应用部署到你自己的云账户，跟踪部署进度并修复失败问题。之后，它还可以重新部署、添加域名、扩容、安排启动和停止时间、连接数据库等。

The Deployer 会在你自己的 DigitalOcean、AWS、Google Cloud 或 Azure 账户中运行应用，也可以在你自己的服务器上运行，因此云服务费用会直接计入你的账户。

工具

工具	功能	密钥要求
guide	为 Agent 提供的 The Deployer 操作指南：部署顺序、代码要求以及如何修复故障	不需要
check_repo	公共仓库能否部署？检查结果、缺少的内容，以及在各云平台上的费用	不需要
plan_deploy	检查结果，以及你已连接的账户和项目，还有下一步操作	任意
account	你已连接的云平台和代码托管服务、工作区，以及密钥可执行的操作	任意
status	你的项目、项目的线上地址及最近一次部署	任意
project	查看单个项目的详细信息和明确的下一步操作	任意
deployment	查看部署进度、等待事项，以及失败时需要修复的问题	任意
logs	查看部署日志，敏感信息已移除	任意
diagnose	对运行中的服务器进行只读检查：容器、应用日志、内存和磁盘	任意
redeploy	拉取线上项目分支的最新代码并重启项目	任意
create_project	根据仓库创建项目并读取代码	操作
set_env	设置环境变量；不会显示变量值	操作
launch	显示方案和费用，并在你确认后启动	操作
api_catalog / api_schema / api	其他所有操作：域名、扩容、计划任务、数据库、访问权限、环境、蓝图、服务器、接管	读取：任意。更改：操作
request_done_for_you	申请由他人代为完成的 Launch 或 Move；你需要在 The Deployer 中完成订单	任意

要创建密钥，请登录 The Deployer，打开 Profile，然后选择 API keys and AI coding tools。选择 Operate，允许 Agent 设置并运行项目；也可以选择 Look and redeploy。页面还会显示已填入密钥的这些配置。

Agent 使用密钥绝不能执行以下操作：查看你的云平台或 Git 凭据、查看环境变量值、更改账单、团队或账户、删除项目、数据库或服务器，或创建密钥。任何会产生费用的操作都必须等你确认。

设置

托管服务无需安装任何内容。将 dpl_your_key 替换为你的密钥。

不要将密钥放入你会提交的文件中。请将其放在用户级设置中，或让你的工具从环境变量或提示词中读取，如下方项目文件配置示例所示。

Claude Code，适用于你的所有项目（存储在 ~/.claude.json 中）：

claude mcp add --transport http --scope user thedeployer https://app.thedploy.com/api/v1/mcp --header "Authorization: Bearer dpl_your_key"

要在项目的 .mcp.json 中共享服务，请将 "Authorization": "Bearer ${THEDEPLOYER_API_KEY}" 用作请求头。Claude Code 会从每个人的 THEDEPLOYER_API_KEY 环境变量中读取密钥。

Codex，在 ~/.codex/config.toml 中：

[mcp_servers.thedeployer]
command = "npx"
args = ["-y", "thedeployer-mcp"]
env = { THEDEPLOYER_API_KEY = "dpl_your_key" }

Cursor，在 ~/.cursor/mcp.json 中：

{
  "mcpServers": {
    "thedeployer": {
      "url": "https://app.thedploy.com/api/v1/mcp",
      "headers": { "Authorization": "Bearer dpl_your_key" }
    }
  }
}

在项目的 .cursor/mcp.json 中，请改用 "Authorization": "Bearer ${env:THEDEPLOYER_API_KEY}"，这样 Cursor 就会从你的环境中读取密钥。

VS Code，在 .vscode/mcp.json 中。VS Code 会在首次使用时询问密钥，并安全地存储它：

{
  "inputs": [
    { "type": "promptString", "id": "thedeployer-key", "description": "The Deployer API key", "password": true }
  ],
  "servers": {
    "thedeployer": {
      "type": "http",
      "url": "https://app.thedploy.com/api/v1/mcp",
      "headers": { "Authorization": "Bearer ${input:thedeployer-key}" }
    }
  }
}

用户配置中也可以使用相同的设置（运行 MCP: Open User Configuration）。

Gemini CLI，在 ~/.gemini/settings.json 中：

{
  "mcpServers": {
    "thedeployer": {
      "httpUrl": "https://app.thedploy.com/api/v1/mcp",
      "headers": { "Authorization": "Bearer dpl_your_key" }
    }
  }
}

启动本地命令的工具（Cline、Windsurf 等）使用此软件包，且需要 Node.js 18 或更高版本。将其添加到工具的用户级 MCP 设置中：

{
  "mcpServers": {
    "thedeployer": {
      "command": "npx",
      "args": ["-y", "thedeployer-mcp"],
      "env": { "THEDEPLOYER_API_KEY": "dpl_your_key" }
    }
  }
}

如果你的工具配置看起来不同，请参阅其 MCP 文档，了解对应字段：带有 Authorization 请求头的 URL，或带有环境变量的命令。

代理和公司网络

使用托管服务时，由你的 AI 工具发起连接，因此会应用它自身的代理设置。

此软件包使用 Node.js，默认会忽略 HTTPS_PROXY。启用代理时，请在其旁添加 NODE_USE_ENV_PROXY，这需要 Node.js 22.21 或更高版本，或 24.0 或更高版本。（--use-env-proxy 标志从 Node.js 22.21 或 24.5 起也能实现相同效果。）在较旧版本中，此软件包无法通过代理连接。

如果你的网络使用自有证书检查 HTTPS，请将 NODE_EXTRA_CA_CERTS 设置为该证书文件（PEM）：

"env": {
  "THEDEPLOYER_API_KEY": "dpl_your_key",
  "HTTPS_PROXY": "http://proxy.example.com:8080",
  "NODE_USE_ENV_PROXY": "1",
  "NODE_EXTRA_CA_CERTS": "/path/to/company-ca.pem"
}

密钥的用途与限制

密钥只能用于 The Deployer 的 MCP 服务，且只能通过其工具使用：check_repo、plan_deploy、status、logs（已移除密钥）、redeploy 和 request_done_for_you。它无法访问你的云或 git 凭据、环境变量、账单或账户设置，也无法创建更多密钥。The Deployer 只存储密钥的哈希值。你可以随时在个人资料页面撤销密钥；每个工具或设备使用一个密钥，这样撤销某个密钥时不会影响其他密钥。更改或重置密码会撤销你的所有密钥。

redeploy 会更改正在运行的应用。请让工具在运行 redeploy 前征求你的同意，而不是自动批准。

工具的答复来自你的代码仓库和部署。请像对待 Agent 读取的其他文本一样谨慎对待这些内容。

此软件包的工作方式

index.mjs 是一个无依赖的桥接程序。它从 stdin 读取 MCP 消息，使用你的密钥通过 HTTPS 将每条消息发送到 The Deployer 的托管端点，并将答复写入 stdout。工具运行在 The Deployer 上，因此这些工具更新时，此软件包无需更改。

每个请求都会得到答复。当 The Deployer 拒绝请求或无法连接时，答复会说明原因，例如密钥已撤销或发生超时。桥接程序绝不会跟随重定向，也绝不会在 Authorization 请求头以外的任何位置放置你的密钥。

变量	含义
THEDEPLOYER_API_KEY	你的个人 API 密钥。未设置时，只能使用 check_repo
THEDEPLOYER_MCP_URL	端点；默认值为 https://app.thedploy.com/api/v1/mcp。必须使用 https://，但本机地址（127.0.0.1、::1 或 localhost）除外
THEDEPLOYER_TIMEOUT_MS	等待单次答复的时长，单位为毫秒，范围为 1000 到 600000（默认值为 200000）

npm test

许可证

MIT