Pular para o conteúdo principal

Conectando uma AI externa (MCP)

Além do Analista AI integrado, o Qubix pode ser conectado ao seu próprio assistente de AI — Claude Desktop, Claude Code, Cursor ou qualquer cliente que suporte MCP (Model Context Protocol). O assistente então responde a perguntas sobre as suas campanhas usando dados ao vivo — com exatamente o mesmo acesso e as mesmas permissões que você tem na interface.

O que você precisa​

  • Um token pessoal (PAT) — crie-o na página MCP/API. Mais — MCP/API.
  • O seu endereço do Qubix no formato https://<your-domain>/api/mcp.
O token é mostrado uma única vez

O token é mostrado apenas no momento em que você o cria. Copie-o imediatamente e guarde-o em segurança — o Qubix armazena apenas o hash dele e não pode mostrá-lo novamente. Perdeu-o? Pressione Regenerar para obter um novo (o antigo para de funcionar imediatamente).

Como conectar​

Você precisa de duas coisas: o endereço https://<your-domain>/api/mcp e o cabeçalho Authorization: Bearer <your-token>. O resto depende do cliente.

Claude Code (CLI)​

Bash
claude mcp add --transport http qubix https://<your-domain>/api/mcp \
  --header "Authorization: Bearer qbx_YOUR_TOKEN"

Reinicie o Claude Code — as ferramentas do Qubix ficam disponíveis no chat.

Claude Desktop​

Abra Settings → Connectors → Add custom connector, defina o endereço https://<your-domain>/api/mcp e adicione o cabeçalho Authorization: Bearer qbx_YOUR_TOKEN.

Cursor​

Adicione o servidor a ~/.cursor/mcp.json (ou ao .cursor/mcp.json do projeto):

JSON
{
  "mcpServers": {
    "qubix": {
      "url": "https://<your-domain>/api/mcp",
      "headers": { "Authorization": "Bearer qbx_YOUR_TOKEN" }
    }
  }
}

O que o assistente pode fazer​

Uma vez conectado, o assistente pode ler a sua analítica e executar ações — tudo dentro das suas permissões:

  • Analítica — o painel, geo, ofertas, redes, fontes de tráfego, as telas do Facebook, o funil de visitantes e um drill-down para qualquer anúncio, campanha, oferta, criativo, PWA, geo ou fonte de tráfego individual.
  • Criativos — busca semântica ("encontre criativos parecidos com um screenshot de fake-chat") e os temas de criativos com melhor desempenho.
  • Britva — visualizar as regras de automação, anúncios pausados e o histórico de disparos; criar, editar e publicar regras.
  • Ações — pausar e retomar anúncios e campanhas; gerenciar ofertas, redes, fontes de tráfego e campanhas do tracker.
  • Consultas livres — para perguntas que as ferramentas prontas não cobrem.
Apenas os seus dados

O assistente vê exatamente o que você vê na interface: um admin obtém a conta inteira, um buyer obtém apenas os dados da sua equipe. As ações são limitadas pelas suas permissões, exatamente como no painel de administração.

As ações são reais

Pausar um anúncio, excluir uma regra ou uma oferta através do assistente altera as suas campanhas reais. Em clientes de chat, essas ações são executadas apenas após a sua confirmação — leia o que o assistente propõe antes de aprovar.

Segurança​

  • O token é a sua chave de acesso — trate-o como uma senha, não o coloque em arquivos compartilhados ou repositórios públicos.
  • Um token por usuário. Para revogar o acesso, abra a página MCP/API e pressione Revogar (ou Regenerar para substituí-lo).

O que vem a seguir​

Chat do Analista AI

o assistente integrado, sem necessidade de configuração.

MCP/API

o endpoint, o seu token e o catálogo completo de métodos.

AI (visão geral)

os dados do analista por trás das ferramentas.

On this page