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.

Aug 19, 2026

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 -v para 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

  1. Abra o arquivo claude_desktop_config.json:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. Adicione o bloco omnifox dentro de mcpServers:
{
  "mcpServers": {
    "omnifox": {
      "command": "npx",
      "args": ["-y", "@omnifox/mcp-server"],
      "env": {
        "OMNIFOX_API_KEY": "tu-token-aqui"
      }
    }
  }
}
  1. Salve o arquivo e feche e abra o Claude Desktop por completo.

Cursor

  1. Na raiz do seu projeto, crie ou edite .cursor/mcp.json.
  2. Use exatamente o mesmo bloco mcpServers do exemplo anterior.
  3. Reinicie o Cursor.

Continue

  1. Edite ~/.continue/config.json.
  2. 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" }
        }
      }
    ]
  }
}
  1. 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 bloco env está 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.
  • npx não existe: falta o Node.js, ou o cliente inicia com um PATH que não o enxerga; use o caminho absoluto do npx em command.

Dicas

  • Não guarde o token em um arquivo que você suba para um repositório: o .cursor/mcp.json costuma 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

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp