開発者向けリソース

ホスト型 MCP

OAuth を使用して、Claude Desktop、Cursor、VS Code、Windsurf、またはその他のMCPクライアントをRunAPIに接続します。

Hosted MCP は RunAPI ツールを使用するための推奨方法です。MCP クライアントは RunAPI に直接接続するため、Node.js をインストールしたりローカルプロセスを起動し続けたりする必要はありません。

このエンドポイントを使用します:

TEXT

https://mcp.runapi.ai/mcp

以下からMCPクライアントを選択してください。クライアントがブラウザでRunAPIを開いたら、サインインし、使用するアカウントを選択してアクセスを承認してください。

Claude Desktop

RunAPI が会話に表示されない場合は、Settings > Connectors に戻り、再接続してその会話で有効になっていることを確認してください。

Cursor の mcp.json（プロジェクトレベルの .cursor/mcp.json など）に RunAPI を追加します：

JSON

{
  "mcpServers": {
    "runapi": {
      "url": "https://mcp.runapi.ai/mcp"
    }
  }
}

CursorサイドバーでOpen Customizeを開き、RunAPIを見つけて有効にし、ブラウザで認証を完了してください。

RunAPIは接続済みと表示され、そのツールを公開するはずです。接続エラーまたは認証エラーが発生した場合は、出力パネルを開き、MCPログを選択してください。

RunAPIのツールがチャットに表示されるはずです。エラーが発生した場合は、MCP: List Serversを実行し、RunAPIを選択してShow Outputを選択してください。

これらの手順はCascadeエージェントに適用されます。Devin LocalはDevin CLI設定を使用します。

Devin 設定 > Cascade > MCP サーバーを開き、生の ~/.codeium/windsurf/mcp_config.json ファイルを編集します。
RunAPI をリモート HTTP サーバーとして追加します：

JSON

{
  "mcpServers": {
    "runapi": {
      "serverUrl": "https://mcp.runapi.ai/mcp"
    }
  }
}

ツールが表示されない場合は、MCP 設定を開き、RunAPI が有効になっていることを確認して再接続してください。

上記のエンドポイントを Streamable HTTP サーバーとして追加します。クライアントはリモート MCP とブラウザベースの OAuth をサポートしている必要があります。プロンプトが表示されたら認証を完了し、クライアントで RunAPI ツールを有効にします。

クライアントに確認します：

RunAPI で利用可能な画像モデルは何ですか？

クライアントはlist_modelsを呼び出し、利用可能な画像モデルを返す必要があります。これにより接続とツールのディスパッチが機能していることが確認されます。

OAuthが推奨される方法です。無人クライアントまたはOAuthが利用できない場合にのみ専用の標準APIキーを使用してください。キーの作成は認証ガイドに従ってください。エンドポイントURLにキーを含めたり、リポジトリにコミットしたりしないでください。

Claude Desktop: カスタムコネクターでリクエストヘッダーが利用可能な場合、値 Bearer YOUR_API_KEY を持つ Authorization ヘッダーを追加してください。
Cursor: Cursor アプリケーションから参照できる環境に RUNAPI_API_KEY を設定し、サーバーの headers に Authorization: Bearer ${env:RUNAPI_API_KEY} を使用してください。リモートサーバーは Cursor の envFile 設定を読み込みません。
VS Code: サーバーの Authorization ヘッダーからパスワード型の ${input:...} を参照することで、VS Code がキーを mcp.json に書き込む代わりにプロンプトを表示してキーを保存します。
Windsurf: ~/.codeium/windsurf/mcp_config.json の Authorization ヘッダーから ${env:RUNAPI_API_KEY} または ${file:...} を参照してください。

クライアントが廃止されたとき、またはキーが漏洩した可能性がある場合は、APIキーページからキーを失効させてください。

認証が完了しなかった場合：クライアントからRunAPIを再接続し、ブラウザフローを再度完了させてください。
RunAPIは接続されているがツールが表示されない場合：サーバーが有効になっていることを確認し、該当エンドポイントを削除して再追加し、新しい会話を開始してください。
検証用の質問が失敗する場合：上記のセクションに記載されているクライアントログを確認し、再試行前にRunAPIを再接続してください。

代わりにクライアントでマシン上のRunAPIを起動させたいですか？ローカルMCPをセットアップしてください。