---

name: vercel-automation description: "通过 Rube MCP (Composio) 自动化 Vercel 任务：管理部署、域名、DNS、环境变量、项目和团队。始终先搜索工具以获取当前 schema。" risk: critical source: community date_added: "2026-02-27"

通过 Rube MCP 实现 Vercel 自动化

通过 Composio 的 Vercel 工具包经由 Rube MCP 自动化 Vercel 平台操作。

前置条件

• Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）
• 通过 RUBE_MANAGE_CONNECTIONS 使用工具包 vercel 建立活跃的 Vercel 连接
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema

设置

获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥——只需添加端点即可使用。

1. 确认 RUBE_SEARCH_TOOLS 响应以验证 Rube MCP 可用
2. 使用工具包 vercel 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接不是 ACTIVE 状态，按照返回的认证链接完成 Vercel OAuth
4. 确认连接状态显示 ACTIVE 后再运行任何工作流

核心工作流

1. 监控和检查部署

使用场景：用户想要列出、检查或调试部署

工具调用顺序：

1. VERCEL_LIST_ALL_DEPLOYMENTS 或 VERCEL_GET_DEPLOYMENTS - 列出部署并支持筛选 [必需]
2. VERCEL_GET_DEPLOYMENT 或 VERCEL_GET_DEPLOYMENT_DETAILS - 获取特定部署信息 [可选]
3. VERCEL_GET_DEPLOYMENT_LOGS 或 VERCEL_GET_RUNTIME_LOGS - 查看构建/运行时日志 [可选]
4. VERCEL_GET_DEPLOYMENT_EVENTS - 获取部署事件时间线 [可选]
5. VERCEL_LIST_DEPLOYMENT_CHECKS - 查看部署检查结果 [可选]

关键参数：

• projectId：按项目筛选部署
• state：按部署状态筛选（例如 'READY'、'ERROR'、'BUILDING'）
• limit：返回的部署数量
• target：按环境筛选（'production'、'preview'）
• deploymentId 或 idOrUrl：特定部署标识符

注意事项：

• 大多数端点同时接受部署 ID 和 URL 作为标识符
• 构建日志和运行时日志是分开的；使用相应的工具
• VERCEL_GET_DEPLOYMENT_LOGS 返回构建日志；VERCEL_GET_RUNTIME_LOGS 返回 Serverless 函数日志
• 部署事件包括状态转换，对调试时序问题很有用

2. 创建和管理部署

使用场景：用户想要触发新部署

工具调用顺序：

1. VERCEL_LIST_PROJECTS - 查找目标项目 [前置条件]
2. VERCEL_CREATE_NEW_DEPLOYMENT - 触发新部署 [必需]
3. VERCEL_GET_DEPLOYMENT - 监控部署进度 [可选]

关键参数：

• name：部署的项目名称
• target：部署目标（'production' 或 'preview'）
• gitSource：带有 ref/分支信息的 Git 仓库源
• files：基于文件部署的文件对象数组

注意事项：

• 必须提供 gitSource 或 files 之一，不能同时提供
• 基于 Git 的部署需要正确的仓库集成
• 生产部署会自动更新生产域名别名
• 部署创建是异步的；使用 GET_DEPLOYMENT 轮询状态

3. 管理环境变量

使用场景：用户想要为项目添加、列出或删除环境变量

工具调用顺序：

1. VERCEL_LIST_PROJECTS - 查找项目 ID [前置条件]
2. VERCEL_LIST_ENV_VARIABLES - 列出现有环境变量 [必需]
3. VERCEL_ADD_ENVIRONMENT_VARIABLE - 添加新环境变量 [可选]
4. VERCEL_DELETE_ENVIRONMENT_VARIABLE - 删除环境变量 [可选]

关键参数：

• projectId：目标项目标识符
• key：环境变量名称
• value：环境变量值
• target：环境数组（'production'、'preview'、'development'）
• type：变量类型（'plain'、'secret'、'encrypted'、'sensitive'）

注意事项：

• 环境变量名称在每个目标环境中必须唯一
• type: 'secret' 的变量创建后无法读取；只返回 ID
• 删除环境变量需要 projectId 和环境变量的 id（不是键名）
• 更改需要新部署才能生效

4. 管理域名和 DNS

使用场景：用户想要配置自定义域名或管理 DNS 记录

工具调用顺序：

1. VERCEL_GET_DOMAIN - 检查域名状态和配置 [必需]
2. VERCEL_GET_DOMAIN_CONFIG - 获取 DNS/SSL 配置详情 [可选]
3. VERCEL_LIST_PROJECT_DOMAINS - 列出项目关联的域名 [可选]
4. VERCEL_GET_DNS_RECORDS - 列出域名的 DNS 记录 [可选]
5. VERCEL_CREATE_DNS_RECORD - 添加新 DNS 记录 [可选]
6. VERCEL_UPDATE_DNS_RECORD - 修改现有 DNS 记录 [可选]

关键参数：

• domain：域名（例如 'example.com'）
• name：DNS 记录名称/子域名
• type：DNS 记录类型（'A'、'AAAA'、'CNAME'、'MX'、'TXT'、'SRV'）
• value：DNS 记录值
• ttl：生存时间（秒）

注意事项：

• 域名必须先添加到 Vercel 才能管理 DNS
• CNAME 记录不能与其他记录类型共存于同一子域名
• SSL 证书在域名验证后自动配置
• DNS 传播可能需要时间；更改不会立即生效