Routebase

Diseña, simula, prueba, documenta y monitorea tus APIs desde una única especificación OpenAPI viva.

Documentación

routebase-mcp

Permite que tu agente de IA trabaje en tus APIs en Routebase. Este es el conector para Routebase, una plataforma de ciclo de vida de APIs donde la documentación, los servidores mock, las pruebas de contrato y el monitoreo se derivan de una única especificación OpenAPI. Los agentes trabajan sobre esa misma especificación, por lo que diseñan endpoints y esquemas, ejecutan suites de pruebas de contrato y seguridad, gestionan mocks, publican documentación y leen monitores bajo los mismos permisos basados en roles que el equipo humano. La facturación y el acceso a la organización permanecen de solo lectura.

Hay dos formas de conectarse. Elige el endpoint alojado a menos que tu cliente solo admita stdio.

Endpoint alojado (recomendado)

https://mcp.routebase.dev

HTTP Streamable, con OAuth 2.1 y registro dinámico de clientes: inicias sesión con tu cuenta de Routebase, sin nada que instalar y sin claves que rotar. Los clientes que prefieran una credencial estática pueden enviar un encabezado X-API-Key en su lugar.

Las cuentas de la región de EE. UU. usan https://mcp.routebase.dev/?region=us. Si esto se configura incorrectamente, aparecerá como un conector sin herramientas, no como un error.

Puente stdio

Para clientes que solo lanzan procesos locales:

ROUTEBASE_API_KEY=rb_… npx routebase-mcp

Genera una clave de API en Routebase en Configuración → Claves de API. La configuración interactiva escribe la configuración correcta por ti:

npx routebase-mcp init

O agrégalo manualmente. Claude Code (.mcp.json) y Cursor (.cursor/mcp.json) aceptan el mismo bloque:

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

Codex lee ~/.codex/config.toml, el mismo archivo para la CLI y la extensión del IDE:

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

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

VS Code no necesita el puente, porque habla Streamable HTTP por sí mismo. Su .vscode/mcp.json lee la clave de nivel superior servers en lugar de mcpServers, requiere type en cada entrada y expande solo ${input:…}, por lo que la clave permanece fuera del archivo confirmado. Consulta la guía de inicio rápido de MCP para ver el bloque completo.

Variable de entorno	Requerida	Descripción
`ROUTEBASE_API_KEY`	✅	Clave de API para autenticación. Crea una en Configuración → Claves de API.
`ROUTEBASE_REGION`	Cuentas de EE. UU.	Región de origen de tu cuenta: `us` o `eu` (predeterminado: `eu`). Sin ella, una clave de EE. UU. falla como si fuera inválida.
`ROUTEBASE_LOG_LEVEL`	–	`verbose` · `debug` · `info` · `warning` · `error` · `fatal` (predeterminado: `warning`). Los registros van a stderr: stdout está reservado para el protocolo MCP.

Cómo funciona el puente stdio

El paquete npm es un pequeño shim. En la primera ejecución, descarga el binario CLI autónomo para tu plataforma desde releases.routebase.dev, lo verifica contra una suma de verificación SHA-256 incorporada en el paquete en el momento de la publicación (se niega a ejecutarse si hay discrepancia: cierre ante fallo) y lo almacena en caché en ~/.routebase/bin/<version>/.

Plataformas compatibles: macOS (arm64, x64), Windows (x64), Linux (x64). Requiere Node.js ≥ 18.

Qué hay en este repositorio

Archivo	Propósito
`bin/routebase-mcp.js`	El shim stdio publicado como el paquete npm `routebase-mcp`
`server.json`	Manifiesto para el Registro MCP (`dev.routebase/routebase`)
`plugin.json`, `mcp.json`	Manifiestos de Agent Plugins 1.0
`package.json`, `checksums.json`	Los metadatos del paquete publicado y las sumas de verificación SHA-256 de los binarios a los que está vinculada esta versión

Este repositorio refleja el conector tal como se publica, y cada archivo en él es escrito por el pipeline de lanzamiento en el repositorio propio de Routebase. Cada lanzamiento envía el contenido exacto del paquete npm aquí y lo etiqueta, por lo que los cambios realizados aquí no llegarán a npm; abre un issue en lugar de un pull request.

Enlaces

Producto: https://routebase.dev/mcp-server/
Guía de inicio rápido de MCP para cada cliente: https://docs.routebase.dev/mcp-quickstart/
Claves de API y alcances: https://docs.routebase.dev/mcp-authentication/
Referencia de CLI: https://docs.routebase.dev/mcp-cli-reference/
npm: https://www.npmjs.com/package/routebase-mcp

Licencia

El shim en este repositorio es MIT. El binario CLI de Routebase descargado se rige por los Términos de Routebase.