Buscar documentação...

Comece a digitar para buscar documentação

ModelContextProtocol
Servidor MCP

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.

text
URL base: https://api.unorouter.com/v1
Chave da API: YOUR_API_KEY

Entre para preencher automaticamente sua chave API

Compatibilidade

Chat Completions

Configuração passo a passo

  1. 1
    Obtenha 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.

    bash
    UNOROUTER_API_KEY=YOUR_API_KEY
    UNOROUTER_BASE_URL=https://api.unorouter.com/v1

    Entre para preencher automaticamente sua chave API

  2. 2
    Adicione 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" }
        }
      }
    }

    Entre para preencher automaticamente sua chave API

  3. 3
    Ou registre no Claude Code

    Um único comando registra o servidor com a sua chave.

    bash
    claude mcp add unorouter -e UNOROUTER_API_KEY=YOUR_API_KEY -- npx -y unorouter-mcp

    Entre para preencher automaticamente sua chave API

  4. 4
    Use 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.

    text
    search_models  filter the live catalog (free_only option)
    get_pricing    USD list prices per 1M tokens
    chat           send a prompt to any model

    Entre para preencher automaticamente sua chave API

Modelos recomendados

Modelos gratuitos que funcionam bem aqui. Cole qualquer id de modelo no cliente.

qwen3.5-122b-a10b:freeqwen3.5-122b:freemistral-medium-3.5:freegemma-4-e2b-it-gguf:freeqwen3-30b-a3b:free

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.
Gerar chave APIModelos