Início›Central de ajuda›Como conectar o Claude ou o ChatGPT ao Pixel (MCP)

Como conectar o Claude ou o ChatGPT ao Pixel (MCP)

Otimizar e automatizar · atualizado em 26/09/2026

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.

Diálogo Conector de IA (MCP): a URL do servidor com o botão Copiar URL, os atalhos para Claude.ai e ChatGPT e a instalação rápida no Cursor e no VS Code.

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-mcp que 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.

Conversa com uma IA ligada pelo Conector de IA: a resposta sobre a campanha de maior lucro sai da ferramenta pixel_get_roas, e o pedido de aumento de orçamento é simulado antes de qualquer alteração.

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

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.