Routara LLM Gateway

Gateway MCP compatível com OpenAI para 787+ modelos de chat, imagem e vídeo.

Documentação

Servidor MCP Routara

Servidor oficial do Model Context Protocol para Routara. Use os modelos de chat, imagem e vídeo da Routara no Cursor, Claude Desktop, Codex, Windsurf, VS Code e outros clientes MCP.

Site e guia de configuração: https://routara.ai/mcp
API compatível com OpenAI: https://api.routara.ai/v1
Crie uma chave de API: https://routara.ai/#auth

Instalação

npx -y routara-mcp

Ou instale o pacote routara-mcp.mcpb com um clique a partir do release mais recente do GitHub.

Ferramentas

Ferramenta	Descrição
`routara_list_models`	Pesquise e pagine o catálogo de modelos em tempo real
`routara_chat`	Chat de turno único ou múltiplo, incluindo chamadas de ferramentas
`routara_generate_image`	Geração de imagem a partir de texto e de imagem de referência
`routara_generate_video`	Envio de texto para vídeo e imagem para vídeo
`routara_get_video_status`	Consulte uma tarefa de vídeo assíncrona

Configuração do cliente MCP

{
  "mcpServers": {
    "routara": {
      "command": "npx",
      "args": ["-y", "routara-mcp"],
      "env": {
        "ROUTARA_API_KEY": "sk-or-v1-YOUR_KEY_HERE"
      }
    }
  }
}

OpenAI Codex

[mcp_servers.routara]
command = "npx"
args = ["-y", "routara-mcp"]
enabled = true

[mcp_servers.routara.env]
ROUTARA_API_KEY = "sk-or-v1-YOUR_KEY_HERE"

Ambiente

Variável	Obrigatória	Padrão
`ROUTARA_API_KEY`	Sim para chamadas de ferramentas	Nenhum
`ROUTARA_API_BASE`	Não	`https://api.routara.ai/v1`
`ROUTARA_API_TIMEOUT_MS`	Não	`30000`

O processo pode iniciar e concluir o handshake do MCP sem uma chave de API. Uma chave é resolvida somente quando uma ferramenta da Routara é invocada, o que permite que diretórios validem o servidor com segurança.

Confiabilidade e compatibilidade

As solicitações expiram em vez de ficarem penduradas indefinidamente.
Erros de rede transitórios, HTTP 429 e respostas HTTP 5xx são repetidos com backoff limitado.
Erros de API incluem o ID da solicitação upstream e o atraso de repetição quando disponíveis.
routara_chat retorna a resposta completa compatível com OpenAI, preservando o conteúdo de raciocínio e as chamadas de ferramentas.
Os parâmetros de mídia são encaminhados somente quando fornecidos explicitamente; o suporte específico do modelo varia.

Desenvolvimento

npm ci
npm run build
npm test
npm run validate:registry
npm run build:mcpb

Para um teste de fumaça da API ao vivo:

ROUTARA_API_KEY=sk-or-v1-... npm run test:live

Listagens de diretórios

Segurança

Não faça commit de chaves de API. Se uma chave for exposta, revogue-a imediatamente no painel da Routara. Por favor, relate problemas de segurança em particular para support@routara.ai.

Licença

MIT