> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rockapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

> RockAPI が Model Context Protocol に対応しました。MCP が AI エージェントにもたらす変化、Claude Code・Cursor・Codex・Claude Desktop への RockAPI MCP サーバーの追加手順、接続確認の方法を解説します。

RockAPI は **Model Context Protocol（MCP）** に対応しました。エージェントフレームワークごとに接続コードを書く必要はありません。クライアントに MCP サーバーを 1 つ追加すれば、既存の API キーでエージェントから RockAPI を呼び出せます。

本記事では、MCP が実際に何を変えるのか、個別に設定する 2 つのレイヤー、そして接続と検証の手順を説明します。

![RockAPI MCP の構成図 AI エージェントが MCP クライアント経由で RockAPI MCP サーバーに接続し OpenAI Claude Gemini のモデルを利用する流れ](https://mintcdn.com/rockapi/H_B3LeAF53GjlC9D/images/blog/rockapi-mcp-architecture.svg?fit=max\&auto=format\&n=H_B3LeAF53GjlC9D\&q=85\&s=e510582e3dffb537393cef696ce25283)

## MCP が変えるもの

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

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

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

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

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

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

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

## 事前準備

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

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

## MCP サーバーを追加する

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

### Claude Code

```bash theme={null}
claude mcp add --transport http rockapi "$ROCKAPI_MCP_URL" \
  --header "Authorization: Bearer $ROCKAPI_API_KEY"
```

登録を確認します。

```bash theme={null}
claude mcp list
```

### Codex

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

```toml theme={null}
[mcp_servers.rockapi]
url = "https://your-mcp-endpoint-from-console"
bearer_token_env_var = "ROCKAPI_API_KEY"
```

### Cursor と VS Code

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

```json theme={null}
{
  "mcpServers": {
    "rockapi": {
      "type": "http",
      "url": "${env:ROCKAPI_MCP_URL}",
      "headers": {
        "Authorization": "Bearer ${env:ROCKAPI_API_KEY}"
      }
    }
  }
}
```

### Claude Desktop

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

```json theme={null}
{
  "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 キーの安全な管理](https://docs.rockapi.ai/ja/blog/buyers/secure-api-key-management.md)を参照してください。
* **ツール呼び出しを記録する。** 挙動がおかしいときは、最終的な回答よりも呼び出しの並びのほうが原因を早く示します。

## FAQ

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

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

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

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

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

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

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

変わりません。課金は実際のモデル呼び出しに従います。集計方法は[料金と請求](https://docs.rockapi.ai/ja/pricing-and-billing.md)を参照してください。

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

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

## 次のステップ

まだリクエストを送っていない場合は[クイックスタート](https://docs.rockapi.ai/ja/quickstart.md)から始め、続いて[モデルとプロバイダー](https://docs.rockapi.ai/ja/models-and-providers.md)でエージェントの背後に置くモデルを選んでください。

> [card] [API キーを作成してエージェントを接続](https://rockapi.ai/sign-up?utm_source=docs\&utm_medium=referral\&utm_campaign=blog_buyers_mcp_ja)
>
> キーを発行し、コンソールから MCP 設定をコピーして、本番トラフィックの前に接続を検証してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.