mcpField
R
render-mcp

render-mcp

github.com/render-oss云与 DevOps90463 次安装今天更新
代码仓库

关于 render-mcp

为使用 Render 的 AI 编码工具提供 MCP 连接、认证、工作区选择和故障排查指引。内容涵盖客户端配置与能力发现，建议依据当前文档核实可用工具。

主要功能

  1. 01配置 Render MCP 连接
  2. 02处理认证与工作区选择
  3. 03发现当前可用工具
  4. 04排查连接与调用问题

适用场景

  1. 01首次将 AI 工具连接到 Render
  2. 02切换工作区或排查认证错误
  3. 03服务列表为空或工具不可用时排障

MCP 相关

指导客户端连接托管的 Render MCP 服务，配置认证并选择工作区；还说明如何发现当前可用能力。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/render-oss/skills --skill render-mcp

安装后在 Claude Code 中输入/render-mcp确认已加载。

附带文件references/render-access.mdreferences/troubleshooting.md

详细介绍

Render MCP 服务

Render MCP 服务可让 AI 编码工具直接管理 Render 资源。本技能涵盖设置、身份验证、工作区选择、功能发现和故障排除。

操作技能（render-deploy、render-debug、render-monitor）会在其工作流中使用 MCP 工具。如果 MCP 未连接，请先使用本技能进行设置。

在配置、排查或使用 Render MCP 之前，请阅读 references/render-access.md，了解当前的服务、身份验证、工作区、功能发现和回退工作流。

适用场景

  • list_services() 失败或 MCP 工具不可用
  • 首次为任何 AI 工具设置 Render MCP
  • 用户询问如何将其 AI 工具连接到 Render
  • 切换工作区或排查身份验证错误
  • 发现现有哪些 MCP 工具及其用途

当前设置和功能

按照 references/render-access.md 获取当前 MCP 文档、配置客户端、验证只读访问权限、选择目标工作区，并检查实际可用的工具。不要依赖记忆中的工具目录。

如果用户尚未说明使用哪种 AI 工具，请先询问，然后再提供针对特定客户端的设置说明。优先使用官方 Render 插件或连接器及其基于浏览器的 OAuth 流程（如果可用）。如需手动设置 API 密钥，请在 https://dashboard.render.com/u/settings#api-keys 创建密钥，并使用托管端点 https://mcp.render.com/mcp。

手动配置客户端

对于 Cursor，将以下配置添加到 ~/.cursor/mcp.json，重启 Cursor，并通过 list_services() 验证连接：

{
  "mcpServers": {
    "render": {
      "url": "https://mcp.render.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

对于 Claude Code，使用以下命令添加服务：

claude mcp add --transport http render https://mcp.render.com/mcp --header "Authorization: Bearer <YOUR_API_KEY>"

重启 Claude Code，并通过 list_services() 验证。要替换过时的手动配置，请在重新添加之前运行 claude mcp remove render。

对于 Codex，请按照通过 references/render-access.md 获取的当前 OAuth 或 API 密钥配置操作。如果配置从 RENDER_API_KEY 获取持有者令牌，则该变量必须在启动 Codex 的环境中可用；更改后请重启 Codex。

结果为空和工作区选择

MCP 操作会针对当前活动工作区运行。如果 list_services() 成功连接但未返回任何服务，请先调用 get_selected_workspace()；如果可能选错了工作区，再调用 list_workspaces()。同时，请确认凭据或 RENDER_API_KEY 所属的账户有权访问目标工作区。如果 MCP 调用本身成功，不要优先将服务 URL 判断为问题所在。

故障排除

有关连接错误、身份验证失败、超时问题和特定工具的注意事项，请参阅 references/troubleshooting.md。

参考资料

文档内容
references/render-access.md当前 MCP 和 CLI 访问、身份验证、工作区、功能发现及授权工作流
references/troubleshooting.md连接错误、身份验证失败、特定工具问题、超时处理

相关技能

  • render-deploy — 使用 MCP 工具的部署流程
  • render-debug — 使用 MCP 日志和指标排查故障
  • render-monitor — 使用 MCP 指标监控运行状况
  • render-cli — MCP 不可用时的 CLI 替代方案

当前文档检索

每当此技能指示你查阅 Render 的当前文档时：

  1. 使用可用的 URL 获取工具或 HTTP 客户端（例如 curl）直接获取链接的 Markdown 文档。不要用网页搜索摘要代替文档。
  2. 确认获取成功且返回的是预期文档，然后阅读其内容。仅保存文件或输出其路径并不足够。
  3. 如果请求失败，或你的工具无法读取 Markdown 响应，则打开并阅读链接的 HTML 版本。
  4. 如果两个版本都无法获取，请说明当前参考资料不可用，并遵循技能中针对该主题的备用方案。仅将随附指南用于稳定的限制条件，不要猜测可能变动的平台详情。

如果任务需要多个参考资料，请对每份资料都执行此流程，并区分已验证的文档与仍不可用的文档。

评论

支持 Markdown