Model Context Protocol

Guia de integração MCP

O MuiRouter executa um servidor MCP streamable-HTTP para que clientes de IA como Claude Desktop, Claude Code, Cursor e Cline possam chamá-lo diretamente — seu assistente de IA pode consultar seu saldo, ver o uso, listar modelos, gerar imagens e até iniciar uma recarga. Tudo é autenticado com sua própria chave de API sk-gw-, então nem terceiros nem clientes de IA precisam de uma nova conta.

1. Endpoint do servidor

Todos os clientes MCP se conectam à mesma URL usando autenticação Bearer.

Endpoint

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

Header

Authorization: Bearer sk-gw-xxxxxxxx

Versão do protocolo: MCP 2025-06-18, transporte: streamable-http, JSON-RPC 2.0 sem estado.

2. Conectar no Claude Code

Edite ~/.claude/mcp.json e adicione o servidor muirouter.

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

Após reiniciar o Claude Code, digite /mcp para ver a lista de ferramentas do muirouter.

3. Conectar no Cursor / Claude Desktop

Preencha a mesma URL e o cabeçalho Authorization.

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

Claude Desktop: edite o arquivo de configuração (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json) com a mesma configuração do Claude Code acima.

4. Ferramentas disponíveis

Seis ferramentas que cobrem consultas de conta, preços, 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" } }

5. Chamadas JSON-RPC diretas

Você também pode chamá-lo diretamente com curl, sem um 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 segurança

• Sua chave de API é como uma senha — nunca a exponha em um repositório público ou em logs de chat. Se suspeitar que vazou, revogue-a imediatamente na página de chaves.

• image_generation e create_topup_session gastam ou movimentam dinheiro. Considere configurar essas duas ferramentas para exigir confirmação no seu cliente de IA.

• Cada requisição é vinculada à conta por trás da sua chave sk-gw-, com as mesmas regras de concorrência e cobrança de chamar a REST API diretamente.

Relacionados

Router e servidor MCP Router de API de IA Preços por token