MuiRouter

Model Context Protocol (MCP) Router & Gateway

Guia do MCP Router e Integração

O MuiRouter fornece um servidor e router MCP streamable-HTTP de alto desempenho. Conecte clientes de IA como Claude Desktop, Claude Code, Cursor e Cline para rotear LLMs, agregar múltiplos servidores MCP locais e remotos, e usar ferramentas integradas com sua própria API key.

1. Suporte de Protocolo Dual-Era
Construído para suportar a especificação streamable-HTTP sem estado mais recente (2026-07-28) com negociação transparente para clientes 2025-11-25 / 2025-06-18.

Especificação Moderna (2026-07-28): streamable-HTTP sem estado, _meta e cabeçalhos explícitos (MCP-Protocol-Version), descoberta server/discover e proteção DNS rebinding.

Compatibilidade Legacy (2025-11-25 / 2025-06-18): Negociação automática de handshake initialize para clientes existentes.

2. Endpoint do Servidor e Autenticação
Todos os clientes MCP se conectam à mesma URL streamable-HTTP usando autenticação Bearer.
Endpoint
POST https://api.muirouter.com/mcp
Header
Authorization: Bearer sk-gw-xxxxxxxx
3. Agregação Multi-Servidor (Exemplo Claude Code)
Adicione o MuiRouter junto com seus servidores MCP locais em ~/.claude/mcp.json para roteamento centralizado.
{
  "mcpServers": {
    "muirouter": {
      "url": "https://api.muirouter.com/mcp",
      "headers": {
        "Authorization": "Bearer sk-gw-xxxxxxxx"
      }
    },
    "local-tools": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-everything"]
    }
  }
}

Reinicie o Claude Code e digite /mcp para ver a lista agregada de ferramentas de todos os servidores conectados.

4. Conectar no Cursor / Claude Desktop / Cline
Configure streamable-HTTP com o mesmo endpoint e cabeçalho Authorization.

Cursor: Configurações → MCP → Add new server, escolha streamable-http, defina a URL como https://api.muirouter.com/mcp e adicione o cabeçalho Authorization: Bearer sk-gw-....

Claude Desktop: Edite o arquivo de configuração (~/Library/Application Support/Claude/claude_desktop_config.json) com a mesma configuração JSON.

5. Ferramentas Integradas de Conta e IA
Seis ferramentas integradas que cobrem roteamento de modelos, consultas de saldo, geração de imagens e recargas.
get_balance

Consulta o saldo da carteira, o total de recargas e o total de gastos do usuário dono da chave de API atual.

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

Pagina o uso da API do usuário atual, com filtro por modelo e intervalo de tempo.

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

Pagina os registros de recarga do usuário atual.

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

Lista todos os modelos que o MuiRouter suporta atualmente e seus preços (input/output, markup_rate).

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

Cria uma sessão de recarga do Stripe e retorna um link de pagamento que o cliente de IA pode orientar o usuário a usar.

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

Chama o endpoint de geração de imagens compatível com OpenAI através do MuiRouter (consome o saldo da carteira).

{ "name": "image_generation", "arguments": { "model": "gpt-image-2", "prompt": "a cute cat" } }
6. Testes Diretos JSON-RPC e curl
Teste a descoberta do servidor, lista de ferramentas e chamadas diretamente com curl sem um 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. Segurança e Boas Práticas

• Sua chave de API é uma credencial: nunca a exponha em repositórios públicos. Revogue-a imediatamente na página de chaves se houver suspeita de vazamento.

• Ações como image_generation e create_topup_session movimentam fundos; configure seu cliente de IA para exigir confirmação interativa.

• A verificação de origem protege contra ataques de DNS rebinding; todas as requisições respeitam as regras normais de concorrência e cobrança.

Guias e Comparativos Relacionados

MCP Router & GatewayO que é um servidor MCP?MuiRouter vs OpenRouterRouter de API de IAPreços por token