TikTok Ads no Claude Code com um comando
Claude Code
Conecte o TikTok Ads ao Claude Code: rode claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp, digite /mcp e entre com seu login do PaidSync.ai.
O Claude Code acessa suas contas de anunciante do TikTok com 24 ferramentas: desempenho por anunciante, campanha, grupo e anúncio, e pausar, ativar e mudar orçamento e lance em campanhas existentes. Ele pergunta antes de cada ferramenta.
Nível de gestão. O Claude Code trabalha em campanhas que você já roda. Ele não cria novas campanhas do TikTok.
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 gerar relatórios e gerenciar suas campanhas do TikTok.
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 TikTok Ads no painel do PaidSync
Clique em Conectar no TikTok Ads e entre com a conta do TikTok que tem acesso às suas contas de anunciante. O TikTok Ads autoriza via TikTok OAuth. O PaidSync guarda os tokens criptografados em repouso com AES-256-GCM.
Já está dentro do Claude Code? Peça para ele executar connect_tiktok_ads. A ferramenta devolve um link OAuth para abrir no navegador.
3Escolha o anunciante em que o Claude Code deve trabalhar
Dentro de uma sessão, list_tiktok_advertisers mostra todas as contas de anunciante que o seu login do TikTok alcança, e set_active_tiktok_advertiser escolhe aquela em que o Claude Code trabalha. Alterações no TikTok exigem antes um anunciante ativo.
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 gasto e as conversões do TikTok por campanha dos últimos 7 dias”
O Claude Code devolve impressões, cliques, CTR, CPC, CPM, gasto 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 de TikTok Ads no Claude Code
Cada prompt abaixo corresponde a ferramentas do grupo TikTok Ads do PaidSync. O Claude Code escolhe a ferramenta. A última coluna diz se a chamada pode alterar algo na conta de anunciante.
| Pedido | Ferramentas que chama | Altera sua conta? |
|---|---|---|
| “Liste minhas contas de anunciante do TikTok e deixe a Acme como ativa” | list_tiktok_advertisers, set_active_tiktok_advertiser | Não |
| “Mostre gasto, CTR e conversões por campanha dos últimos 7 dias” | get_tiktok_performance | Não |
| “Detalhe no nível de anúncio a campanha principal” | get_tiktok_performance, list_tiktok_ads | Não |
| “Liste os grupos de anúncios desta campanha com status e orçamento” | list_tiktok_adgroups | Não |
| “Pause a campanha com o pior custo por conversão” | pause_tiktok_campaign | Sim, depois que você confirma |
| “Aumente o orçamento da campanha Spring Sale para $150” | update_tiktok_campaign_budget | Sim, depois que você confirma |
| “Reduza o lance deste grupo de anúncios para $0.80” | update_tiktok_adgroup | 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 7 days TikTok performance at ad level and list the ads with the highest spend and no conversions." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/tiktok-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 24 ferramentas do TikTok Ads, 11 só leem e 11 podem escrever. As leituras cobrem anunciantes, campanhas, grupos de anúncios, anúncios e desempenho.
Ler mais
As escritas cobrem pausar e ativar campanhas, orçamentos de campanha, nomes de campanha e status, orçamento, lance e nome de grupos de anúncios.
Alterações em grupos de anúncios e alterações de orçamento e nome de campanha mostram uma simulação por padrão com dry_run. Pausar ou ativar uma campanha não tem simulação e exige uma confirmação explícita.
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 faz no TikTok
- O PaidSync não cria campanhas, grupos de anúncios nem anúncios do TikTok. Crie-os no TikTok Ads Manager e depois gerencie-os pelo Claude Code.
- Não há ferramentas de públicos nem de upload de criativos do TikTok no PaidSync.
update_tiktok_campaignaltera só o nome. O status passa porpause_tiktok_campaigneenable_tiktok_campaign, e o orçamento porupdate_tiktok_campaign_budget.- Uma mudança no preço do lance de um grupo de anúncios só vale quando o grupo usa um tipo de lance personalizado.
- Os relatórios do TikTok chegam com cerca de uma a duas horas de atraso, então uma consulta às 9h mostra dados até por volta das 7h ou 8h.
Perguntas frequentes
Como conecto o TikTok Ads ao Claude Code?
Crie sua conta em paidsync.ai, conecte o TikTok Ads via TikTok 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 cria campanhas do TikTok?
Sim. O PaidSync cria campanhas, grupos de anúncios e anúncios em vídeo do TikTok, todos pausados. O Claude Code também pode gerar relatórios de campanhas existentes, pausá-las e ativá-las, e alterar orçamentos e lances de grupos de anúncios.
O Claude Code altera orçamentos do TikTok?
Sim. update_tiktok_campaign_budget altera o orçamento de uma campanha e update_tiktok_adgroup altera o orçamento de um grupo de anúncios. Os dois mostram antes uma simulação, e o Claude Code pergunta antes de executar cada ferramenta.
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 gestão de campanhas do TikTok. Um comando no Claude Code.