Como conectar o X Ads (Twitter Ads) ao Gemini

App Gemini, conta pessoal. Abra gemini.google.com, vá em Settings, depois Connected Apps (se não aparecer, abra Personal Intelligence primeiro) e, em Custom apps, escolha Add a custom app.

Cole a URL do servidor do PaidSync e clique em Next. O PaidSync se registra sozinho, então não há API key para copiar e nada para preencher em Advanced features.

Adicione uma vez na web e funciona também no app móvel do Gemini. O Google limita apps personalizados a contas pessoais do Google, com 18 anos ou mais, nos EUA, em inglês, com Keep Activity ativado.

Uma conta de trabalho ou escola não pode adicioná-los, então use o Gemini Enterprise abaixo.

Gemini CLI. Execute o comando, depois digite /mcp auth paidsync e entre com o login do PaidSync.

O Google substituiu o Gemini CLI pelo Antigravity CLI para usuários do nível gratuito e do Google One em 18 de junho de 2026, então essas contas usam o Antigravity abaixo.

O modo agente do Gemini Code Assist no VS Code lê o mesmo arquivo de configurações do Gemini CLI. Adicione isto ao ~/.gemini/settings.json:

O Antigravity usa uma chave diferente.

Abra o menu do painel do agente, escolha MCP Servers, depois Manage MCP Servers e View raw config, ou edite ~/.gemini/config/mcp_config.json, e adicione o servidor com serverUrl.

O Antigravity faz o login sozinho por registro dinâmico de cliente:

Gemini Enterprise, edição Business. Um administrador da equipe adiciona o PaidSync em Settings and help, depois Manage team, depois Connected apps, depois Add MCP Server.

O PaidSync oferece o transporte Streamable HTTP exigido pelo Gemini e OAuth 2.0 em https://api.paidsync.ai/authorize e https://api.paidsync.ai/token.

Envie um e-mail para support@paidsync.ai para obter as credenciais de cliente que esse formulário pede.

A tela de login do PaidSync abre. Escolha Continue with Google ou entre com seu e-mail e senha do PaidSync. Uma tela do PaidSync então pergunta se você permite que o Gemini gerencie suas contas de anúncios pelo PaidSync. Clique em Aprovar e o PaidSync está conectado.

Novo no PaidSync e entrando com o Google? Sua conta gratuita (100 tarefas, sem cartão de crédito) é criada quando você clica em Aprovar. A tela também menciona contas de anúncios já conectadas dentro do PaidSync. Em uma conta nova, essa lista fica vazia até você concluir o passo 3.

Em qualquer chat, peça: “Conectar meu X Ads.” O Gemini responde com um link. Ele abre a tela própria de login e autorização do X. Entre com a conta do X que abre suas contas de anúncios e autorize o PaidSync. O PaidSync nunca vê a sua senha do X.

Volte e peça: “Listar minhas contas de anúncios do X.” O Gemini usa list_x_accounts para mostrá-las e set_active_x_account para escolher a que você citar. Conectar o X, listar suas contas de anúncios e escolher uma não consome nenhuma das suas tarefas. Depois experimente: “Mostre o desempenho das minhas campanhas do X nos últimos 7 dias.”

Gasto, impressões, cliques e engajamentos por conta, campanha ou item de linha em qualquer período, na moeda e no fuso horário da conta de anúncios.

Campanhas, itens de linha e posts promovidos da conta de anúncios que você escolheu.

Campanhas com pause_x_campaign e enable_x_campaign, e itens de linha por meio de update_x_line_item.

Orçamentos diários de campanha com update_x_campaign_budget, lances de itens de linha e nomes de campanhas e itens de linha.

Sem novas campanhas, itens de linha ou posts promovidos, e sem upload de criativos. Crie tudo isso no X Ads Manager.

O PaidSync não tem ferramenta do X para segmentação, públicos personalizados ou relatórios de conversão.

O X tem um em ads-api.x.com/mcp para o X Ads. A página de configuração dele pede que você crie um app de desenvolvedor do X com acesso à API de anúncios e use o client ID OAuth 2.0 dele, e cita Grok e Claude Code como clientes (verificado em 30 set 2026).

A página do Zapier sobre a integração do Twitter diz que ela foi descontinuada em 31 de agosto de 2023 (verificado em 30 set 2026).

O nó X (Formerly Twitter) do n8n cobre posts, mensagens diretas, usuários e listas, e a documentação dele não lista operações de anúncios (verificado em 30 set 2026).

Escreva um servidor MCP sobre a API do X Ads, registre um app de desenvolvedor do X e hospede e mantenha tudo você mesmo.

Entre no PaidSync do mesmo jeito que se cadastrou, com Continue with Google ou com seu e-mail e senha do PaidSync.

Quem usa e-mail e ainda não tem conta cria uma em paidsync.ai/signup e depois adiciona o PaidSync no Gemini de novo. Se a tela de autorização do X falhar, peça ao Gemini “Conectar meu X Ads” de novo para receber um link novo.

Peça ao Gemini para listar suas contas de anúncios do X e trocar para a que você quer, por nome ou ID. Ele executa list_x_accounts e depois set_active_x_account, e toda solicitação ao X a partir daí vai para a conta que você escolheu. Trocar não consome nenhuma das suas tarefas.

O PaidSync lista as contas de anúncios que a conta do X que você autorizou consegue abrir. Confira no X Ads Manager se essa conta do X tem acesso à conta de anúncios, ou peça a um administrador da conta para adicioná-la, e depois peça ao Gemini para listar suas contas de anúncios de novo. Ainda não aparece? Escreva para support@paidsync.ai.

O PaidSync mostra ao Gemini uma lista inicial curta de ferramentas para manter o chat leve. Peça ao Gemini para chamar paidsync_context antes de qualquer outra coisa. Ela retorna suas plataformas conectadas e a lista completa de ferramentas, X incluído, e o Gemini então executa essas ferramentas por meio de paidsync_exec. Se o PaidSync não aparece no Gemini, confira se ele consta em Configurações, depois Apps conectados.