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.
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. Devolve200com{ "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. 405ao conectar: seu cliente está fazendoGET /mcp; o modo sem estado só aceitaPOST.- Timeouts com cargas grandes: aumente o
OMNIFOX_TIMEOUT_MSe revise o limite de tempo do proxy que estiver na frente. 413: o corpo passa dos 4 MB.
Dicas
- Use
GET /healthcomo 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
Artigos relacionados
-
Como conectar integrações e apps externos
Conecte o Omnifox às suas ferramentas favoritas a partir do catálogo de integrações em poucos passos.
-
Integrar o Omnifox com Azur, Siigo, Alegra, QuickBooks ou outro sistema contábil ou ERP
O Omnifox não tem hoje um conector nativo com sistemas contábeis ou ERP. Veja como fazer essa conexão mesmo assim com fluxos de trabalho, o nó HTTP, n8n, Make, Zapier ou a API, com exemplos.
-
Guia completo de integrações e API
Integrações e API a fundo, em 30 capítulos: chaves de API, chamadas reais, webhooks assinados, n8n, MCP e SDKs, tudo funcionando de verdade.
-
Gerar e usar API keys e webhooks
Crie chaves de API para acessar o Omnifox por código e configure webhooks para receber eventos em tempo real.
-
Introdução às integrações (webhook / OAuth / chave de API)
Conecte o Omnifox às suas outras ferramentas: o que está disponível hoje, o que chega em breve e quando usar um webhook, uma conexão OAuth ou uma chave de API.