MuiRouter

Model Context Protocol

MCP-Integrationsleitfaden

MuiRouter betreibt einen streamable-HTTP-MCP-Server, sodass KI-Clients wie Claude Desktop, Claude Code, Cursor und Cline ihn direkt aufrufen können — dein KI-Assistent kann dein Guthaben prüfen, die Nutzung einsehen, Modelle auflisten, Bilder generieren und sogar eine Aufladung starten. Alles wird mit deinem eigenen sk-gw--API-Key authentifiziert, sodass weder Dritte noch KI-Clients ein neues Konto brauchen.

1. Server-Endpunkt
Alle MCP-Clients verbinden sich über Bearer-Authentifizierung mit derselben URL.
Endpoint
POST https://api.muirouter.com/mcp
Header
Authorization: Bearer sk-gw-xxxxxxxx

Protokollversion: MCP 2025-06-18, Transport: streamable-http, zustandsloses JSON-RPC 2.0.

2. In Claude Code verbinden
Bearbeite ~/.claude/mcp.json und füge den muirouter-Server hinzu.
{
  "mcpServers": {
    "muirouter": {
      "url": "https://api.muirouter.com/mcp",
      "headers": {
        "Authorization": "Bearer sk-gw-xxxxxxxx"
      }
    }
  }
}

Tippe nach dem Neustart von Claude Code /mcp ein, um die muirouter-Tool-Liste zu sehen.

3. In Cursor / Claude Desktop verbinden
Trage dieselbe URL und denselben Authorization-Header ein.

Cursor: Settings → MCP → Add new server, wähle den Typ streamable-http, setze die URL auf https://api.muirouter.com/mcp und füge einen benutzerdefinierten Header Authorization: Bearer sk-gw-... hinzu.

Claude Desktop: bearbeite die Konfigurationsdatei (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json) mit derselben Konfiguration wie bei Claude Code oben.

4. Verfügbare Tools
Sechs Tools für Kontoabfragen, Preise, Bilderzeugung und Aufladungen.
get_balance

Fragt das Wallet-Guthaben, die gesamten Aufladungen und die Gesamtausgaben des Benutzers ab, dem der aktuelle API Key gehört.

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

Blättert seitenweise durch die API-Nutzung des aktuellen Benutzers, filterbar nach Modell und Zeitraum.

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

Blättert seitenweise durch die Aufladeeinträge des aktuellen Benutzers.

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

Listet alle Modelle auf, die MuiRouter aktuell unterstützt, samt Preisen (input/output, markup_rate).

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

Erstellt eine Stripe-Aufladesitzung und gibt einen Zahlungslink zurück, durch den der KI-Client den Benutzer führen kann.

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

Ruft den OpenAI-kompatiblen Endpunkt zur Bilderzeugung über MuiRouter auf (verbraucht Wallet-Guthaben).

{ "name": "image_generation", "arguments": { "model": "gpt-image-2", "prompt": "a cute cat" } }
5. Direkte JSON-RPC-Aufrufe
Du kannst ihn auch direkt mit curl aufrufen, ohne MCP-Client.
# 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. Sicherheitshinweise

• Dein API Key ist wie ein Passwort — gib ihn niemals in einem öffentlichen Repository oder Chat-Verlauf preis. Falls du einen Leak vermutest, widerrufe ihn sofort auf der Keys-Seite.

• image_generation und create_topup_session geben Geld aus oder bewegen es. Erwäge, diese beiden Tools in deinem KI-Client bestätigungspflichtig zu machen.

• Jede Anfrage ist an das Konto hinter ihrem sk-gw--Key gebunden, mit denselben Parallelitäts- und Abrechnungsregeln wie beim direkten Aufruf der REST API.

Verwandt

MCP-Router & ServerKI-API-RouterPreise pro Token