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.
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. Devuelve200con{ "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. 405al conectar: tu cliente está haciendoGET /mcp; el modo sin estado solo aceptaPOST.- Timeouts con cargas grandes: sube
OMNIFOX_TIMEOUT_MSy revisa el límite de tiempo del proxy que tengas delante. 413: el cuerpo supera los 4 MB.
Consejos
- Usa
GET /healthcomo 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
Artículos relacionados
-
Cómo conectar integraciones y apps externas
Conecta Omnifox con tus herramientas favoritas desde el catálogo de integraciones en pocos pasos.
-
Guía completa de integraciones y API
Integraciones y API a fondo, en 30 capítulos: claves API, llamadas reales, webhooks firmados, n8n, MCP y SDK, todo funcionando de verdad.
-
Integrar Omnifox con Azur, Siigo, Alegra, QuickBooks u otro sistema contable o ERP
Omnifox no tiene hoy un conector nativo con sistemas contables o ERP. Te explicamos cómo conectarlos igual con workflows, el nodo HTTP, n8n, Make, Zapier o la API, con ejemplos.
-
Generar y usar API keys y webhooks
Crea claves de API para acceder a Omnifox por código y configura webhooks para recibir eventos en tiempo real.
-
Introducción a las integraciones (webhook / OAuth / API key)
Conecta Omnifox con tus otras herramientas: qué está disponible hoy, qué llega pronto y cuándo usar un webhook, una conexión OAuth o una clave de API.