RockAPI MCP：1 つのキーで AI エージェントを 50 以上のモデルに接続

RockAPI は Model Context Protocol（MCP） に対応しました。エージェントフレームワークごとに接続コードを書く必要はありません。クライアントに MCP サーバーを 1 つ追加すれば、既存の API キーでエージェントから RockAPI を呼び出せます。本記事では、MCP が実際に何を変えるのか、個別に設定する 2 つのレイヤー、そして接続と検証の手順を説明します。

RockAPI MCP の構成図 AI エージェントが MCP クライアント経由で RockAPI MCP サーバーに接続し OpenAI Claude Gemini のモデルを利用する流れ

MCP が変えるもの

MCP は、AI クライアントがサーバー上のツールを検出して呼び出すための標準規格です。MCP 以前は、フレームワークごとに独自のプラグイン形式があり、同じ機能を Claude Code、Cursor、Codex それぞれに実装し直す必要がありました。

MCP なし	MCP あり
クライアントごと、プロバイダーごとに個別の実装が必要	1 つのサーバー定義を任意の MCP クライアントが読み込める
ツールのスキーマをプロンプトへ手作業で転記	実行時に `tools/list` で自動検出
認証ロジックを実装ごとに繰り返す	エンドポイント 1 つ、Bearer キー 1 つ
モデルとツールが同じ設定で密結合	モデル選択とツール権限を分離して設定

実務上の利点は明確です。エージェント側の機能面が安定し、並行して維持する実装が不要になります。

個別に設定する 2 つのレイヤー

ここが最も混同しやすい点なので、作業前に切り分けてください。

レイヤー	何を決めるか	設定する場所
モデルレイヤー	どの LLM が推論と生成を担うか	クライアントのモデル／プロバイダー設定
ツールレイヤー	エージェントがどのツールとデータに到達できるか	クライアントの MCP サーバー項目

RockAPI を MCP サーバーとして追加する場合、それはツールレイヤーです。OpenAI 互換 API 経由でモデルプロバイダーとして使う場合、それはモデルレイヤーです。併用は可能ですが、設定項目は別々です。

事前準備

API キーを作成する。 rockapi.ai/keys で発行し、環境変数に格納します。リポジトリにコミットするファイルへは書き込まないでください。
MCP 設定をコピーする。 コンソールの MCP ページに、アカウントの MCP エンドポイントとヘッダー形式が表示されます。記憶ではなく表示された値を使用してください。
クライアントの MCP 対応を確認する。 Claude Code、Cursor、Codex、VS Code、Claude Desktop はいずれも対応しています。下記コマンドが拒否される場合はバージョンを確認してください。
モデルを決める。 どのクライアントでもエージェントには LLM が必要です。プロバイダー設定で選択するか、RockAPI 経由で呼び出します。

export ROCKAPI_API_KEY="sk-your-key"
export ROCKAPI_MCP_URL="<コンソールの MCP ページに表示されるエンドポイント>"

MCP サーバーを追加する

コマンドはクライアントごとに異なりますが、入力は共通です。URL、トランスポート、そして Authorization: Bearer ヘッダーです。

Claude Code

claude mcp add --transport http rockapi "$ROCKAPI_MCP_URL" \
  --header "Authorization: Bearer $ROCKAPI_API_KEY"

登録を確認します。

claude mcp list

Codex

~/.codex/config.toml にサーバーを追加します。トークンを環境変数から読むことで、秘匿情報をファイルに残しません。

[mcp_servers.rockapi]
url = "https://your-mcp-endpoint-from-console"
bearer_token_env_var = "ROCKAPI_API_KEY"

Cursor と VS Code

どちらも JSON 設定で HTTP タイプの MCP サーバーを受け付けます。キーを平文で保存しないよう、クライアントが定める環境変数展開の記法を使用してください。

{
  "mcpServers": {
    "rockapi": {
      "type": "http",
      "url": "${env:ROCKAPI_MCP_URL}",
      "headers": {
        "Authorization": "Bearer ${env:ROCKAPI_API_KEY}"
      }
    }
  }
}

Claude Desktop

Claude Desktop はコマンド起動型のサーバーを扱うため、mcp-remote でブリッジします。

{
  "mcpServers": {
    "rockapi": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://your-mcp-endpoint-from-console",
        "--header",
        "Authorization: Bearer ${ROCKAPI_API_KEY}"
      ]
    }
  }
}

接続を検証する

「接続済み」と表示されても本番投入の判断には不十分です。次の 4 点を確認してください。

