開発者向けリソース

ローカルMCP

RunAPI MCP ServerをClaude Code、Cursor、VS Code、Windsurf、または別のstdioクライアントでローカルに実行します。

ローカルMCPを使用すると、MCPクライアントがお使いのマシン上でRunAPI MCPサーバーを起動できます。クライアントがRemote MCPをサポートしていない場合、またはローカルプロセスが明示的に必要な場合に使用してください。

開始前に

Node.js をインストールして npx が利用可能であることを確認してください。MCP クライアントはローカル stdio サーバーをサポートしている必要があります。

以下のすべてのクライアントは同じコマンドを開始します：

SHELL

npx -y @runapi.ai/mcp

サインインせずにカタログツールを接続して使用できます。

実行：

SHELL

claude mcp add runapi -s user -- npx -y @runapi.ai/mcp

プロジェクト全体でRunAPIを利用できるようにするには、-s user を使用してください。 Claude Codeがすでに起動している場合は再起動し、RunAPIがMCPサーバーとして一覧に表示されていることを確認してください。

.cursor/mcp.json またはユーザーの MCP 設定の mcpServers にサーバーを追加します：

JSON

{
  "mcpServers": {
    "runapi": {
      "command": "npx",
      "args": ["-y", "@runapi.ai/mcp"]
    }
  }
}

CursorサイドバーでOpen Customizeを開き、RunAPIを見つけて有効にしてください。プロセスが起動しない場合は、Outputパネルを開いてMCP Logsを選択してください。

コマンドパレットを開き、MCP: サーバーを追加を実行します。
コマンド（stdio）を選択し、npx -y @runapi.ai/mcp と入力します。
サーバーに RunAPI という名前を付け、設定スコープを選択して起動します。
プロンプトが表示されたらサーバーを信頼します。エラーが発生した場合は MCP: サーバー一覧を実行し、RunAPI を選択して出力を表示を選択します。

VS Code は手動設定をトップレベルの servers キーに保存し、type: "stdio" を使用します。

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

RunAPI という名前のローカル stdio サーバーを追加します。コマンドを npx、引数を -y と @runapi.ai/mcp に設定します。設定を保存した後、クライアントを再起動または更新します。

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

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

クライアントはlist_modelsを呼び出し、利用可能な画像モデルを返す必要があります。このパブリック検出ツールは認証を必要としません。

サインインせずにディスカバリーツールを引き続き使用してください。RunAPI にタスクの作成、タスクの取得、または残高の確認を初めて依頼するときは、クライアントに login ツールを呼び出させてください。ブラウザで RunAPI が開き、共有ローカル設定に認証情報が保存されます。

ターミナルからサインインする場合は、RunAPI CLIをインストールして次を実行してください:

SHELL

runapi login

ヘッドレスまたはCIクライアントの場合は、認証ガイドに従って専用の標準APIキーを作成し、クライアントの環境またはシークレット設定でRUNAPI_API_KEYとして提供してください。環境キーはLocal MCPログインによって保存された認証情報より優先されます。

npx が見つからない場合：node --version と npx --version が動作することを確認し、MCPクライアントを完全に再起動して更新された環境を受け取れるようにしてください。
ローカルサーバーがすぐに終了する場合：ターミナルで npx -y @runapi.ai/mcp を実行し、報告されたNode.jsまたはパッケージのエラーを修正してから、クライアントを再起動してください。
RunAPIのツールが表示されない場合：サーバーが有効になっていること、コマンドがstdioを使用していることを確認し、上記のクライアントログを確認してください。
認証済みツールが失敗する場合：クライアントに login ツールを呼び出すよう依頼してください。RUNAPI_API_KEY が設定されている場合は、Local MCP Loginを再試行する前に更新または削除してください。

ローカルの Node.js プロセスを使わない接続を希望しますか？Hosted MCP のセットアップをご覧ください。