> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Autohospedar MCP Gateway

> Ejecuta MCP Gateway en tu máquina para que Cursor, Codex y Claude Code llamen a una API en vivo o a la API de tu rama actual

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? <a href="#install" id="install" />

El proyecto está en GitHub: [Fetch-Hive/openapi-mcp](https://github.com/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? <a href="#local-api" id="local-api" />

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? <a href="#live-api" id="live-api" />

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](https://github.com/Fetch-Hive/openapi-mcp/blob/main/docs/deploy/README.md). 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](overview) 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

* [Descripción general de MCP Gateway](overview)
* [Crear un servidor MCP alojado desde OpenAPI](create-from-openapi)
* [Usar un MCP Gateway alojado con un agente](use-with-agents)