Routebase

Projete, simule, teste, documente e monitore suas APIs a partir de uma única especificação OpenAPI viva.

Documentação

routebase-mcp

Deixe seu agente de IA trabalhar nas suas APIs no Routebase. Este é o conector para Routebase, uma plataforma de ciclo de vida de APIs onde documentação, servidores mock, testes de contrato e monitoramento são todos derivados de uma única especificação OpenAPI. Os agentes trabalham nessa mesma especificação, então eles projetam endpoints e schemas, executam suítes de testes de contrato e segurança, gerenciam mocks, publicam documentação e leem monitores sob as mesmas permissões baseadas em papéis que o time humano. Cobrança e acesso à organização permanecem somente leitura.

Existem duas formas de conectar. Escolha o endpoint hospedado, a menos que seu cliente fale apenas stdio.

Endpoint hospedado (recomendado)

https://mcp.routebase.dev

HTTP Streamable, com OAuth 2.1 e registro dinâmico de clientes — você entra com sua conta Routebase, nada para instalar e nenhuma chave para rotacionar. Clientes que preferem uma credencial estática podem enviar um cabeçalho X-API-Key.

Contas da região dos EUA usam https://mcp.routebase.dev/?region=us. Errar isso aparece como um conector sem ferramentas, não como um erro.

Ponte stdio

Para clientes que apenas iniciam processos locais:

ROUTEBASE_API_KEY=rb_… npx routebase-mcp

Gere uma chave de API no Routebase em Configurações → Chaves de API. A configuração interativa escreve a configuração correta para você:

npx routebase-mcp init

Ou adicione manualmente. Claude Code (.mcp.json) e Cursor (.cursor/mcp.json) aceitam o mesmo bloco:

{
  "mcpServers": {
    "routebase": {
      "command": "npx",
      "args": ["-y", "routebase-mcp", "--stdio"],
      "env": {
        "ROUTEBASE_API_KEY": "rb_…"
      }
    }
  }
}

Codex lê ~/.codex/config.toml, o mesmo arquivo para a CLI e a extensão do IDE:

[mcp_servers.routebase]
command = "npx"
args = ["-y", "routebase-mcp@latest", "--stdio"]

[mcp_servers.routebase.env]
ROUTEBASE_API_KEY = "rb_…"

VS Code não precisa da ponte, porque ele fala HTTP Streamable por conta própria. Seu .vscode/mcp.json lê a chave de nível superior servers em vez de mcpServers, exige type em cada entrada e expande apenas ${input:…}, então a chave fica fora do arquivo versionado. Veja o início rápido do MCP para o bloco completo.

Variável de ambiente	Obrigatória	Descrição
`ROUTEBASE_API_KEY`	✅	Chave de API para autenticação. Crie uma em Configurações → Chaves de API.
`ROUTEBASE_REGION`	Contas dos EUA	Região de origem da sua conta: `us` ou `eu` (padrão: `eu`). Sem ela, uma chave dos EUA falha como se fosse inválida.
`ROUTEBASE_LOG_LEVEL`	–	`verbose` · `debug` · `info` · `warning` · `error` · `fatal` (padrão: `warning`). Os logs vão para stderr — stdout é reservado para o protocolo MCP.

Como a ponte stdio funciona

O pacote npm é um pequeno shim. Na primeira execução, ele baixa o binário CLI autossuficiente para sua plataforma de releases.routebase.dev, verifica-o contra um checksum SHA-256 embutido no pacote no momento da publicação (recusa-se a executar em caso de incompatibilidade — falha fechada) e o armazena em cache em ~/.routebase/bin/<version>/.

Plataformas suportadas: macOS (arm64, x64), Windows (x64), Linux (x64). Requer Node.js ≥ 18.

O que há neste repositório

Arquivo	Finalidade
`bin/routebase-mcp.js`	O shim stdio publicado como o pacote npm `routebase-mcp`
`server.json`	Manifesto para o MCP Registry (`dev.routebase/routebase`)
`plugin.json`, `mcp.json`	Manifestos Agent Plugins 1.0
`package.json`, `checksums.json`	Os metadados do pacote publicado e os checksums SHA-256 dos binários aos quais esta versão está fixada

Este repositório espelha o conector como publicado, e cada arquivo nele é escrito pelo pipeline de release no repositório próprio do Routebase. Cada release envia o conteúdo exato do pacote npm para cá e o marca com uma tag, então alterações feitas aqui não chegarão ao npm — abra uma issue em vez de um pull request.

Licença

O shim neste repositório é MIT. O binário CLI do Routebase baixado é regido pelos Termos do Routebase.