# 通过 AI 智能体部署（MCP）

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

Last reviewed: 2026-11-12

## 它是什么

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。

Sources: https://api.deployvera.com/api/plans · https://deployvera.com/docker · https://deployvera.com/help
