LinkedIn Ads no Claude Code com um comando
Claude Code
Para conectar o LinkedIn Ads 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 o LinkedIn Campaign Manager por 34 ferramentas: desempenho por cargo, senioridade e empresa, tamanho de público, previsões, grupos, campanhas e anúncios. Ele pergunta antes de cada ferramenta, e a maioria das gravações mostra antes uma simulação.
Um comando. Login OAuth, sem chave. Grátis, 100 tarefas por mês, vale $50, sem cartão.
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 ler e alterar suas contas de anúncios do LinkedIn.
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 é de 100 tarefas por mês a $0, sem cartão.
2Conecte o LinkedIn Ads no painel do PaidSync
Clique em Conectar no LinkedIn Ads e entre com a conta do LinkedIn que tem acesso ao Campaign Manager. O LinkedIn Ads autoriza via LinkedIn OAuth. O PaidSync armazena os tokens criptografados em repouso com AES-256-GCM.
Já está no Claude Code? Peça para ele executar connect_linkedin_ads. A ferramenta devolve um link OAuth para abrir no navegador.
3Escolha a conta de anúncios em que o Claude Code deve trabalhar
Depois do login, o PaidSync lista as contas de anúncios do LinkedIn que esse login alcança. Dentro de uma sessão, list_linkedin_ad_accounts as mostra e set_linkedin_ad_account escolhe a ativa.
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: “Mostre o desempenho das campanhas do LinkedIn nos últimos 30 dias”
O Claude Code retorna impressões, cliques, gasto, CTR, CPC e conversões de cada campanha. 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 LinkedIn Ads no Claude Code
Cada prompt abaixo corresponde a ferramentas do grupo LinkedIn Ads 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? |
|---|---|---|
| “Mostre o desempenho das campanhas dos últimos 30 dias” | get_linkedin_performance | Não |
| “Detalhe gasto e CTR por cargo e por senioridade” | get_linkedin_performance_by_dimension | Não |
| “Quantos membros VP of Marketing na Alemanha alcança?” | search_linkedin_targeting_entities, get_linkedin_audience_size | Não |
| “Preveja impressões e cliques para esse público com $100 por dia” | get_linkedin_campaign_forecast | Não |
| “Crie um grupo de campanhas e uma campanha em rascunho para esse público” | create_linkedin_campaign_group, create_linkedin_campaign | Sim, depois que você confirma |
| “Pause a campanha com o maior CPC” | pause_linkedin_campaign | Sim, depois que você confirma |
| “Altere o texto de introdução e a URL de destino deste anúncio” | update_linkedin_ad | 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 last 30 days LinkedIn performance by job title and list the five titles with the lowest cost per conversion." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/linkedin-ads-$(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 34 ferramentas do LinkedIn Ads, 15 só leem e 17 podem escrever.
As leituras cobrem desempenho, segmentações por criativo, empresa, cargo, setor, senioridade, país e região, segmentação, contagens de público, previsões, conversões e formulários de leads.
Ler mais
As escritas cobrem grupos de campanhas, campanhas, segmentação, criativos, anúncios, conversões e formulários de geração de leads. A maioria das escritas faz prévia por padrão com dry_run. Uploads de imagem e vídeo valem na primeira chamada.
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.
Envie uma imagem de anúncio pelo terminal
Quando a imagem está na sua máquina e não em uma URL pública, create_linkedin_image_upload_url devolve um link de upload de uso único.
Ele aceita JPEG, PNG ou GIF de até 5 MB, funciona uma vez e expira após 15 minutos. O Claude Code pode executar o upload para você:
curl -X PUT --data-binary @ad.jpg -H "Content-Type: image/jpeg" "<put_url>"A resposta traz o URN da imagem que create_linkedin_ad recebe. O vídeo passa por upload_linkedin_video a partir de uma URL pública, até 200 MB.
Limites que vale conhecer
- Uma nova campanha começa como rascunho, que nunca é veiculado e nunca gasta, até você informar outro status.
- A segmentação é obrigatória ao criar uma campanha. O LinkedIn trata uma campanha sem segmentação como Auto-Targeting, o que desativa a maioria dos formatos de anúncio e não pode ser desfeito.
- O PaidSync desativa por padrão a LinkedIn Audience Network e a expansão de público. Você pode reativar qualquer uma.
- O LinkedIn exige uma data final sempre que um grupo de campanhas tem orçamento total. Se você não informar uma, o PaidSync define 365 dias após o início e avisa na resposta.
- O número de conversões soma conversões no site e leads de formulários de geração de leads. As duas partes também voltam separadas.
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.
Perguntas frequentes
Como conectar o LinkedIn Ads ao Claude Code?
Crie sua conta em paidsync.ai, conecte o LinkedIn Ads via LinkedIn OAuth 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 pode criar campanhas no LinkedIn?
Sim. O LinkedIn Ads é uma plataforma de nível build no PaidSync. O Claude Code pode criar grupos de campanhas, campanhas, criativos, anúncios, conversões e formulários de geração de leads. Novas campanhas começam como rascunhos, a maioria das escritas faz primeiro uma simulação, e o Claude Code pergunta antes de executar cada ferramenta.
O Claude Code consegue dimensionar um público do LinkedIn antes de eu criar qualquer coisa?
Sim. search_linkedin_targeting_entities transforma nomes, como um cargo ou uma empresa, nos IDs que o LinkedIn precisa, get_linkedin_audience_size conta os membros e get_linkedin_campaign_forecast devolve a previsão do próprio LinkedIn. Nenhuma delas altera a conta.
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.
34 ferramentas LinkedIn Ads. Um comando.