Skip to main content
Puedes ejecutar MCP Gateway en local en lugar del producto alojado. La CLI de código abierto compila un documento OpenAPI y sirve herramientas MCP por Streamable HTTP o stdio. Úsalo de dos formas, las dos de primer nivel:
  • API en vivo — compilas un OpenAPI público y apuntas el editor al gateway.
  • API en WIP / rama — el servidor ya corre en esta máquina (localhost, una red Docker). Apuntas el gateway a ese origen para que Cursor, Codex o Claude Code ejerciten la rama que estás editando.

​
¿Cómo lo instalo?

El proyecto está en GitHub: Fetch-Hive/openapi-mcp. Instálalo con Homebrew, Docker, npx, el instalador curl o cargo install; el README lista los comandos actuales.

​
¿Cómo conecto una API local o de rama?

  1. Ejecuta mcp-gateway init --allow-private-networks para permitir loopback y redes privadas.
  2. Añade la spec desde un archivo del repo: mcp-gateway add-spec --name demo --file ./openapi.yaml --base-url http://127.0.0.1:3000 --insecure-http. --base-url es este checkout, no producción.
  3. Arranca mcp-gateway serve demo (por defecto http://127.0.0.1:8787/mcp).
  4. Pega mcp-gateway inspect demo --client cursor (o codex, claude-code, vscode) en el editor. El token de init va en MCP_GATEWAY_TOKEN.
--allow-private-networks es obligatorio para localhost. --insecure-http es obligatorio si la API habla HTTP.

​
¿Cómo conecto una API en vivo?

  1. Ejecuta mcp-gateway init (sin el flag de redes privadas).
  2. mcp-gateway add-spec --name demo --url https://… (o --file más --base-url https://api.example.com).
  3. mcp-gateway serve demo y los mismos snippets de inspect --client.
mcp-gateway doctor comprueba la configuración, los secretos, la caché IR local y la política SSRF.

​
¿Puedo desplegar en Render, Heroku, DigitalOcean o Hetzner?

Sí. El repositorio de GitHub incluye guías y botones de un clic para Render, Heroku y DigitalOcean App Platform, y Compose/cloud-init para un VPS en Hetzner: documentación de despliegue de openapi-mcp. Tras el despliegue, apunta el editor a https://<host>/mcp con el mismo token bearer. Vercel no puede ejecutar este servidor (es serverless, no un proceso persistente). Si no quieres operar un VPS, usa el MCP Gateway alojado para una API en vivo. El MCP Gateway alojado no hace proxy de localhost — usa la CLI en tu máquina para una API de rama. Define MCP_GATEWAY_TOKEN y MCP_GATEWAY_SPEC_URL (un documento OpenAPI en HTTPS). El contenedor lee PORT por sí mismo.

​
¿En qué se diferencia del MCP Gateway alojado?

El MCP Gateway alojado en Fetch Hive te da un panel, tokens de cliente, cuotas del plan y una URL pública /g/{slug} para APIs en vivo. En autohospedaje el proceso y los secretos quedan en tu máquina, y es como conectas un editor a un checkout local. Enlazar todas las interfaces requiere --expose. TLS es cosa de tu proxy inverso.

​
Relacionado