Model Context Protocol (MCP) Router & Gateway

MCP-Router & Integrationsleitfaden

MuiRouter bietet einen hochleistungsfähigen streamable-HTTP-MCP-Server und -Router. Verbinde KI-Clients wie Claude Desktop, Claude Code, Cursor und Cline, um LLMs zu routen, mehrere lokale und entfernte MCP-Server zu aggregieren und integrierte Kontotools mit deinem eigenen API-Key zu nutzen.

1. Dual-Era-Protokollunterstützung

Unterstützt die neueste zustandslose streamable-HTTP-Spezifikation 2026-07-28 bei nahtloser Abwärtskompatibilität mit 2025-11-25 / 2025-06-18 Clients.

Modern Spec (2026-07-28): Zustandsloses streamable-HTTP, explizite _meta & Header (MCP-Protocol-Version), server/discover-Erkennung und DNS-Rebinding-Schutz.

Legacy-Kompatibilität (2025-11-25 / 2025-06-18): Automatische initialize-Handshake-Aushandlung für bestehende Clients.

2. Server-Endpunkt & Authentifizierung

Alle MCP-Clients verbinden sich über Bearer-Authentifizierung mit derselben streamable-HTTP-URL.

Endpoint

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

Header

Authorization: Bearer sk-gw-xxxxxxxx

3. Multi-Server-Aggregation (Claude Code Beispiel)

Füge MuiRouter zusammen mit lokalen MCP-Servern in ~/.claude/mcp.json für zentrales Routing hinzu.

{
  "mcpServers": {
    "muirouter": {
      "url": "https://api.muirouter.com/mcp",
      "headers": {
        "Authorization": "Bearer sk-gw-xxxxxxxx"
      }
    },
    "local-tools": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-everything"]
    }
  }
}

Starte Claude Code neu und gib /mcp ein, um die aggregierte Tool-Liste aller Server zu sehen.

4. In Cursor / Claude Desktop / Cline verbinden

Konfiguriere denselben streamable-HTTP-Endpunkt und Authorization-Header.

Cursor: Settings → MCP → Add new server, Typ streamable-http wählen, URL auf https://api.muirouter.com/mcp setzen und Header Authorization: Bearer sk-gw-... hinzufügen.

Claude Desktop: Konfigurationsdatei (~/Library/Application Support/Claude/claude_desktop_config.json) mit derselben JSON-Konfiguration bearbeiten.

5. Integrierte Konto- & KI-Tools

Sechs integrierte Tools für Modell-Routing, Kontoabfragen, 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" } }

6. Direkte JSON-RPC- & curl-Tests

Teste Server-Discovery, Tool-Auflistung und Tool-Aufrufe direkt mit curl ohne MCP-Client.

# Discover server capabilities (Modern 2026-07-28)
curl -X POST https://api.muirouter.com/mcp \
  -H "Authorization: Bearer sk-gw-xxxxxxxx" \
  -H "MCP-Protocol-Version: 2026-07-28" \
  -H "Mcp-Method: server/discover" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"server/discover","params":{"_meta":{"protocolVersion":"2026-07-28"}}}'

# 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":2,"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":3,
    "method":"tools/call",
    "params": {"name":"get_balance","arguments":{}}
  }'

7. Sicherheitshinweise & Best Practices

• Dein API Key ist wie ein Passwort — gib ihn niemals in einem öffentlichen Repository preis. Widerrufe ihn bei Verdacht sofort auf der Keys-Seite.

• image_generation und create_topup_session bewegen Guthaben. Aktiviere für solche Tools in deinem KI-Client eine Bestätigungspflicht.

• Origin-Prüfung schützt vor DNS-Rebinding; alle Anfragen unterliegen den regulären Parallelitäts- und Abrechnungsregeln.

Verwandte Leitfäden & Vergleiche