O que é o servidor MCP da Omnifox e para que serve
O servidor MCP da Omnifox conecta o Claude, o Cursor e outros assistentes de IA ao seu espaço de trabalho para que leiam e escrevam na sua caixa de entrada, contatos, CRM e agenda.
Veja este passo no vídeo · MCP: que uma IA opere o Omnifox
O Model Context Protocol (MCP) é um padrão aberto que permite que um assistente de IA use ferramentas externas. O servidor MCP da Omnifox é o pacote oficial que traduz a API REST da Omnifox para essas ferramentas: uma vez conectado, seu assistente pode ler conversas, responder mensagens, criar contatos, mover oportunidades do CRM, agendar compromissos ou registrar pedidos do catálogo, sem que você escreva uma única linha de código.
O pacote se chama @omnifox/mcp-server e é publicado no npm. A versão 0.4.0 expõe 72 ferramentas distribuídas em contatos, mensageria, conversas, notas internas, espaço de trabalho, agenda, catálogo e pedidos, fluxos, disparos em massa, webhooks e relatórios.
Para que serve
- Operar a caixa de entrada a partir do seu assistente. "Busque a conversa da Maria, resuma e responda que o pedido dela sai amanhã."
- Consultar dados sem abrir a Omnifox. "Quantas conversas novas houve esta semana por canal?"
- Automatizar tarefas repetitivas. Etiquetar, atribuir a uma equipe, adiar conversas ou encerrar threads com uma resolução.
- Construir seus próprios agentes. Qualquer cliente MCP (Claude Desktop, Cursor, Continue, Composio, SDKs de agentes) pode ser montado sobre essas ferramentas.
O que você precisa
- Um plano com Acesso à API: disponível a partir do Crece (Crece, Escala e Exclusivo). Os planos Lite, Impulsa e Conecta não incluem.
- Uma chave de API (token pessoal) criada em Configurações → Desenvolvimento → API Keys.
- Node.js 18.17 ou superior no computador ou servidor onde o assistente roda.
- Um cliente compatível com MCP.
Como se conecta, em resumo
O servidor não é instalado dentro da Omnifox: ele roda do lado do cliente de IA. Na configuração do seu cliente você declara o comando npx -y @omnifox/mcp-server e passa o seu token na variável OMNIFOX_API_KEY. O cliente inicia o servidor, descobre as 72 ferramentas e, a partir daí, o modelo as usa quando for necessário.
O que ele NÃO faz
- Não faz upload de arquivos: as ferramentas de mensageria enviam anexos por URL pública, não por upload direto.
- Não expõe o módulo Team nem o Co-browse.
- Não substitui os agentes de IA da Omnifox, que vivem dentro da plataforma e respondem sozinhos aos seus clientes. O servidor MCP serve para que o seu assistente trabalhe sobre a Omnifox.
Dicas
- Crie uma chave de API exclusiva para o servidor MCP, com as permissões mínimas. Se algum dia você quiser cortar o acesso, basta revogá-la sem mexer nas suas outras integrações.
- O token fica preso a um único espaço de trabalho. Se você trabalha com vários, precisa de uma chave por espaço.
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.