TECHNICAL REFERENCE
通过 AI 智能体部署(MCP)
在 Claude Code、Cursor、VS Code 或 Codex 中使用 DeployVera 托管的 MCP 服务器:安装、登录、权限、批准与限制。
它是什么
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。