vercel-automation

通过 Rube MCP 自动化 Vercel

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

工具包文档：composio.dev/toolkits/vercel

前置条件

• 必须已连接 Rube MCP（可使用 RUBE_SEARCH_TOOLS）
• 通过 RUBE_MANAGE_CONNECTIONS 建立有效的 Vercel 连接，工具包为 vercel
• 始终先调用 RUBE_SEARCH_TOOLS，以获取当前工具架构

设置

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

1. 确认 RUBE_SEARCH_TOOLS 能够响应，以验证 Rube MCP 是否可用
2. 调用 RUBE_MANAGE_CONNECTIONS，指定工具包 vercel
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 返回无服务器函数日志
• 部署事件包含状态变更信息，有助于调试时序问题

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 管理
• SSL 证书会自动配置，但新域名可能需要等待一段时间
• 不支持在根域名上使用 CNAME 记录；请改用 A 记录
• MX 记录需要优先级值

5. 管理项目

适用场景：用户想要列出、检查或更新项目设置

工具调用顺序：

1. VERCEL_LIST_PROJECTS - 列出所有项目 [必需]
2. VERCEL_GET_PROJECT - 获取详细的项目信息 [可选]
3. VERCEL_UPDATE_PROJECT - 修改项目设置 [可选]

关键参数：

• idOrName：用于查找的项目 ID 或名称
• name：用于更新的项目名称
• framework：框架预设（例如，'nextjs'、'vite'、'remix'）
• buildCommand：自定义构建命令覆盖项
• rootDirectory：如果不是仓库根目录，则指定根目录

注意事项：

• 项目名称在团队/账户范围内必须全局唯一
• 更改框架设置会影响后续部署
• rootDirectory 是相对于仓库根目录的路径

6. 团队管理

适用场景：用户想要查看团队信息或列出团队成员

工具调用顺序：

1. VERCEL_LIST_TEAMS - 列出用户所属的所有团队 [必需]
2. VERCEL_GET_TEAM - 获取详细的团队信息 [可选]
3. VERCEL_GET_TEAM_MEMBERS - 列出特定团队的成员 [可选]

关键参数：

• teamId：团队标识符
• limit：每页结果数量
• role：按角色筛选成员

注意事项：

• 团队操作需要相应的团队级权限
• 个人账户没有团队；团队端点会返回空结果
• 成员角色包括 'OWNER'、'MEMBER'、'DEVELOPER'、'VIEWER'

常见模式

ID 解析

项目名称 -> 项目 ID：

1. Call VERCEL_LIST_PROJECTS
2. Find project by name in response
3. Extract id field for subsequent operations

域名 -> DNS 记录：

1. Call VERCEL_GET_DNS_RECORDS with domain name
2. Extract record IDs for update/delete operations

分页

• 使用 limit 参数控制每页大小
• 检查响应中的分页令牌或 next 字段
• 持续获取数据，直到没有更多页面

常见陷阱

部署状态：

• 状态包括：INITIALIZING、ANALYZING、BUILDING、DEPLOYING、READY、ERROR、CANCELED、QUEUED
• 只有 READY 部署处于在线状态并提供流量服务
• 应查看 ERROR 部署的日志，了解失败详情

环境变量：

• Secret 类型的变量为只写；创建后无法检索其值
• 环境变量按环境划分作用范围（production、preview、development）
• 环境变量变更需要重新部署才能生效

速率限制：

• Vercel API 对每个端点都有速率限制
• 收到 429 响应时应实施退避策略
• 尽可能批量操作，以减少 API 调用

快速参考

任务	工具标识	关键参数
列出项目	VERCEL_LIST_PROJECTS	limit
获取项目详情	VERCEL_GET_PROJECT	idOrName
更新项目	VERCEL_UPDATE_PROJECT	idOrName, name, framework
列出部署	VERCEL_LIST_ALL_DEPLOYMENTS	projectId, state, limit
获取部署	VERCEL_GET_DEPLOYMENT	idOrUrl
创建部署	VERCEL_CREATE_NEW_DEPLOYMENT	name, target, gitSource
部署日志	VERCEL_GET_DEPLOYMENT_LOGS	deploymentId
运行时日志	VERCEL_GET_RUNTIME_LOGS	deploymentId
列出环境变量	VERCEL_LIST_ENV_VARIABLES	projectId
添加环境变量	VERCEL_ADD_ENVIRONMENT_VARIABLE	projectId, key, value, target
删除环境变量	VERCEL_DELETE_ENVIRONMENT_VARIABLE	projectId, id
获取域名	VERCEL_GET_DOMAIN	domain
获取域名配置	VERCEL_GET_DOMAIN_CONFIG	domain
列出 DNS 记录	VERCEL_GET_DNS_RECORDS	domain
创建 DNS 记录	VERCEL_CREATE_DNS_RECORD	domain, name, type, value
更新 DNS 记录	VERCEL_UPDATE_DNS_RECORD	domain, recordId
列出项目域名	VERCEL_LIST_PROJECT_DOMAINS	projectId
列出团队	VERCEL_LIST_TEAMS	(none)
获取团队	VERCEL_GET_TEAM	teamId
获取团队成员	VERCEL_GET_TEAM_MEMBERS	teamId, limit

---

由 Composio 提供支持