Conectar o servidor MCP da Omnifox ao Claude Desktop, Cursor ou Continue
Configuração passo a passo do servidor MCP da Omnifox nos clientes de desktop mais usados, com os arquivos e os caminhos reais de cada um.
Veja este passo no vídeo · Testar o servidor MCP com o Inspector
O servidor MCP da Omnifox roda na sua máquina através do npx, então não há nada para instalar manualmente: basta declará-lo no arquivo de configuração do seu cliente de IA e reiniciá-lo.
Antes de começar
- Plano com Acesso à API (a partir do Crece).
- Node.js 18.17 ou superior instalado (
node -vpara conferir). - Uma chave de API criada em Configurações → Desenvolvimento → API Keys. Copie no momento da criação: ela só é exibida uma vez.
Claude Desktop
- Abra o arquivo
claude_desktop_config.json:- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
- Adicione o bloco
omnifoxdentro demcpServers:
{
"mcpServers": {
"omnifox": {
"command": "npx",
"args": ["-y", "@omnifox/mcp-server"],
"env": {
"OMNIFOX_API_KEY": "tu-token-aqui"
}
}
}
}
- Salve o arquivo e feche e abra o Claude Desktop por completo.
Cursor
- Na raiz do seu projeto, crie ou edite
.cursor/mcp.json. - Use exatamente o mesmo bloco
mcpServersdo exemplo anterior. - Reinicie o Cursor.
Continue
- Edite
~/.continue/config.json. - Adicione o servidor em
experimental.modelContextProtocolServers:
{
"experimental": {
"modelContextProtocolServers": [
{
"transport": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@omnifox/mcp-server"],
"env": { "OMNIFOX_API_KEY": "tu-token-aqui" }
}
}
]
}
}
- Reinicie o Continue.
Verificação
Peça ao seu assistente algo simples que obrigue o uso de uma ferramenta, por exemplo: "liste os canais conectados na Omnifox". Se ele responder com os seus canais reais, a conexão está funcionando. A primeira chamada pode demorar alguns segundos porque o npx baixa o pacote.
Se algo não funcionar
- O cliente não mostra as ferramentas: quase sempre falta reiniciar o aplicativo por completo, não só fechar a janela.
OMNIFOX_API_KEY is required: o blocoenvestá mal escrito ou o token ficou vazio.- Todas as chamadas dão 401: o token expirou, foi revogado ou foi copiado com espaços no início ou no fim.
- Todas dão 402 ou
PLAN_API_ACCESS_REQUIRED: seu plano não inclui Acesso à API. npxnão existe: falta o Node.js, ou o cliente inicia com um PATH que não o enxerga; use o caminho absoluto donpxemcommand.
Dicas
- Não guarde o token em um arquivo que você suba para um repositório: o
.cursor/mcp.jsoncostuma ficar versionado. - Se você trabalha com mais de um espaço de trabalho, declare um servidor por espaço com nomes diferentes (
omnifox-ventas,omnifox-soporte) e uma chave para cada um.
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.