Model Context Protocol

Guía de integración MCP

MuiRouter ejecuta un servidor MCP streamable-http para que clientes de IA como Claude Desktop, Claude Code, Cursor y Cline puedan llamarlo directamente: tu asistente de IA puede consultar tu saldo, ver el uso, listar modelos, generar imágenes e incluso iniciar una recarga. Todo se autentica con tu propia clave de API sk-gw-, así que ni terceros ni clientes de IA necesitan una cuenta nueva.

1. Endpoint del servidor

Todos los clientes MCP se conectan a la misma URL usando autenticación Bearer.

Endpoint

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

Header

Authorization: Bearer sk-gw-xxxxxxxx

Versión del protocolo: MCP 2025-06-18, transporte: streamable-http, JSON-RPC 2.0 sin estado.

2. Conectar en Claude Code

Edita ~/.claude/mcp.json y añade el servidor muirouter.

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

Tras reiniciar Claude Code, escribe /mcp para ver la lista de herramientas de muirouter.

3. Conectar en Cursor / Claude Desktop

Rellena la misma URL y el encabezado Authorization.

Cursor: Settings → MCP → Add new server, elige el tipo streamable-http, establece la URL en https://api.muirouter.com/mcp y añade un encabezado personalizado Authorization: Bearer sk-gw-....

Claude Desktop: edita el archivo de configuración (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json) con la misma configuración que Claude Code arriba.

4. Herramientas disponibles

Seis herramientas que cubren consultas de cuenta, precios, generación de imágenes y recargas.

get_balance

Consulta el saldo de la billetera, el total de recargas y el gasto total del usuario propietario de la clave de API actual.

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

get_usage

Pagina el uso de la API del usuario actual, con filtros por modelo y rango de tiempo.

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

list_recharges

Pagina los registros de recarga del usuario actual.

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

list_models

Lista todos los modelos que MuiRouter admite actualmente y sus precios (input/output, markup_rate).

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

create_topup_session

Crea una sesión de recarga de Stripe y devuelve un enlace de pago que el cliente de IA puede guiar al usuario a través de él.

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

image_generation

Llama al endpoint de generación de imágenes compatible con OpenAI a través de MuiRouter (consume el saldo de la billetera).

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

5. Llamadas JSON-RPC directas

También puedes llamarlo directamente con curl, sin un cliente 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. Notas de seguridad

• Tu clave de API es como una contraseña: nunca la expongas en un repositorio público ni en un registro de chat. Si sospechas que se filtró, revócala de inmediato en la página de Claves.

• image_generation y create_topup_session gastan o mueven dinero. Considera configurar estas dos herramientas para que requieran confirmación en tu cliente de IA.

• Cada solicitud está vinculada a la cuenta detrás de su clave sk-gw-, con las mismas reglas de concurrencia y facturación que al llamar a la REST API directamente.

Relacionado

Router y servidor MCP Router de API de IA Precios por token