確認項目	実行方法	正常な状態
サーバーが登録済み	`claude mcp list` またはクライアントの MCP パネル	エラーではなく接続済みと表示される
ツールが検出できる	エージェントに利用可能なツールの一覧を求める	401 にならず、空でない一覧が返る
呼び出しが成功する	読み取り専用の操作を 1 つ実行させる	タイムアウトではなく構造化された結果が返る
エラーが判別できる	一時的に誤ったキーを使う	無言の空応答ではなく明確な認証エラーになる

接続できるのに呼び出しが失敗する場合、原因は通常トランスポートではなくトークンです。他の調査より先にキーをローテーションして再試行してください。

事故を防ぐ運用ルール

キーの範囲を限定する。 MCP 連携には専用キーを使い、本番用のメインキーを流用しないでください。片方を失効させても他方に影響しません。
まず読み取り専用で始める。 タスク完了に必要な最小の権限だけを与え、実際のワークフローで必要になった段階で広げます。
費用を分けて監視する。 ツール駆動型のエージェントは小さな呼び出しを大量に発行します。キーを分ければエージェント単位のコストがダッシュボードで判別できます。
秘匿情報は環境変数に置く。 コミット対象の設定ファイルへキーを貼り付けるのは、エージェント設定で最も多い漏えい経路です。API キーの安全な管理を参照してください。
ツール呼び出しを記録する。 挙動がおかしいときは、最終的な回答よりも呼び出しの並びのほうが原因を早く示します。

FAQ

MCP は OpenAI 互換 API と同じものですか？

いいえ。OpenAI 互換 API はコードからモデルを呼ぶ方法を標準化します。MCP は AI クライアントがツールを検出して呼ぶ方法を標準化します。RockAPI は両方を提供しており、設定する場所も異なります。

MCP でも API キーは必要ですか？

必要です。MCP サーバーに到達できても、アカウントの識別、レート制限の適用、利用量の記録はキーによって行われます。

1 つの MCP サーバーを複数のエージェントで使えますか？

使えます。それが利点です。同じサーバー定義を複数クライアントで共有でき、Claude Code と Cursor が同じキーで同じ機能群に到達します。

MCP でモデルの課金方法は変わりますか？

変わりません。課金は実際のモデル呼び出しに従います。集計方法は料金と請求を参照してください。

クライアントが HTTP タイプの MCP サーバーに未対応の場合は？

Claude Desktop の例にある mcp-remote ブリッジを使用してください。HTTP エンドポイントをローカルの stdio プロセスに変換するため、コマンド起動型のクライアントから利用できます。

次のステップ

まだリクエストを送っていない場合はクイックスタートから始め、続いてモデルとプロバイダーでエージェントの背後に置くモデルを選んでください。

API キーを作成してエージェントを接続

キーを発行し、コンソールから MCP 設定をコピーして、本番トラフィックの前に接続を検証してください。

概要

購入者向け

販売者向け

RockAPI MCP：1 つのキーで AI エージェントを 50 以上のモデルに接続

MCP が変えるもの

個別に設定する 2 つのレイヤー

事前準備

MCP サーバーを追加する

Claude Code

Codex

Cursor と VS Code

Claude Desktop

接続を検証する

事故を防ぐ運用ルール

FAQ

MCP は OpenAI 互換 API と同じものですか？

MCP でも API キーは必要ですか？

1 つの MCP サーバーを複数のエージェントで使えますか？

MCP でモデルの課金方法は変わりますか？

クライアントが HTTP タイプの MCP サーバーに未対応の場合は？

次のステップ

API キーを作成してエージェントを接続

​MCP が変えるもの

​個別に設定する 2 つのレイヤー

​事前準備

​MCP サーバーを追加する

​Claude Code

​Codex

​Cursor と VS Code

​Claude Desktop

​接続を検証する

​事故を防ぐ運用ルール

​FAQ

​MCP は OpenAI 互換 API と同じものですか？

​MCP でも API キーは必要ですか？

​1 つの MCP サーバーを複数のエージェントで使えますか？

​MCP でモデルの課金方法は変わりますか？

​クライアントが HTTP タイプの MCP サーバーに未対応の場合は？

​次のステップ

API キーを作成してエージェントを接続

MCP が変えるもの

個別に設定する 2 つのレイヤー

事前準備

MCP サーバーを追加する

Claude Code

Codex

Cursor と VS Code

Claude Desktop

接続を検証する

事故を防ぐ運用ルール

FAQ

MCP は OpenAI 互換 API と同じものですか？

MCP でも API キーは必要ですか？

1 つの MCP サーバーを複数のエージェントで使えますか？

MCP でモデルの課金方法は変わりますか？

クライアントが HTTP タイプの MCP サーバーに未対応の場合は？

次のステップ