ZRouter について
ZRouter MCPは、AIアシスタントからZRouterアカウントの利用状況、ログ、モデルルーター、APIキー、予算、制限を管理するホスト型サーバーです。認証済みアカウント内の操作に限定され、アシスタントのモデルプロバイダーは変更しません。
主な機能
- 01利用状況・費用・リクエストログの確認
- 02仮想モデルルーターの作成と管理
- 03APIキーの作成と削除
- 04支出予算とレート制限の設定
活用シーン
- 01モデル別の週間支出の確認
- 02失敗したリクエストとエラーの調査
- 03アプリケーション用モデルルーターの作成
- 04ステージング環境の支出やリクエスト頻度の制限
MCP 対応
Streamable HTTP経由で24個のアカウント管理ツールを提供する、ホスト型のリモートMCPサーバーです。クライアントはOAuth 2.1またはBearerトークンで認証します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://zrouter.si/mcpclaude mcp add --transport http nexusrun-zrouter https://zrouter.si/mcp{"mcpServers":{"nexusrun-zrouter":{"type":"http","url":"https://zrouter.si/mcp"}}}Cursor で開く{"servers":{"nexusrun-zrouter":{"type":"http","url":"https://zrouter.si/mcp"}}}VS Code で開く{"mcpServers":{"nexusrun-zrouter":{"type":"http","url":"https://zrouter.si/mcp"}}}{"mcpServers":{"nexusrun-zrouter":{"serverUrl":"https://zrouter.si/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
詳細

