Servidor MCP em modo HTTP para implantações remotas

Como rodar o servidor MCP da Omnifox como serviço HTTP para Composio, Railway, Fly ou Kubernetes, com os seus dois endpoints reais.

Aug 19, 2026

Veja este passo no vídeo · Testar o servidor MCP com o Inspector

Além do modo stdio que os clientes de desktop usam, o servidor MCP da Omnifox pode rodar como serviço HTTP. É a forma de usá-lo a partir de plataformas hospedadas como o Composio ou a partir da sua própria infraestrutura (Railway, Fly, Kubernetes, um contêiner qualquer).

Iniciar

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

Endpoints

  • POST /mcp — todo o tráfego MCP, com transporte Streamable HTTP sem estado: cada requisição cria o próprio servidor e o próprio transporte, e ambos são destruídos ao fechar a resposta. Isso permite escalar horizontalmente sem sessões grudentas.
  • GET /health — sonda de vida. Devolve 200 com { "status": "ok", ... }, o nome do serviço e um carimbo de tempo.

GET /mcp e DELETE /mcp respondem 405: não são usados no modo sem estado.

O servidor aceita CORS de qualquer origem e corpos de até 4 MB.

Registrar no Composio

Na integração MCP do Composio, registre a URL pública da sua implantação terminada em /mcp, por exemplo https://mcp.tuempresa.com/mcp.

Aviso de segurança

O servidor não autentica quem o chama: o token da Omnifox vai na variável de ambiente dele, não é fornecido pelo cliente MCP. Ou seja, qualquer pessoa que alcance o seu POST /mcp opera sobre o seu espaço de trabalho com essas permissões.

Se você publicá-lo na internet, coloque-o atrás de algo que controle o acesso: uma rede privada, um proxy com autenticação, uma lista de IPs permitidos ou o próprio controle de acesso da plataforma que o hospeda. Não o deixe exposto sem proteção.

Verificação

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

Uma resposta 200 com "status": "ok" confirma que o processo está vivo. Leve em conta que o /health responde igual mesmo que o token da Omnifox seja inválido: ele só testa o processo, não as credenciais.

Se algo não funcionar

  • O processo inicia e cai na hora: falta o OMNIFOX_API_KEY; o servidor se recusa a iniciar sem ele.
  • 405 ao conectar: seu cliente está fazendo GET /mcp; o modo sem estado só aceita POST.
  • Timeouts com cargas grandes: aumente o OMNIFOX_TIMEOUT_MS e revise o limite de tempo do proxy que estiver na frente.
  • 413: o corpo passa dos 4 MB.

Dicas

  • Use GET /health como liveness probe no Kubernetes ou no seu balanceador.
  • Uma implantação por espaço de trabalho, cada uma com o seu token: é mais simples de auditar e de revogar.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp