mcpField
Z
ZRouter

ZRouter

リモート
zrouter.siAI・エージェント11 週間前に更新
リポジトリ公式サイト

ZRouter について

ZRouter MCPは、AIアシスタントからZRouterアカウントの利用状況、ログ、モデルルーター、APIキー、予算、制限を管理するホスト型サーバーです。認証済みアカウント内の操作に限定され、アシスタントのモデルプロバイダーは変更しません。

主な機能

  1. 01利用状況・費用・リクエストログの確認
  2. 02仮想モデルルーターの作成と管理
  3. 03APIキーの作成と削除
  4. 04支出予算とレート制限の設定

活用シーン

  1. 01モデル別の週間支出の確認
  2. 02失敗したリクエストとエラーの調査
  3. 03アプリケーション用モデルルーターの作成
  4. 04ステージング環境の支出やリクエスト頻度の制限

MCP 対応

Streamable HTTP経由で24個のアカウント管理ツールを提供する、ホスト型のリモートMCPサーバーです。クライアントはOAuth 2.1またはBearerトークンで認証します。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://zrouter.si/mcp
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

ツール

詳細

ZRouter のロゴ

ZRouter 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 個)

目次

クイックスタート

  1. zrouter.siで無料アカウントを作成します。
  2. クライアントで https://zrouter.si/mcp をリモート MCP サーバーとして追加します。
  3. 開いた ZRouter のページでアクセスを許可します。
  4. 「今週の利用額をモデル別に教えて」と質問します。

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 トークンを使用します。

  1. ZRouter ダッシュボードでCLI と MCP アクセスを開きます。
  2. クライアント名を付けて、MCP トークンを作成を選択します。
  3. すぐにコピーしてください。トークンは一度だけ表示され、有効期限は 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_get1 件のログエントリの詳細(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_reset1 件の予算の現在の支出をゼロにリセット破壊的操作
レート制限
ツール機能種類
rate_limits_list現在のカウンターを含むレート制限読み取り専用
rate_limits_upsert1 分、1 時間、または 1 日あたりのリクエスト数またはトークン数の上限を作成または更新書き込み
rate_limits_deleteレート制限を削除破壊的操作
rate_limits_reset1 件のレート制限のカウンターをリセット破壊的操作

予算は 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 を使用できます。

リンク

ライセンス

このディレクトリの内容は、MIT License の下で利用できます。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。