Back to Details

render-mcp

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Render MCP Server

Render MCP服务器

The Render MCP server lets AI coding tools manage Render services, databases, deploys, logs, and metrics directly. This skill covers setup, authentication, workspace selection, the tool catalog, and troubleshooting.
Action skills (render-deploy, render-debug, render-monitor) use MCP tools for their workflows. If MCP is not connected, set it up using this skill first.
Render MCP服务器允许AI编码工具直接管理Render服务、数据库、部署、日志及指标。本技能涵盖设置、认证、工作区选择、工具目录及故障排查内容。
操作技能（render-deploy、render-debug、render-monitor）在工作流中会用到MCP工具。若MCP未连接，请先使用本技能完成设置。

When to Use

使用场景

  • list_services()
    fails or MCP tools are unavailable
  • First-time Render MCP setup for any AI tool
  • User asks how to connect their AI tool to Render
  • Switching workspaces or troubleshooting auth errors
  • Discovering which MCP tools exist and what they do
  • list_services()
    调用失败或MCP工具不可用
  • 首次为任意AI工具配置Render MCP
  • 用户询问如何将AI工具连接至Render
  • 切换工作区或排查认证错误
  • 了解现有MCP工具及其功能

Connection Details

连接详情

PropertyValue
URL
https://mcp.render.com/mcp
TransportHTTP (streamable)
AuthOAuth when installed via the Render plugin (pre-registered client id); bearer token (API key) for manual setup
API key page
https://dashboard.render.com/u/*/settings#api-keys
(manual setup)
Docs
https://render.com/docs/mcp-server
属性值
URL
https://mcp.render.com/mcp
传输协议HTTP（支持流式传输）
认证方式通过Render插件安装时使用OAuth（预注册客户端ID）；手动设置时使用Bearer token（API密钥）
API密钥页面
https://dashboard.render.com/u/*/settings#api-keys
（手动设置用）
文档
https://render.com/docs/mcp-server

Setup by Tool

按工具设置

Render plugin (recommended)

Render插件（推荐）

The Render plugin for Cursor, Codex, and Claude Code bundles this MCP server with a pre-registered OAuth client id, so no API key is needed. After installing or updating the plugin, reload the tool (restart Cursor or Claude Code, or start a new Codex thread) so it loads the plugin-provided MCP server, then complete the Render OAuth prompt the first time MCP tools are used. Verify with 
list_services()
.
The manual, API-key setups below are for tools without the plugin or for custom MCP configurations.
适用于Cursor、Codex和Claude Code的Render插件已集成该MCP服务器及预注册的OAuth客户端ID，无需API密钥。安装或更新插件后，重新加载工具（重启Cursor或Claude Code，或开启新的Codex线程）以加载插件提供的MCP服务器，首次使用MCP工具时完成Render OAuth授权提示即可。可通过
list_services()
验证连接状态。
以下手动API密钥设置适用于无插件支持的工具或自定义MCP配置场景。

Cursor

Cursor

  1. Get an API key from the Render Dashboard
  2. Add to 
    ~/.cursor/mcp.json
    :
json
{
  "mcpServers": {
    "render": {
      "url": "https://mcp.render.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}
  1. Restart Cursor, then verify with 
    list_services()
  1. 从Render控制台获取API密钥
  2. 将配置添加至
    ~/.cursor/mcp.json
    ：
json
{
  "mcpServers": {
    "render": {
      "url": "https://mcp.render.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}
  1. 重启Cursor，然后通过
    list_services()
    验证连接

Claude Code

Claude Code

  1. Get an API key from the Render Dashboard
  2. Add the MCP server:
bash
claude mcp add --transport http render https://mcp.render.com/mcp --header "Authorization: Bearer <YOUR_API_KEY>"
  1. Restart Claude Code, then verify with 
    list_services()
  1. 从Render控制台获取API密钥
  2. 添加MCP服务器：
bash
claude mcp add --transport http render https://mcp.render.com/mcp --header "Authorization: Bearer <YOUR_API_KEY>"
  1. 重启Claude Code，然后通过
    list_services()
    验证连接

Codex

Codex

  1. Get an API key from the Render Dashboard
  2. Set the key in your shell:
bash
export RENDER_API_KEY="<YOUR_API_KEY>"
  1. Add the MCP server:
bash
codex mcp add render --url https://mcp.render.com/mcp --bearer-token-env-var RENDER_API_KEY
  1. Restart Codex, then verify with 
    list_services()
  1. 从Render控制台获取API密钥
  2. 在Shell中设置密钥：
bash
export RENDER_API_KEY="<YOUR_API_KEY>"
  1. 添加MCP服务器：
bash
codex mcp add render --url https://mcp.render.com/mcp --bearer-token-env-var RENDER_API_KEY
  1. 重启Codex，然后通过
    list_services()
    验证连接

Other Tools

其他工具

For tools not listed above, use the generic HTTP MCP configuration:
  • URL: 
    https://mcp.render.com/mcp
  • Auth header: 
    Authorization: Bearer <YOUR_API_KEY>
  • Transport: HTTP (streamable HTTP, not SSE)
See Render MCP docs for tool-specific instructions.
对于未列出的工具，使用通用HTTP MCP配置：
  • URL： 
    https://mcp.render.com/mcp
  • 认证头： 
    Authorization: Bearer <YOUR_API_KEY>
  • 传输协议： HTTP（流式HTTP，非SSE）
工具特定说明请查看Render MCP文档。

Workspace Selection

工作区选择

After MCP is connected, set the active workspace:
Set my Render workspace to [WORKSPACE_NAME]
Or programmatically:
get_selected_workspace()   # Check current
list_workspaces()          # List available
All MCP operations run against the active workspace.
MCP连接完成后，设置活跃工作区：
Set my Render workspace to [WORKSPACE_NAME]
或通过代码方式操作：
get_selected_workspace()   # 查看当前工作区
list_workspaces()          # 列出可用工作区
所有MCP操作均针对活跃工作区执行。

Tool Catalog

工具目录

Service management

服务管理

ToolPurpose
list_services()
List all services and datastores
get_service(serviceId)
Get service details
create_web_service(...)
Create a web service from Git repo
create_static_site(...)
Create a static site from Git repo
update_service(serviceId, ...)
Update service configuration
restart_service(serviceId)
Restart a service
工具用途
list_services()
列出所有服务与数据存储
get_service(serviceId)
获取服务详情
create_web_service(...)
通过Git仓库创建Web服务
create_static_site(...)
通过Git仓库创建静态站点
update_service(serviceId, ...)
更新服务配置
restart_service(serviceId)
重启服务

Deploys

部署管理

ToolPurpose
list_deploys(serviceId, limit)
List deploys for a service
trigger_deploy(serviceId)
Trigger a new deploy
工具用途
list_deploys(serviceId, limit)
列出服务的部署记录
trigger_deploy(serviceId)
触发新部署

Logs

日志管理

ToolPurpose
list_logs(resource, level, type, text, statusCode, limit)
Query logs with filters
Key filters: 
level
(error, warn, info), 
type
(build, deploy), 
text
(search string), 
statusCode
(HTTP codes).
工具用途
list_logs(resource, level, type, text, statusCode, limit)
带筛选条件查询日志
关键筛选条件：
level
（error、warn、info）、
type
（build、deploy）、
text
（搜索字符串）、
statusCode
（HTTP状态码）。

Metrics

指标管理

ToolPurpose
get_metrics(resourceId, metricTypes, ...)
Get service or database metrics
Metric types: 
cpu_usage
, 
memory_usage
, 
cpu_limit
, 
memory_limit
, 
http_latency
, 
http_request_count
, 
active_connections
.
Optional: 
httpLatencyQuantile
(0.5, 0.95, 0.99), 
httpPath
(filter by endpoint).
工具用途
get_metrics(resourceId, metricTypes, ...)
获取服务或数据库指标
指标类型：
cpu_usage
、
memory_usage
、
cpu_limit
、
memory_limit
、
http_latency
、
http_request_count
、
active_connections
。
可选参数：
httpLatencyQuantile
（0.5、0.95、0.99）、
httpPath
（按端点筛选）。

Databases

数据库管理

ToolPurpose
list_postgres_instances()
List Postgres databases
get_postgres(postgresId)
Get database details
query_render_postgres(postgresId, sql)
Run SQL query
工具用途
list_postgres_instances()
列出Postgres数据库实例
get_postgres(postgresId)
获取数据库详情
query_render_postgres(postgresId, sql)
执行SQL查询

Key Value

键值存储管理

ToolPurpose
list_key_value()
List Key Value instances
get_key_value(keyValueId)
Get Key Value details
工具用途
list_key_value()
列出键值存储实例
get_key_value(keyValueId)
获取键值存储详情

Environment Variables

环境变量管理

ToolPurpose
update_environment_variables(serviceId, envVars)
Set env vars on a service
工具用途
update_environment_variables(serviceId, envVars)
为服务设置环境变量

Workspace

工作区管理

ToolPurpose
list_workspaces()
List available workspaces
get_selected_workspace()
Get the active workspace
工具用途
list_workspaces()
列出可用工作区
get_selected_workspace()
获取当前活跃工作区

Common Mistakes

常见错误

MistakeFix
Wrong URL (using SSE endpoint)Use 
https://mcp.render.com/mcp
(not 
/sse
)
Plugin installed but MCP tools unavailableReload the tool (restart, or start a new thread) so it loads the plugin's MCP server
OAuth prompt does not appearReinstall or update the Render plugin, then reload the tool
Expired or invalid API keyGenerate a new key from Dashboard > Account Settings > API Keys
Wrong workspace selectedRun 
list_workspaces()
and switch to the correct one
Using MCP to create image-backed servicesNot supported — use Dashboard or API for prebuilt Docker images
Missing 
Bearer
prefix in auth header		Header must be 
Authorization: Bearer <key>
错误修复方案
URL错误（使用SSE端点）使用
https://mcp.render.com/mcp
（而非
/sse
）
已安装插件但MCP工具不可用重新加载工具（重启或开启新线程）以加载插件提供的MCP服务器
OAuth授权提示未出现重新安装或更新Render插件，然后重新加载工具
API密钥过期或无效从控制台 > 账户设置 > API密钥生成新密钥
选中了错误的工作区运行
list_workspaces()
并切换至正确工作区
使用MCP创建镜像驱动的服务暂不支持——请使用控制台或API处理预构建Docker镜像
认证头缺少
Bearer
前缀		头信息必须为
Authorization: Bearer <key>

Troubleshooting

故障排查

See 
references/troubleshooting.md
for connection errors, auth failures, timeout issues, and tool-specific quirks.
连接错误、认证失败、超时问题及工具特定异常请查看
references/troubleshooting.md
。

References

参考文档

DocumentContents
references/troubleshooting.md
Connection errors, auth failures, tool-specific issues, timeout handling
文档内容
references/troubleshooting.md
连接错误、认证失败、工具特定问题、超时处理

Related Skills

相关技能

  • render-deploy — Deploy flows using MCP tools
  • render-debug — Debug failures using MCP logs and metrics
  • render-monitor — Monitor health using MCP metrics
  • render-cli — CLI alternative when MCP is unavailable
  • render-deploy — 使用MCP工具完成部署流程
  • render-debug — 使用MCP日志与指标排查故障
  • render-monitor — 使用MCP指标监控服务健康状态
  • render-cli — MCP不可用时的CLI替代方案