---

name: render-automation description: "通过 Rube MCP (Composio) 自动化 Render 任务：服务、部署、项目。始终先搜索工具以获取当前 schema。" risk: unknown source: community date_added: "2026-02-27"

通过 Rube MCP 实现 Render 自动化

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

前置条件

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

设置

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

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

核心工作流

1. 列出和浏览服务

适用场景：用户想要查找或检查 Render 服务（Web 服务、静态站点、Worker、定时任务）

工具序列：

1. RENDER_LIST_SERVICES - 列出所有服务，支持可选过滤器 [必需]

关键参数：

• name：按名称子串过滤服务
• type：按服务类型过滤（'web_service'、'static_site'、'private_service'、'background_worker'、'cron_job'）
• limit：每页最大结果数（默认 20，最大 100）
• cursor：上一响应的分页游标

注意事项：

• 服务类型必须匹配精确的枚举值：'web_service'、'static_site'、'private_service'、'background_worker'、'cron_job'
• 分页使用基于游标的方式；持续跟踪 cursor 直到不存在
• 名称过滤是子串匹配，非精确匹配
• 服务 ID 格式为 'srv-xxxxxxxxxxxx'
• 默认限制为 20；需要全面列表时设置更高值

2. 触发部署

适用场景：用户想要手动部署或重新部署服务

工具序列：

1. RENDER_LIST_SERVICES - 查找要部署的服务 [前置]
2. RENDER_TRIGGER_DEPLOY - 触发新部署 [必需]
3. RENDER_RETRIEVE_DEPLOY - 监控部署进度 [可选]

关键参数：

• TRIGGER_DEPLOY：
  • serviceId：要部署的服务 ID（必需，格式：'srv-xxxxxxxxxxxx'）
  • clearCache：设为 true 在部署前清除构建缓存
• RETRIEVE_DEPLOY：
  • serviceId：服务 ID
  • deployId：触发响应中的部署 ID（格式：'dep-xxxxxxxxxxxx'）

注意事项：

• serviceId 是必需的；先通过 LIST_SERVICES 解析
• 服务 ID 以 'srv-' 前缀开头
• 部署 ID 以 'dep-' 前缀开头
• clearCache: true 强制全新构建；耗时更长但可解决缓存相关问题
• 部署是异步的；使用 RETRIEVE_DEPLOY 轮询状态
• 在另一个部署进行中时触发部署可能会排队

3. 监控部署状态

适用场景：用户想要检查部署的进度或结果

工具序列：

1. RENDER_RETRIEVE_DEPLOY - 获取部署详情和状态 [必需]

关键参数：

• serviceId：服务 ID（必需）
• deployId：部署 ID（必需）
• 响应包含 status、createdAt、updatedAt、finishedAt、commit

注意事项：

• serviceId 和 deployId 都是必需的
• 部署状态包括：'created'、'build_in_progress'、'update_in_progress'、'live'、'deactivated'、'build_failed'、'update_failed'、'canceled'
• 'live' 表示部署成功
• 'build_failed' 或 'update_failed' 表示部署错误
• 以合理间隔轮询（10-30 秒）以避免速率限制

4. 管理项目

适用场景：用户想要列出和组织 Render 项目

工具序列：

1. RENDER_LIST_PROJECTS - 列出所有项目 [必需]

关键参数：

• limit：每页最大结果数（最大 100）
• cursor：上一响应的分页游标

注意事项：

• 项目将相关服务分组在一起
• 分页使用基于游标的方式
• 项目 ID 用于组织目的
• 并非所有服务都会分配到项目中

常见模式

ID 解析

服务名称 -> 服务 ID：

1. 使用 name=service_name 调用 RENDER_LIST_SERVICES
2. 在结果中按名称查找服务
3. 提取 id（格式：'srv-xxxxxxxxxxxx'）

部署查找：

1. 保存 RENDER_TRIGGER_DEPLOY 响应中的 deployId
2. 使用 serviceId 和 deployId 调用 RENDER_RETRIEVE_DEPLOY
3. 检查状态是否完成

部署并监控模式

1. RENDER_LIST_SERVICES -> 按名称查找服务 -> 获取 serviceId
2. 使用 serviceId 调用 RENDER_TRIGGER_DEPLOY -> 获取 deployId
3. 循环：使用 serviceId + deployId 调用 RENDER_RETRIEVE_DEPLOY
4. 检查状态：'live' = 成功，'build_failed'/'update_failed' = 错误
5. 持续轮询直到达到终态

分页

• 使用响应中的 cursor 获取下一页结果
• 当响应中不再包含 cursor 时表示已到最后一页