Model Context Protocol

Guide d'intégration MCP

MuiRouter exécute un serveur MCP en streamable-http afin que des clients IA comme Claude Desktop, Claude Code, Cursor et Cline puissent l'appeler directement — votre assistant IA peut consulter votre solde, voir votre consommation, lister les modèles, générer des images et même lancer une recharge. Tout est authentifié avec votre propre clé d'API sk-gw-, si bien que ni les tiers ni les clients IA n'ont besoin d'un nouveau compte.

1. Endpoint du serveur

Tous les clients MCP se connectent à la même URL avec une authentification Bearer.

Endpoint

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

Header

Authorization: Bearer sk-gw-xxxxxxxx

Version du protocole : MCP 2025-06-18, transport : streamable-http, JSON-RPC 2.0 sans état.

2. Connexion dans Claude Code

Modifiez ~/.claude/mcp.json et ajoutez le serveur muirouter.

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

Après avoir redémarré Claude Code, tapez /mcp pour voir la liste des outils muirouter.

3. Connexion dans Cursor / Claude Desktop

Renseignez la même URL 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 un en-tête personnalisé Authorization: Bearer sk-gw-....

Claude Desktop : modifiez le fichier de configuration (macOS : ~/Library/Application Support/Claude/claude_desktop_config.json) avec la même configuration que pour Claude Code ci-dessus.

4. Outils disponibles

Six outils couvrant les requêtes de compte, la tarification, 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" } }

5. Appels JSON-RPC directs

Vous pouvez aussi l'appeler directement avec curl, sans client MCP.

# 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. Notes de sécurité

• Votre clé d'API est comme un mot de passe — ne l'exposez jamais dans un dépôt public ou un journal de conversation. Si vous soupçonnez une fuite, révoquez-la immédiatement depuis la page des clés.

• image_generation et create_topup_session dépensent ou déplacent de l'argent. Envisagez de configurer ces deux outils pour exiger une confirmation dans votre client IA.

• Chaque requête est liée au compte associé à sa clé sk-gw-, avec les mêmes règles de concurrence et de facturation qu'un appel direct à l'API REST.

À découvrir

MCP Router & serveur Routeur d'API IA Tarification au token