render-mcp

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 をセットアップする
• Render に AI ツールを接続する方法をユーザーが尋ねている
• ワークスペースを切り替える、または認証エラーをトラブルシューティングする
• 利用可能な 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 取得ツールまたは curl などの HTTP クライアントを使って、リンク先の Markdown ドキュメントを直接取得します。ウェブ検索の要約でドキュメントを代用しないでください。
2. 取得が成功し、期待したドキュメントが返されたことを確認してから、内容を読みます。ファイルを保存したり、そのパスを表示したりするだけでは不十分です。
3. リクエストに失敗した場合、またはツールで Markdown のレスポンスを読み取れない場合は、リンク先の HTML 版を開いて読みます。
4. どちらの形式も取得できない場合は、最新の参照資料を利用できないことを明示し、スキル内のトピック固有の代替手順に従います。同梱のガイダンスは、変わらない制約に限って使用し、変更される可能性のあるプラットフォームの詳細を推測しないでください。

複数の参照資料が必要な場合は、それぞれにこの手順を適用し、確認できたドキュメントと、取得できなかったドキュメントを区別してください。