Antideploy

antideploy-mcp

在编码 Agent 内通过 Antideploy 部署和运行应用：Claude Code、Cursor、Codex、OpenCode，或任何支持 MCP 的工具。

你描述想要构建什么。Agent 会编写应用，通过一个你批准的链接登录，创建应用及其数据库，进行部署，并告诉你应用的在线地址。无需控制面板、Dockerfile、YAML、复制密钥，也无需 GitHub 仓库。

you  ->  agent writes the app  ->  you approve one link  ->  https://your-app.antideploy.app

安装

选择你的 Agent。每份指南都列出了确切的命令、配置文件、技能，以及如何更新和移除。

Agent	最快捷的安装方式	指南
Claude Code	claude plugin marketplace add antideploy/antideploy-mcp 然后运行 claude plugin install antideploy@antideploy	agents/claude-code.md
Cursor	使用指南中的安装链接，或 .cursor/mcp.json	agents/cursor.md
OpenAI Codex	codex mcp add antideploy -- npx -y [email protected]	agents/codex.md
OpenCode	在 opencode.json 中添加 mcp 条目	agents/opencode.md
其他任何 MCP 客户端	命令为 npx，参数为 -y [email protected]	下文

无需手动安装任何东西。Agent 会通过 npx 运行服务，首次运行时会下载一个约 250 kB 的软件包。

{
  "mcpServers": {
    "antideploy": { "command": "npx", "args": ["-y", "[email protected]"] }
  }
}

没有支持 MCP 的 Agent？只需粘贴一句话。Agent 会按照说明每个步骤的页面操作：

Set this project up to deploy on Antideploy. Fetch https://antideploy.com/agent.md and follow it.

首次部署

Deploy this project on Antideploy.

1. Agent 调用 login，并向你显示一个链接和一组简短代码。
2. 你打开链接，确认代码匹配，然后点击 Approve。如果你还没有账户，同一个链接会为你创建账户。这是你唯一需要做的事。
3. Agent 调用 create_application（将应用记录到 .antideploy.json 中），如果项目需要数据库，则创建一个数据库，然后调用 deploy。
4. Agent 会持续轮询，直到应用上线，并告诉你应用地址以及它部署到哪个 Antideploy 账户。

每台机器只需登录一次。登录信息保存在 ~/.antideploy/config.json 中，只有你可以读取；你也可以随时在 antideploy.com/tokens 撤销登录。

技能

skills/antideploy 是一项 Agent 技能：它会告诉 Agent 何时适合使用 Antideploy、如何连接、如何部署、出现问题时应查看哪些内容，以及何时应改用其他托管服务。它适用于 Claude Code、Cursor、Codex 和 OpenCode，这些工具都读取相同的 SKILL.md 格式。Claude Code 插件会为你安装它；其他指南会说明应将它复制到哪里。

工具

所有工具都是平台 HTTP API 的轻量封装，API 文档见 antideploy.com/api/v1。

分组	工具
登录	login、logout
应用	list_applications、create_application、link_application、check_address、app_settings、update_app_settings
部署	deploy、deployment_status、redeploy、rollback、deployment_history
变量	list_env、set_env、set_env_from_file、remove_env、request_keys
运行	logs、health、metrics、list_schedules、add_schedule、set_schedule_enabled、remove_schedule
数据库	database_info、database_create、database_env_to_file
应用的存储、登录和邮件	storage_create、storage_env_to_file、auth_create、auth_env_to_file、email_create、email_env_to_file、email_status、email_activity、email_deliverability、email_domain、email_overview、email_pause、email_resume、email_test、email_remove
检查和 AI	security_scan、security_scan_status、ai_wallet、create_ai_key、api_info

部署是异步的。deploy、redeploy 和 rollback 会返回一个 taskId；调用 deployment_status，直到状态报告为 succeeded 或 failed。每次调用最多等待 20 秒以完成部署，因此无需在调用之间暂停。

有意不提供的功能：删除应用或其数据库、自定义域名、账单，以及为 AI 钱包充值。这些操作保留在 控制台 中，由用户主动执行。

密钥和文件

• 令牌和密码绝不会进入对话。 login 不会显示令牌。database_env_to_file 和其他 *_env_to_file 工具会将变量直接写入项目中的 .env* 文件，并且只返回变量名称。写入前，它们会先将该文件添加到 .gitignore。
• 绝不会上传 .env 文件。 node_modules、构建产物、私钥或 Python 虚拟环境也不会上传。部署结果会列出所有未包含的 .env 文件。若要从其中存储变量，请使用变量名称调用 set_env_from_file：它会在本地读取文件，只发送指定变量，绝不会显示变量值。它会拒绝平台自行设置的变量名称（DATABASE_URL、PG*、存储、登录和邮件变量、应用自身的地址，以及生成的签名密钥）。
• 仅限由你持有的密钥。 request_keys 会提供一个 antideploy.com 页面，供你粘贴 Stripe 密钥或机器人令牌，这样 Agent 就看不到它。
• 每次只处理一个应用，绝不猜测。 文件夹通过 .antideploy.json（包含 ID，不含密钥；请提交此文件）关联到应用。没有该文件的文件夹会被拒绝，不会靠猜测匹配到某个应用。
• 仅限项目文件夹。 工具只会在启动服务时所在的文件夹（或 ANTIDEPLOY_PROJECT_DIR）内操作。调用中指定的文件夹必须位于其中；主目录或驱动器不能作为项目使用；也不会通过符号链接写入任何内容。即使 Agent 在你没有编写的代码仓库中工作，也无法被诱导将其他文件夹发送到 Antideploy，或在项目之外写入密钥。

限制

上传限制会在部署时从平台读取，因此会遵循平台规定：目前每个项目最多 4,000 个文件、28 MB，单个文件最多 28 MB。每个应用一次只能进行一个部署。较大的项目应改为从 GitHub 部署。平台对套餐、数据库以及无法运行内容的限制，详见 antideploy.com/blog/what-antideploy-cannot-run。

配置

所有配置均为可选。

变量
ANTIDEPLOY_API_KEY	在控制台为单个应用创建的项目密钥（以 ad_ 开头）。适用于流水线或第二台机器。使用该密钥启动的服务会绑定到该应用，且无需 login 即可运行。
ANTIDEPLOY_URL	默认值为 https://antideploy.com。其他地址的登录信息会单独保存在自己的文件中，因此测试服务不会替换你的真实登录信息。
ANTIDEPLOY_PROJECT_DIR	项目文件夹，适用于在其他位置启动服务的客户端。默认为工作目录。

开发

npm install
npm test            # the server over stdio against a stand-in platform, units, packaging
npm run build       # one bundled file in dist/
npm run test:bundle # the same end-to-end suite against the bundle

端到端测试会像 Agent 一样启动真实服务，使用临时主目录，并通过本地 API 替身（test/fake-antideploy.mjs）进行测试。测试不会向 antideploy.com 发送任何内容。平台是否遵守该约定会单独检查；请参阅 ACCEPTANCE.md。

npm run build 会将服务及其依赖打包到一个文件中，因此首次通过 npx 启动时无需解析任何内容。

Antideploy 如何处理你发送的内容

它会读取源代码，判断运行时、框架、构建和启动命令、端口以及代码引用的环境变量，并注明每项判断所依据的文件。它会配置应用所需的资源，包括设置了 DATABASE_URL 的 Postgres 数据库；构建应用，通过 HTTPS 发布，并通过运行状况检查、日志和回滚机制让应用持续运行。完整文档：antideploy.com/docs。

许可证

MIT