Model Context Protocol

MCP 連携ガイド

MuiRouter は streamable-http の MCP サーバーを提供しており、Claude Desktop、Claude Code、Cursor、Cline などの AI クライアントから直接呼び出せます。AI アシスタントが残高の確認、使用量の閲覧、モデル一覧の取得、画像生成、さらにはチャージの開始まで実行できます。すべての認証はお手元の sk-gw- API キーで行われるため、第三者も AI クライアントも新しいアカウントを用意する必要はありません。

1. サーバーエンドポイント

すべての MCP クライアントは同じ URL に Bearer 認証で接続します。

Endpoint

POST https://api.muirouter.com/mcp

Header

Authorization: Bearer sk-gw-xxxxxxxx

プロトコルバージョン: MCP 2025-06-18、トランスポート: streamable-http、ステートレスな JSON-RPC 2.0。

2. Claude Code で接続する

~/.claude/mcp.json を編集して muirouter サーバーを追加します。

{
  "mcpServers": {
    "muirouter": {
      "url": "https://api.muirouter.com/mcp",
      "headers": {
        "Authorization": "Bearer sk-gw-xxxxxxxx"
      }
    }
  }
}

Claude Code を再起動した後、/mcp と入力すると muirouter のツール一覧が表示されます。

3. Cursor / Claude Desktop で接続する

同じ URL と Authorization ヘッダーを入力します。

Cursor: 設定 → MCP → Add new server で streamable-http タイプを選択し、URL を https://api.muirouter.com/mcp に設定して、カスタムヘッダー Authorization: Bearer sk-gw-... を追加します。

Claude Desktop: 設定ファイル（macOS: ~/Library/Application Support/Claude/claude_desktop_config.json）を、上記の Claude Code と同じ設定で編集します。

4. 利用可能なツール

アカウント照会、料金、画像生成、チャージをカバーする6つのツール。

get_balance

現在の API キーを所有するユーザーのウォレット残高、累計チャージ額、累計支出額を照会します。

{ "name": "get_balance", "arguments": {} }

get_usage

現在のユーザーの API 使用量をページ送りで取得します。モデルと期間で絞り込めます。

{ "name": "get_usage", "arguments": { "limit": 20, "model": "gpt-4o" } }

list_recharges

現在のユーザーのチャージ履歴をページ送りで取得します。

{ "name": "list_recharges", "arguments": { "limit": 20 } }

list_models

MuiRouter が現在サポートしているすべてのモデルとその料金（input/output、markup_rate）を一覧表示します。

{ "name": "list_models", "arguments": {} }

create_topup_session

Stripe のチャージセッションを作成し、AI クライアントがユーザーを案内できる決済リンクを返します。

{ "name": "create_topup_session", "arguments": { "amount_cents": 1000, "currency": "usd" } }

image_generation

MuiRouter 経由で OpenAI 互換の画像生成エンドポイントを呼び出します（ウォレット残高を消費します）。

{ "name": "image_generation", "arguments": { "model": "gpt-image-2", "prompt": "a cute cat" } }

5. JSON-RPC を直接呼び出す

MCP クライアントを使わず、curl で直接呼び出すこともできます。

# List tools
curl -X POST https://api.muirouter.com/mcp \
  -H "Authorization: Bearer sk-gw-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# Call get_balance
curl -X POST https://api.muirouter.com/mcp \
  -H "Authorization: Bearer sk-gw-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc":"2.0",
    "id":2,
    "method":"tools/call",
    "params": {"name":"get_balance","arguments":{}}
  }'

6. セキュリティに関する注意

• API キーはパスワードと同じです。公開リポジトリやチャットログに絶対に露出させないでください。漏洩が疑われる場合は、Keys ページですぐに無効化してください。

• image_generation と create_topup_session は金銭を消費または移動します。AI クライアントでこの2つのツールに確認を必須とする設定を検討してください。

• すべてのリクエストは sk-gw- キーの背後にあるアカウントに紐づき、REST API を直接呼び出す場合と同じ同時実行および課金ルールが適用されます。

関連