Guia de configuração do servidor MCP
Dê a qualquer cliente MCP acesso ao vivo ao UnoRouter: pesquise o catálogo de modelos, confira preços e converse com qualquer modelo pelo servidor unorouter-mcp.
Visão geral
unorouter-mcp é um pacote npm que roda como servidor MCP sobre stdio e está publicado no registro oficial do MCP como com.unorouter/mcp. Ele expõe três ferramentas: search_models filtra o catálogo ao vivo com a opção free_only, get_pricing retorna preços de tabela em USD por 1M de tokens e chat envia um prompt a qualquer modelo. O código-fonte está em github.com/0-don/unorouter-mcp.
Configuração rápida
Coloque esses valores no cliente. Sua chave e preenchida automaticamente quando você está conectado.
URL base: https://api.unorouter.com/v1
Chave da API: YOUR_API_KEYCompatibilidade
Configuração passo a passo
- 1Obtenha uma chave de API
Crie uma chave em unorouter.com/token. O servidor a lê da variável de ambiente UNOROUTER_API_KEY. UNOROUTER_BASE_URL é uma substituição opcional do endpoint.
bashUNOROUTER_API_KEY=YOUR_API_KEY UNOROUTER_BASE_URL=https://api.unorouter.com/v1 - 2Adicione o servidor ao Claude Desktop
Adicione este bloco ao arquivo de configuração do Claude Desktop. O npx baixa o unorouter-mcp na primeira execução, então não há nada para instalar antes.
json{ "mcpServers": { "unorouter": { "command": "npx", "args": ["-y", "unorouter-mcp"], "env": { "UNOROUTER_API_KEY": "YOUR_API_KEY" } } } } - 3Ou registre no Claude Code
Um único comando registra o servidor com a sua chave.
bashclaude mcp add unorouter -e UNOROUTER_API_KEY=YOUR_API_KEY -- npx -y unorouter-mcp - 4Use as ferramentas
Peça ao seu cliente para encontrar um modelo, comparar preços ou enviar um prompt a um modelo. Ele chama search_models, get_pricing e chat conforme necessário. Qualquer cliente MCP que fale stdio funciona.
textsearch_models filter the live catalog (free_only option) get_pricing USD list prices per 1M tokens chat send a prompt to any model
Modelos recomendados
Modelos gratuitos que funcionam bem aqui. Cole qualquer id de modelo no cliente.
Pontos de atenção
- Modelos com o sufixo :free não custam nada. Espere um limite de cerca de 1 requisição por minuto por modelo gratuito.
- UNOROUTER_API_KEY é obrigatória. Defina UNOROUTER_BASE_URL apenas se apontar o servidor para outro endpoint.
- Clientes MCP compatíveis com o registro podem instalar o servidor pelo nome de registro com.unorouter/mcp em vez do comando npx.