DeployVeraDocs

TECHNICAL REFERENCE

通过 AI 智能体部署(MCP)

在 Claude Code、Cursor、VS Code 或 Codex 中使用 DeployVera 托管的 MCP 服务器:安装、登录、权限、批准与限制。

Last reviewed: Markdown

它是什么

DeployVera 在 https://mcp.deployvera.com/mcp(Streamable HTTP)运行一个托管的 MCP(Model Context Protocol)服务器。连接到它的 Claude Code、Cursor、VS Code 或 Codex 中的 AI 智能体,可以列出已登录账户的项目、启动部署、等待构建、读取构建日志和运行日志、解释构建失败的原因、回退版本以及管理环境变量。

智能体以登录的账户或令牌的权限执行操作,绝不会超出这些权限。购买或更改套餐、付款、账单、账户设置和管理功能不对智能体开放,仍保留在客户面板中。该服务器在 MCP 注册表中为 com.deployvera/mcp,在 npm 上为 deployvera-mcp,同时也在 Claude 连接器目录(https://claude.ai/directory/connectors/deployvera)和 GitHub(https://github.com/deployvera/deployvera-mcp)上提供。智能体可以在你已有的套餐中(前提是有空闲应用名额)创建项目并部署它;创建项目始终需要你的批准,订购套餐仍在面板中完成。

安装:Claude Code

在终端中运行一次下面的命令。首次调用工具时会打开浏览器窗口供你登录(OAuth)。

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

安装:Cursor

一键安装:https://cursor.com/install-mcp?name=deployvera&config=eyJ1cmwiOiJodHRwczovL21jcC5kZXBsb3l2ZXJhLmNvbS9tY3AifQ%3D%3D

或者手动将服务器添加到 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "deployvera": {
      "url": "https://mcp.deployvera.com/mcp"
    }
  }
}

安装:VS Code

将服务器添加到 VS Code 的 MCP 配置(mcp.json)中:

{
  "servers": {
    "deployvera": {
      "type": "http",
      "url": "https://mcp.deployvera.com/mcp"
    }
  }
}

安装:Codex

将服务器添加到 ~/.codex/config.toml,并把个人令牌(见下一节)导出为下面所示名称的环境变量:

[mcp_servers.deployvera]
url = "https://mcp.deployvera.com/mcp"
bearer_token_env_var = "DEPLOYVERA_TOKEN"

安装:stdio 客户端

只能启动本地进程的客户端,可以使用 npm 包来代替托管地址。它所需的令牌变量见仓库 README。

npx -y deployvera-mcp

登录:浏览器 OAuth 或个人令牌

默认使用浏览器 OAuth:客户端会打开 DeployVera 的登录和授权页面,由账户所有者选择授予哪些权限。已连接的应用可以在面板的「设置 > AI 智能体访问」中断开。

对于没有浏览器登录流程的客户端,可以改用个人令牌。它在面板的「设置 > AI 智能体访问」中创建,以 dvp_ 开头,只显示一次,有名称、所选的权限集合和有效期(30、90 或 365 天),并且可以随时撤销;撤销后访问权限立即失效。每个账户最多可以有 10 个有效令牌。请以 Authorization: Bearer dvp_... 的形式发送。请像对待密码一样保管它,切勿提交到代码仓库。

权限(scopes)

每个令牌和每次 OAuth 登录都包含三个权限范围中的一部分。

  • read:始终开启。列出项目、数据库、构建、日志、环境变量的名称、你自己的服务、可连接的仓库以及域名状态。
  • deploy:启动部署、取消构建、回退版本、创建项目以及管理自定义域名。
  • env:写入和删除环境变量。智能体可以设置变量的值,但永远无法读回变量的值。

在浏览器中批准

有五个操作始终需要账户所有者批准:rollback、delete_env_var、create_project、set_domain 和 remove_domain。工具不会直接执行,而是返回一个批准链接。所有者打开该链接(deployvera.com/approve),登录并用账户密码和双重验证码确认。之后智能体带着批准 ID 再次调用同一个工具。批准 10 分钟后失效,且只对单个操作有效;智能体无法自行批准,check_approval 只会报告状态。

也可以为某个令牌或登录设置:每次部署都需要批准。这是「设置 > AI 智能体访问」中针对单个令牌或登录的选项。

工具

该服务器提供 21 个工具。

  • list_projects、get_project:项目及其当前状态。
  • list_databases、get_database_logs:托管数据库(测试版)及其日志。
  • deploy:启动已连接项目的部署。需要 deploy 权限。
  • get_build:构建状态;wait_seconds(0 到 120)会让调用等待构建完成。
  • get_build_logs:构建日志或运行日志。
  • explain_build_failure:简要说明构建失败的原因。
  • cancel_build:停止正在运行的构建。
  • rollback:回到较早的版本。始终需要批准。
  • list_env_vars:只返回名称,绝不返回值。
  • set_env_vars:写入变量。需要 env 权限。
  • delete_env_var:删除变量。始终需要批准。
  • check_approval:待处理批准的状态。
  • list_services:你自己的服务,包含套餐、状态和空闲应用名额。不包含共享服务。
  • list_repositories:你在已连接的 GitHub 或 GitLab 账户(启用时还包括 Gitea)中可用于部署的仓库。不会返回令牌。
  • create_project:用 Git 仓库在你自己的某个服务中创建项目。始终需要批准,且仅当该服务有空闲应用名额时可用;它绝不会订购或更改套餐。
  • start_domain_verification:返回为自定义域名创建所需的 DNS 记录。它不会更改任何路由,也无需批准。
  • set_domain:在 DNS 验证通过后绑定自定义域名。始终需要批准。
  • remove_domain:解除自定义域名的绑定。始终需要批准。
  • check_domain:域名是否已绑定,以及每个名称当前是否指向该项目。

安全限制

智能体不能购买或更改套餐、付款、更改账单或账户设置,也不能使用任何管理员功能。环境变量的值绝不会返回给智能体。请求限制为每分钟 120 次。每个操作都以登录账户的身份运行,并与面板一样,根据项目归属进行校验。

尽管如此,已连接的智能体仍可在已授予的权限范围内启动部署。请只授予必要的权限,优先选择较短的有效期,为生产项目开启每次部署都需批准的选项,并撤销不再使用的令牌。

典型工作流程

代码推送之后,让智能体部署项目。它会调用 deploy,然后调用 get_build,并将 wait_seconds 设为 120。如果构建失败,它会调用 explain_build_failure 和 get_build_logs。只有在你提出要求时才会建议回退,并且回退要等待你在浏览器中批准。常见的构建错误及修复方法见 /docs/en/build-errors。带示例提示语的简短演示见 https://deployvera.com/deploy-from-claude-code。