Model Context Protocol (MCP) Router & Gateway

Guide du Routeur MCP et d'Intégration

MuiRouter fournit un serveur et un routeur MCP streamable-HTTP haute performance. Connectez des clients IA comme Claude Desktop, Claude Code, Cursor et Cline pour router vos LLMs, agréger plusieurs serveurs MCP locaux et distants, et utiliser des outils de compte intégrés avec votre propre clé d'API.

1. Support Protocolaire Dual-Era

Conçu pour supporter la spécification streamable-HTTP sans état la plus récente (2026-07-28) tout en assurant une négociation transparente pour les clients 2025-11-25 / 2025-06-18.

Spécification Moderne (2026-07-28) : streamable-HTTP sans état, en-têtes explicites (MCP-Protocol-Version), découverte server/discover et protection DNS rebinding.

Compatibilité Legacy (2025-11-25 / 2025-06-18) : Négociation automatique par handshake initialize pour les clients existants.

2. Endpoint du Serveur et Authentification

Tous les clients MCP se connectent à la même URL streamable-HTTP en utilisant l'authentification Bearer.

Endpoint

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

Header

Authorization: Bearer sk-gw-xxxxxxxx

3. Agrégation Multi-Serveurs (Exemple Claude Code)

Ajoutez MuiRouter aux côtés de vos serveurs MCP locaux dans ~/.claude/mcp.json pour un routage centralisé.

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

Redémarrez Claude Code et tapez /mcp pour afficher la liste agrégée des outils de tous les serveurs connectés.

4. Connexion dans Cursor / Claude Desktop / Cline

Configurez streamable-HTTP avec le même endpoint et le même en-tête Authorization.

Cursor : Settings → MCP → Add new server, choisissez le type streamable-http, définissez l'URL sur https://api.muirouter.com/mcp et ajoutez l'en-tête Authorization: Bearer sk-gw-....

Claude Desktop : Modifiez le fichier de configuration (~/Library/Application Support/Claude/claude_desktop_config.json) avec la même configuration JSON.

5. Outils Intégrés de Compte et d'IA

Six outils intégrés couvrant le routage des modèles, la consultation de solde, la génération d'images et les recharges.

get_balance

Interroge le solde du portefeuille, le total des recharges et le total des dépenses de l'utilisateur propriétaire de la clé d'API courante.

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

get_usage

Parcourt par pagination la consommation d'API de l'utilisateur courant, filtrable par modèle et par plage de temps.

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

list_recharges

Parcourt par pagination les enregistrements de recharge de l'utilisateur courant.

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

list_models

Liste tous les modèles actuellement pris en charge par MuiRouter et leur tarification (input/output, markup_rate).

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

create_topup_session

Crée une session de recharge Stripe et renvoie un lien de paiement que le client IA peut proposer à l'utilisateur.

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

image_generation

Appelle l'endpoint de génération d'images compatible OpenAI via MuiRouter (consomme le solde du portefeuille).

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

6. Tests Directs JSON-RPC et curl

Testez la découverte du serveur, la liste des outils et l'exécution directement avec curl sans client MCP.

# 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. Sécurité et Bonnes Pratiques

• Votre clé d'API est un identifiant confidentiel : ne l'exposez jamais dans un dépôt public. Révoquez-la immédiatement sur la page Keys en cas de doute.

• Des actions comme image_generation et create_topup_session engagent des fonds ; configurez votre client IA pour exiger une confirmation interactive.

• La vérification d'origine protège contre les attaques de DNS rebinding ; toutes les requêtes respectent les règles normales de concurrence et de facturation.

Guides et Comparatifs Associés

MCP Router & Gateway Qu'est-ce qu'un serveur MCP ?MuiRouter vs OpenRouter Routeur d'API IA Tarification au token