Como conectar o Claude ou o ChatGPT ao Pixel (MCP)
O Conector de IA (MCP) liga o Pixel do Afiliado a assistentes como Claude, ChatGPT, Cursor e VS Code. Você pergunta em português — "qual campanha deu mais lucro esta semana?" — e a IA responde com os números da sua conta. A conexão é por login, sem API key para copiar e guardar.
Antes de começar
- Plano: as perguntas (leitura) funcionam em qualquer plano. Pedir para a IA pausar ou reativar campanha, mudar orçamento ou URL e reenviar conversões exige o plano Pro — veja planos e cobrança.
- Conexões com dados: a IA lê o que o Pixel já tem. Com a Shopee e o Meta Ads conectados, ela responde sobre vendas, comissão e ROAS por campanha.
- Papel na organização: qualquer membro faz perguntas; só o dono ou um administrador consegue alterar campanhas pela IA.
- Cliente de IA com conectores MCP: Claude.ai, ChatGPT, Cursor, VS Code, Claude Code ou Claude Desktop. No ChatGPT, adicionar servidor MCP pode exigir plano ou o modo de desenvolvedor dele.
Passo a passo
1. Abra o Conector de IA (MCP)
No menu lateral, clique em Conexões e depois em Gerenciar no cartão Conector de IA (MCP).
2. Copie a URL do servidor MCP
No topo do diálogo, em URL do servidor MCP, clique em Copiar URL. O endereço é https://app.pixeldoafiliado.com/mcp.
Conexões
Conector de IA (MCP)
Pergunte em linguagem natural sobre campanhas, vendas, comissões, ROAS e conversões. Ao adicionar, o cliente abre o navegador para você entrar na sua conta.
Conectar por login (web)
Claude.aiLogin
Adicione como conector personalizado e faça login.
ChatGPTLogin
Conectores → adicionar servidor MCP (pode exigir plano/modo dev).
Apps locais — instalação rápida
Cursor1 clique
Adiciona o servidor automaticamente (pede confirmação).
VS Code1 clique
Instala no VS Code (Copilot / agent mode).
3. Adicione no seu cliente de IA
O diálogo tem um atalho para cada cliente:
- Claude.ai: clique em Abrir conectores do Claude, adicione um conector personalizado e cole a URL copiada.
- ChatGPT: clique em Abrir conectores do ChatGPT e, em Conectores, adicione um servidor MCP com a URL copiada.
- Cursor: clique em Adicionar ao Cursor. O Cursor abre e pede confirmação para instalar o servidor.
- VS Code: clique em Instalar no VS Code (ou Insiders, se usa essa versão). Também dá para copiar o comando
code --add-mcpque aparece logo abaixo. - Claude Code: copie e rode no terminal o comando
claude mcp add --transport http pixel-do-afiliado https://app.pixeldoafiliado.com/mcp. - Claude Desktop: clique em Copiar config e cole o bloco no arquivo
claude_desktop_config.json.
4. Entre e permita o acesso
Ao adicionar, o cliente abre o navegador para você entrar na sua conta do Pixel do Afiliado. Depois de entrar, aparece a tela "… quer conectar ao seu Pixel do Afiliado", com o nome do cliente e a lista Isso vai permitir que …:
- Ler campanhas, vendas, comissões, conversões, ROAS e o status do CAPI;
- Pausar/ativar campanhas, ajustar orçamento e URL, disparar sync e CAPI.
Confira a linha Ao autorizar, o acesso é enviado para …: ela diz para onde o acesso vai. Se for o cliente que você está conectando, clique em Permitir; se não reconhecer, clique em Cancelar.
5. Pergunte
Com o conector ligado, pergunte do jeito que perguntaria a alguém da equipe. A IA escolhe a ferramenta do Pixel que responde — por exemplo, pixel_get_roas para ROAS por campanha, conjunto ou anúncio — e traz os números da sua conta. Quando o período não é dito, ela usa os últimos 30 dias.
- "Qual campanha deu mais lucro nos últimos 7 dias?"
- "Quais produtos mais venderam este mês?"
- "Quantas conversões foram enviadas ao Meta e alguma falhou?"
- "Compare o ROAS de cada conjunto da campanha Casa e Cozinha."
Para mudar algo, peça normalmente: a IA primeiro simula e mostra o efeito, sem alterar nada, e só executa depois que você confirma. Na conversa abaixo, a simulação aparece como pixel_set_budget · dry_run antes da pergunta de confirmação.
Qual campanha deu mais lucro nos últimos 7 dias?
pixel_get_roasCasa e Cozinha - Advantage+: R$ 1.523,40 de comissão para R$ 412,90 investidos. Lucro de R$ 1.110,50, ROAS de 369% (3,69x). O melhor anúncio dela é Mixer portátil - vídeo 01.
Aumenta 20% no orçamento dela.
pixel_set_budget · dry_runSimulei a mudança: o orçamento diário de Casa e Cozinha - Advantage+ passa de R$ 72,00 para R$ 86,40. Nada foi alterado ainda. Confirma que eu aplico?
O que pode dar errado
- A IA responde "Esta ação exige o plano Pro para EXECUTAR (dry_run:true continua disponível para pré-visualizar). O upgrade é feito em Plano, no painel." Você pediu uma alteração fora do plano Pro. As perguntas continuam funcionando; a simulação também.
- "Sem permissão para alterar a organização." O seu usuário é membro, não dono nem administrador. Consultas funcionam; alterações, não.
- "redirect_uri não permitido. Clientes MCP oficiais, apps locais e loopback são aceitos." O cliente que tentou se conectar não é aceito pelo Pixel. Use um dos clientes listados no diálogo.
- A tela de permissão avisa "Este aplicativo não registrou um endereço de retorno reconhecível. Autorize apenas se você conhece a origem." O Pixel não conseguiu confirmar para onde o acesso vai. Se não foi você que acabou de adicionar o conector, clique em Cancelar.
- "ID inválido: use apenas o identificador numérico da Meta." A IA tentou agir numa campanha usando o nome em vez do ID. Peça para ela listar as campanhas primeiro e usar o ID que veio da lista.
- "Usuário sem organização." A conta usada no login não tem organização no Pixel. Entre com a conta que você usa no painel.
Para desligar o acesso, remova o conector nas configurações do próprio cliente de IA.
Tutoriais relacionados
- Como criar uma automação por ROAS
- Como ler a tela Meta Ads: ROAS, comissão e lucro
- Dashboard e Relatórios: o que cada número significa
Perguntas frequentes
Preciso gerar uma API key para conectar a IA?
Não. O Conector de IA (MCP) funciona por login: ao adicionar o servidor, o cliente de IA abre o navegador, você entra na sua conta do Pixel do Afiliado e clica em Permitir.
A IA pode mexer nas minhas campanhas sem eu pedir?
As ferramentas que alteram campanha, orçamento ou URL simulam por padrão e só executam quando a IA envia a confirmação explícita, depois do seu OK. Executar exige o plano Pro e um usuário dono ou administrador da organização.
Quais clientes de IA funcionam com o Pixel do Afiliado?
O diálogo do Conector de IA (MCP) traz atalhos para Claude.ai, ChatGPT, Cursor, VS Code, Claude Code e Claude Desktop. Qualquer cliente oficial que aceite servidor MCP remoto com login também se conecta pela URL do servidor.