Servidor MCP en modo HTTP para despliegues remotos

Cómo correr el servidor MCP de Omnifox como servicio HTTP para Composio, Railway, Fly o Kubernetes, con sus dos endpoints reales.

Aug 19, 2026

Mira este paso en el video · Probar el servidor MCP con el Inspector

Además del modo stdio que usan los clientes de escritorio, el servidor MCP de Omnifox puede correr como servicio HTTP. Es la forma de usarlo desde plataformas alojadas como Composio o desde tu propia infraestructura (Railway, Fly, Kubernetes, un contenedor cualquiera).

Arrancarlo

MCP_SERVER_MODE=http \
PORT=8080 \
OMNIFOX_API_KEY=tu-token-aqui \
npx @omnifox/mcp-server

Endpoints

  • POST /mcp — todo el tráfico MCP, con transporte Streamable HTTP sin estado: cada petición crea su propio servidor y su propio transporte, y se destruyen al cerrar la respuesta. Eso permite escalar horizontalmente sin sesiones pegajosas.
  • GET /health — sonda de vida. Devuelve 200 con { "status": "ok", ... }, el nombre del servicio y una marca de tiempo.

GET /mcp y DELETE /mcp responden 405: no se usan en modo sin estado.

El servidor acepta CORS desde cualquier origen y cuerpos de hasta 4 MB.

Registrarlo en Composio

En la integración MCP de Composio, registra la URL pública de tu despliegue terminada en /mcp, por ejemplo https://mcp.tuempresa.com/mcp.

Advertencia de seguridad

El servidor no autentica a quien lo llama: el token de Omnifox va en su variable de entorno, no lo aporta el cliente MCP. Es decir, cualquiera que alcance tu POST /mcp opera sobre tu espacio de trabajo con esos permisos.

Si lo publicas en internet, ponlo detrás de algo que controle el acceso: una red privada, un proxy con autenticación, una lista de IP permitidas o el propio control de acceso de la plataforma que lo aloja. No lo dejes expuesto sin protección.

Verificación

curl -s https://tu-host.ejemplo.com/health

Una respuesta 200 con "status": "ok" confirma que el proceso está vivo. Ten en cuenta que /health responde igual aunque el token de Omnifox sea inválido: solo prueba el proceso, no las credenciales.

Si algo no funciona

  • El proceso arranca y se cae al instante: falta OMNIFOX_API_KEY; el servidor se niega a iniciar sin ella.
  • 405 al conectar: tu cliente está haciendo GET /mcp; el modo sin estado solo acepta POST.
  • Timeouts con cargas grandes: sube OMNIFOX_TIMEOUT_MS y revisa el límite de tiempo del proxy que tengas delante.
  • 413: el cuerpo supera los 4 MB.

Consejos

  • Usa GET /health como liveness probe en Kubernetes o en tu balanceador.
  • Un despliegue por espacio de trabajo, cada uno con su token: es más simple de auditar y de revocar.

Artículos relacionados

¿Te fue útil?

Artículos relacionados

Escríbenos por WhatsApp