ZRouter MCP サーバー
あらゆる AI アシスタントからZRouterアカウントを管理できます。利用額の確認、リクエストログの検索、仮想モデルルーターの作成、API キーの発行、予算やレート制限の設定を、普段の言葉で行えます。
https://zrouter.si/mcp
ZRouter は Super Intelligence Router です。チャット、画像、音声、動画に対応する OpenAI 互換の API キーを 1 つ使い、適切なモデルとプロバイダーにルーティングします。この MCP サーバーはアカウント管理用です。ホスト型のリモートサーバーとして動作するため、インストールは不要です。
- トランスポート: Streamable HTTP
- サインイン: PKCE と動的クライアント登録を使用する OAuth 2.1、またはベアラートークン
- スコープ: ダッシュボードと同じルールが適用される、ご自身のアカウントのみ
- ツール: 24 個(読み取り専用 14 個、書き込み 4 個、破壊的操作としてマークされたもの 6 個)
目次
クイックスタート
- zrouter.siで無料アカウントを作成します。
- クライアントで
https://zrouter.si/mcpをリモート MCP サーバーとして追加します。 - 開いた ZRouter のページでアクセスを許可します。
- 「今週の利用額をモデル別に教えて」と質問します。
MCP サインインに対応したクライアントでは、URL を指定するだけで利用できます。コピーや更新が必要なトークンはありません。
クライアントを接続する
Claude(claude.ai と Claude Desktop)
設定 → コネクター → カスタムコネクターを追加を選択します。https://zrouter.si/mcp を貼り付けて、接続を選択し、アクセスを許可します。
ChatGPT
設定 → アプリとコネクターで、URL https://zrouter.si/mcp とOAuth認証を使ってコネクターを作成します。プランによっては、カスタムコネクターに開発者モードが必要な場合があります。
Claude Code
claude mcp add --transport http zrouter https://zrouter.si/mcp
その後、Claude Code 内で /mcp を実行し、認証を選択します。
Cursor
このリポジトリは Cursor プラグイン(.cursor-plugin/plugin.json)としても利用できます。または、サーバーを ~/.cursor/mcp.json に追加します。
{
"mcpServers": {
"zrouter": {
"url": "https://zrouter.si/mcp"
}
}
}
VS Code
サーバーを .vscode/mcp.json またはユーザー設定に追加します。
{
"servers": {
"zrouter": {
"type": "http",
"url": "https://zrouter.si/mcp"
}
}
}
その他のクライアント
URL https://zrouter.si/mcp と Streamable HTTP トランスポートを使って、リモート MCP サーバーを追加します。クライアントから確認されたら、OAuth サインインを選択します。
クライアントの設定形式はバージョンによって異なります。上記の設定例がクライアントに合わない場合は、クライアント独自の MCP ドキュメントに従い、同じ URL を使用してください。
サインインの代わりにトークンを使う
スクリプトや MCP サインインに対応していないクライアントでは、MCP トークンを使用します。
- ZRouter ダッシュボードでCLI と MCP アクセスを開きます。
- クライアント名を付けて、MCP トークンを作成を選択します。
- すぐにコピーしてください。トークンは一度だけ表示され、有効期限は 30 日です。
ベアラートークンとして送信します。
claude mcp add --transport http zrouter https://zrouter.si/mcp \
--header "Authorization: Bearer YOUR_MCP_TOKEN"
{
"mcpServers": {
"zrouter": {
"url": "https://zrouter.si/mcp",
"headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
}
}
}
アカウント API キーではなく、MCP トークンを使用してください。API キーはモデルへのリクエストのみを送信でき、アカウントを管理できません。そのため、API キーが漏えいしても、キーの作成や予算の変更はできません。MCP トークンを共有リポジトリの設定に含めないでください。使わなくなったトークンは、同じダッシュボードのページから取り消してください。
質問できること
- 「今週の支出をモデル別に教えて」
- 「今日、429 で失敗したリクエストを表示して」
- 「最後にサポートボットへ送ったリクエストが失敗した理由は?」
- 「2 つのモデルにトラフィックを振り分ける、support-bot というルーターを作成して」
- 「簡単なプロンプトは安価なモデルに、難しいプロンプトは最も高性能なモデルに振り分けて」
- 「ステージング用の API キーを作成して、1 日あたりの支出上限を 10 ドルに設定して」
- 「ステージングのユーザーパスを、1 分あたり 60 リクエストに制限して」
このサーバーに接続しても、アシスタント自体のモデルプロバイダーは変更されません。ZRouter 経由でモデルリクエストを送信するには、連携ガイドのいずれかに従って API キーを設定してください。
ツール
すべてのツールは、認証済みアカウント内で実行されます。読み取り専用のツールには readOnlyHint の注釈が付いています。削除とリセットには destructiveHint の注釈が付いているため、リスクのある操作を確認するクライアントでは、実行前に確認を求められます。
アカウント
| ツール | 機能 | 種類 |
|---|---|---|
account_info | サインイン中のアカウントとクレジット残高 | 読み取り専用 |
credit_ledger | クレジットの購入と請求 | 読み取り専用 |
使用状況
| ツール | 機能 | 種類 |
|---|---|---|
usage_summary | 指定期間のリクエスト数、トークン数、費用の合計 | 読み取り専用 |
usage_daily | 日、週、月ごとの使用状況と費用の推移 | 読み取り専用 |
usage_by_model | モデル別の使用状況と費用 | 読み取り専用 |
usage_log | トークン数と費用を含むリクエストごとの記録 | 読み取り専用 |
使用状況ツールでは、days(デフォルトは 30)、start_date と end_date(YYYY-MM-DD)、user_path、model、provider を指定できます。
ログ
| ツール | 機能 | 種類 |
|---|---|---|
logs_search | ステータスコード、エラーの種類、テキストでリクエストログを検索 | 読み取り専用 |
logs_get | 1 件のログエントリの詳細(logs_search の log_id) | 読み取り専用 |
logs_stats | リクエスト数、エラー率、レイテンシ | 読み取り専用 |
モデルとルーター
| ツール | 機能 | 種類 |
|---|---|---|
models_list | このアカウントで利用できるモデル | 読み取り専用 |
virtual_models_list | ルーター、ルーティング戦略、モデル名のプレフィックス | 読み取り専用 |
virtual_models_upsert | 最大 32 個のターゲット、重み、round_robin や super_intelligence などの戦略を指定してルーターを作成または更新 | 書き込み |
virtual_models_delete | ルーターを削除 | 破壊的操作 |
ルーターは、アプリから呼び出す固定のモデル名です。super_intelligence 戦略では、各リクエストの難易度を判定し、simple_targets、standard_targets、complex_targets のいずれかに送信します。
API キー
| ツール | 機能 | 種類 |
|---|---|---|
api_keys_list | キーの一覧。シークレットは返されません。 | 読み取り専用 |
api_keys_create | キーを作成。シークレットは一度だけ返されます。 | 書き込み |
api_keys_delete | キーを削除。そのキーを使ったリクエストは直ちに機能しなくなります。 | 破壊的操作 |
予算
| ツール | 機能 | 種類 |
|---|---|---|
budgets_list | 現在の支出を含む予算 | 読み取り専用 |
budgets_upsert | 米ドル建ての支出上限を作成または更新(1 時間、1 日、1 週間、または 1 か月単位) | 書き込み |
budgets_delete | 予算を削除 | 破壊的操作 |
budgets_reset | 1 件の予算の現在の支出をゼロにリセット | 破壊的操作 |
レート制限
| ツール | 機能 | 種類 |
|---|---|---|
rate_limits_list | 現在のカウンターを含むレート制限 | 読み取り専用 |
rate_limits_upsert | 1 分、1 時間、または 1 日あたりのリクエスト数またはトークン数の上限を作成または更新 | 書き込み |
rate_limits_delete | レート制限を削除 | 破壊的操作 |
rate_limits_reset | 1 件のレート制限のカウンターをリセット | 破壊的操作 |
予算は user_path または label に適用されます。レート制限は user_path、provider、または model に適用されます。per_child を設定すると、各子ユーザーパスに個別にルールが適用されます。
セキュリティ
- ご自身のアカウントのみ。 各ツール呼び出しは、ダッシュボードと同じ顧客向け API を、ご自身の認証情報を使って経由するため、認証、アカウントのスコープ設定、検証はすべて同一です。
- 認証情報は別個です。 MCP へのアクセスには OAuth トークンまたは MCP トークンを使用します。アカウント API キーではアカウントを管理できません。
- 取り消し可能です。 CLI and MCP access → Connected apps でアプリの接続を解除し、同じページで MCP トークンを取り消せます。
- 結果サイズに上限があります。 1 回のツール結果は 256 KB に制限されるため、大きなログページがアシスタントのコンテキストを圧迫することはありません。
- 履歴内のシークレット。 新しい API キーのシークレットは
api_keys_createの結果に表示されるため、アシスタントとの会話履歴にも残ります。履歴を適切に扱うか、ダッシュボードでキーを作成してください。
認証の詳細
クライアント開発者向けです。サーバーは MCP 認可仕様に準拠しています。
| MCP エンドポイント | https://zrouter.si/mcp (POST、Streamable HTTP、ステートレス、JSON レスポンス) |
| 保護されたリソースのメタデータ | https://zrouter.si/.well-known/oauth-protected-resource/mcp (RFC 9728) |
| 認可サーバーのメタデータ | https://zrouter.si/.well-known/oauth-authorization-server (RFC 8414) |
| 認可エンドポイント | https://zrouter.si/oauth/authorize |
| トークンエンドポイント | https://zrouter.si/oauth/token |
| 動的クライアント登録 | https://zrouter.si/oauth/register (RFC 7591) |
| グラントタイプ | authorization_code、refresh_token |
| PKCE | 必須、S256 |
| クライアント認証 | none (パブリッククライアント) |
| スコープ | account |
有効なトークンがないリクエストには、401 が返されます。
WWW-Authenticate: Bearer resource_metadata="https://zrouter.si/.well-known/oauth-protected-resource/mcp", scope="account"
MCP トークンを使った簡単な確認方法:
curl -s https://zrouter.si/mcp \
-H "Authorization: Bearer YOUR_MCP_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
トラブルシューティング
| 問題 | 対処方法 |
|---|---|
401 と invalid_token が返される | トークンの有効期限が切れている (MCP トークンの有効期間は 30 日です)、取り消されている、または MCP トークンではなくアカウント API キーが送信されています。再度サインインするか、新しい MCP トークンを作成してください。 |
| クライアントでサインインできない | リモート MCP と OAuth に対応していることを確認してください。対応していない場合は、MCP トークンを使用してください。 |
| ツールで検証エラーが報告される | ツールはダッシュボードと同じメッセージを返します。指定された引数を修正して再試行してください。 |
| アシスタントが別のアカウントを使用する | Connected apps でアプリの接続を解除し、正しいアカウントでもう一度サインインしてください。 |
よくある質問
インストールやホスティングは必要ですか?
いいえ。ZRouter が https://zrouter.si/mcp でサーバーをホストしています。
費用はかかりますか? いいえ。MCP を通じたアカウント管理は無料です。API キーを使って送信するモデルリクエストには、通常どおりプリペイドクレジットが使用されます。
アシスタントは別のアカウントにアクセスできますか? いいえ。すべてのツールは、サインインしたアカウント内で実行されます。
MCP に接続すると、アシスタントが使用するモデルは変わりますか? いいえ。アカウント管理ツールが追加されるだけです。
代わりにターミナルからアカウントを管理できますか? はい。zctl CLI を使用できます。
リンク
- ウェブサイト:https://zrouter.si
- MCP ガイド:https://zrouter.si/docs/mcp
- API ガイド:https://zrouter.si/docs/api
- インテグレーション:https://zrouter.si/docs/integrations
- zctl CLI:https://zrouter.si/cli
- ステータス:https://zrouter.si/status
- Smithery https://smithery.ai/badge/sali/zrouter
ライセンス
このディレクトリの内容は、MIT License の下で利用できます。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。