Model Context Protocol (MCP) Router & Gateway

Guía de MCP Router e Integración

MuiRouter ofrece un servidor y router MCP de alto rendimiento por streamable-HTTP. Conecta clientes de IA como Claude Desktop, Claude Code, Cursor y Cline para enrutar LLMs, agregar múltiples servidores MCP locales y remotos, y usar herramientas integradas con tu propia API key.

1. Compatibilidad de Protocolo Dual-Era

Diseñado para admitir la especificación streamable-HTTP sin estado más reciente (2026-07-28) con compatibilidad total para clientes 2025-11-25 / 2025-06-18.

Especificación Moderna (2026-07-28): streamable-HTTP sin estado, _meta y encabezados explícitos (MCP-Protocol-Version), descubrimiento server/discover y protección DNS rebinding.

Compatibilidad Legacy (2025-11-25 / 2025-06-18): Negociación automática mediante handshake initialize para clientes tradicionales.

2. Endpoint del Servidor y Autenticación

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

Endpoint

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

Header

Authorization: Bearer sk-gw-xxxxxxxx

3. Agregación Multi-Servidor (Ejemplo Claude Code)

Añade MuiRouter junto a tus servidores MCP locales en ~/.claude/mcp.json para un enrutamiento centralizado.

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

Reinicia Claude Code y escribe /mcp para ver la lista agregada de herramientas de todos los servidores conectados.

4. Conectar en Cursor / Claude Desktop / Cline

Configura streamable-HTTP con el mismo endpoint y encabezado Authorization.

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

Claude Desktop: Edita el archivo de configuración (~/Library/Application Support/Claude/claude_desktop_config.json) con la misma configuración JSON.

5. Herramientas Integradas de Cuenta e IA

Seis herramientas integradas que cubren enrutamiento de modelos, consultas de saldo, 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" } }

6. Pruebas Directas JSON-RPC y curl

Prueba el descubrimiento del servidor, la lista de herramientas y las llamadas directamente con curl sin un cliente 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. Seguridad y Buenas Prácticas

• Tu clave de API es una credencial: nunca la expongas en repositorios públicos. Revócala de inmediato en la página de Claves si se ve comprometida.

• Acciones como image_generation y create_topup_session mueven fondos; configura tu cliente de IA para requerir confirmación interactiva.

• La verificación de origen protege contra ataques de DNS rebinding; todas las solicitudes respetan las reglas estándar de concurrencia y facturación.

Guías y Comparativas Relacionadas

MCP Router & Gateway ¿Qué es un servidor MCP?MuiRouter vs OpenRouter Router de API de IA Precios por token