Conecte o Merchant Center ao Claude Code com um comando
Claude Code
Para conectar o Merchant Center ao Claude Code, adicione o PaidSync.ai: rode claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp, digite /mcp e entre com seu login do PaidSync.
O Claude Code acessa suas contas do Merchant Center por 16 ferramentas: problemas de produtos, status da conta, desempenho, fontes de dados e alterações em produtos, feeds suplementares e vínculos do Google Ads. Ele pergunta antes de cada ferramenta.
Nível Configure. As escritas do Merchant Center não têm simulação e são aplicadas na primeira chamada, então mantenha o pedido do Claude Code ativo para ferramentas de escrita.
O comando
O Claude Code fala com servidores MCP remotos por Streamable HTTP. O PaidSync é um deles. Adicione uma vez e o mesmo terminal que edita seu código pode relatar e gerenciar suas campanhas do Merchant Center.
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpPor padrão, isso registra o servidor só para o projeto atual. Adicione --scope user para disponibilizá-lo em todos os projetos da sua máquina.
Execute claude mcp list para confirmar que ele está lá, depois inicie uma sessão e digite /mcp para entrar.
Configuração em 5 passos
1Cadastre-se em paidsync.ai/signup
Leva 10 segundos. Login com Google ou e-mail. O plano gratuito tem 100 tarefas por mês, no valor de $50, por $0, sem cartão.
2Conecte o Merchant Center no painel do PaidSync
Clique em Conectar no Merchant Center e entre com a conta do Google que tem acesso ao seu Merchant Center. O Merchant Center autoriza via Google OAuth com o escopo content, e o PaidSync nunca vê sua senha do Google.
Já está no Claude Code? Peça para ele executar connect_merchant_center. A ferramenta devolve um link para abrir no navegador.
3Escolha a conta de anúncios em que o Claude Code deve trabalhar
Dentro de uma sessão, list_merchant_accounts mostra as contas que o seu login do Google consegue abrir, incluindo subcontas de uma conta multicliente, e set_active_merchant_account escolhe aquela em que o Claude Code trabalha.
4Adicione o PaidSync ao Claude Code
No seu terminal, rode:
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpInicie uma sessão, digite /mcp, escolha paidsync e entre com o seu login do PaidSync na janela do navegador que abrir. O Claude Code guarda o token OAuth para você. Nenhuma chave é colada em lugar nenhum.
Configurando para uma equipe? Faça commit de um .mcp.json na raiz do repositório para que todo engenheiro receba o mesmo conector:
{
"mcpServers": {
"paidsync": { "type": "http", "url": "https://mcp.paidsync.ai/mcp" }
}
}Prefere uma chave de API, por exemplo para execuções sem interface? Envie-a em um cabeçalho, nunca na URL, onde ela iria parar nos logs:
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp --header "Authorization: Bearer $PAIDSYNC_API_KEY"Em um .mcp.json commitado, adicione "headers": { "Authorization": "Bearer ${PAIDSYNC_API_KEY}" } para que a chave fique no ambiente de cada engenheiro e nunca entre no git. Aplicar uma alteração no Google Ads ainda exige o login OAuth. Em outras plataformas, uma chave também pode aplicar alterações, então trate-a como uma senha e prefira OAuth.
5Teste a conexão
Em uma sessão do Claude Code, peça: “Quais problemas estão reprovando mais produtos no meu Merchant Center”
O Claude Code devolve o código, a gravidade, o destino, o país, o número de produtos afetados e as instruções de correção do Google para cada problema. A conexão está ativa.
O plano gratuito inclui 100 tarefas por mês. Pro a partir de $99 por mês, Team a partir de $249.
Prompts do Merchant Center no Claude Code
Cada prompt abaixo corresponde a ferramentas do grupo Merchant Center do PaidSync. O Claude Code escolhe a ferramenta. A última coluna indica se a chamada pode alterar algo na conta de anúncios.
| Pedido | Ferramentas que chama | Altera sua conta? |
|---|---|---|
| “Liste minhas contas do Merchant Center e defina a Acme como ativa” | list_merchant_accounts, set_active_merchant_account | Não |
| “Quais problemas estão reprovando mais produtos, e como corrijo cada um” | list_product_issues | Não |
| “Minha conta do Merchant Center corre risco” | get_merchant_account_status | Não |
| “Liste todas as contas do Google Ads vinculadas ao meu Merchant Center” | merchant_list_links | Não |
| “Quais produtos tiveram impressões mas nenhum clique nos últimos 28 dias” | get_product_performance | Não |
| “Liste meus produtos marcados como sem estoque, com o preço” | list_products | Não |
| “Crie um feed suplementar chamado Holiday Sale Prices para meus produtos dos EUA em inglês” | merchant_create_supplemental_feed | Sim, depois que você confirma |
Execute em modo headless com claude -p
A flag -p executa o Claude Code sem a sessão interativa. Entre uma vez por /mcp e o token OAuth guardado continua valendo. Um relatório que cai em um arquivo fica assim:
claude -p "Pull the Merchant Center product issues and write a list of the issues that disapprove the most products." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/merchant-center-$(date +%F).jsonAs leituras rodam direto, e as escritas também. --allowedTools "mcp__paidsync" permite todas as ferramentas do PaidSync, escritas incluídas, sem prompt.
Em uma tarefa sem supervisão, permita só as ferramentas de leitura de que ela precisa, cada uma pelo nome como mcp__paidsync__tool_name.
O que lê e o que grava
Das 16 ferramentas do Merchant Center, 9 só leem e 5 podem escrever. As leituras cobrem contas, problemas de produtos, status da conta, produtos, desempenho de produtos, vínculos e fontes de dados.
As escritas cobrem produtos, feeds suplementares e vínculos com o Google Ads. As escritas do Merchant Center não têm simulação e são aplicadas na primeira chamada, e exclusões de produtos e de vínculos não exigem sinalizador de confirmação.
Ler mais
Via MCP, a etapa de aprovação é o próprio prompt do Claude Code. Ele pergunta antes de executar uma ferramenta, a menos que você a tenha permitido com --allowedTools ou nas suas configurações. O PaidSync acrescenta verificações do seu lado. Exclusões, pausas e alterações de orçamento exigem confirm_destructive, e uma verificação de regras antes da gravação bloqueia argumentos inseguros. O cartão de aprovação, e o Undo em um cartão aplicado cuja alteração tem inverso seguro, valem apenas no workspace do PaidSync.
Adicionar ao ChatGPT: abra o PaidSync.ai no diretório de plugins do ChatGPT, instale e faça login.
Adicionar ao Claude: abra o PaidSync.ai no diretório de conectores do Claude, clique em Conectar e faça login.
O que o Claude Code não pode no Merchant Center
- As alterações no Merchant Center valem na primeira chamada, sem prévia, então mantenha o pedido do Claude Code ativo para ferramentas de escrita.
- A primeira solicitação a uma conta registra o PaidSync nela, o que exige acesso de administrador e leva cerca de 5 minutos para valer.
- Os relatórios do Merchant Center chegam com um a dois dias de atraso.
- O desempenho de produtos cobre até 1.000 produtos por solicitação.
- O PaidSync lista apenas as contas que o seu login do Google conectado consegue abrir.
Perguntas frequentes
Como conectar o Merchant Center ao Claude Code?
Crie sua conta em paidsync.ai, conecte o Merchant Center no painel e depois execute claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp no terminal. Digite /mcp dentro de uma sessão, escolha paidsync e entre com seu login do PaidSync.
O Claude Code consegue corrigir reprovações de produtos?
O Claude Code pode listar cada reprovação com o motivo e as instruções de correção. Para correções de atributos, o PaidSync pode atualizar produtos, e o Claude Code pergunta antes de executar cada ferramenta de escrita.
O PaidSync também conecta o Google Ads ao Claude Code?
Sim. O PaidSync conecta o Merchant Center e o Google Ads no mesmo conjunto de ferramentas, então o Claude Code pode comparar a saúde do feed com o gasto das campanhas de Shopping em uma só sessão.
Funciona em modo headless com claude -p?
Sim. Depois de entrar por /mcp, o claude -p reutiliza o token OAuth guardado. As leituras rodam direto. As escritas exigem cuidado. Ninguém está lá para responder ao prompt do Claude Code, então qualquer ferramenta de escrita que você permitiu com --allowedTools roda direto. Em uma tarefa sem supervisão, permita só as ferramentas de leitura de que ela precisa.
É grátis?
Sim. O plano gratuito custa $0 para 100 tarefas por mês, sem cartão. O Pro começa em $99 por mês e o Team em $249 por mês.
Relatórios e alterações de feed do Merchant Center. Um comando no Claude Code.