4 formas de conectar o TikTok Ads ao Claude em 2026 (fácil)

TL;DR

Para conectar o TikTok Ads ao Claude via MCP: copie mcp.portermetrics.com/mcp, vá para Claude.ai, abra Conectores → Gerenciar conectores → Adicionar conector personalizado, cole a URL e faça login. A partir daí, pergunte ao Claude qualquer coisa sobre suas campanhas do TikTok Ads em inglês simples.

Uma vez conectado, você pode automatizar seus relatórios e análises do TikTok Ads — faça perguntas sobre seus dados, construa dashboards, configure alertas ou envie relatórios prontos para cliente como o abaixo.

Pré-requisitos

• Uma conta Porter Metrics com sua conta TikTok Ads conectada (o plano gratuito é suficiente para testar de ponta a ponta)
• Uma conta Claude — o plano gratuito funciona para Claude Web; uma assinatura Pro é necessária para os recursos MCP do Claude Code e Desktop
• Acesso de administrador ou padrão às contas de anúncios do TikTok Ads que você deseja conectar

Conectar TikTok Ads ao Claude com MCP

Para este tutorial, vamos usar o método MCP. Aqui está uma explicação rápida do que é o MCP e por que é o melhor caminho para o TikTok Ads.

MCP (Model Context Protocol) é o padrão aberto que permite que ferramentas de IA como Claude, ChatGPT, Claude Code e outras acessem e usem APIs externas — as coisas que fazem ferramentas como o TikTok Ads funcionar nos bastidores. Em vez de construir uma integração personalizada para cada ferramenta de IA que você usa, você instala um MCP e toda IA compatível obtém acesso aos mesmos dados.

A configuração completa leva menos de 5 minutos e se divide em três passos: conectar o TikTok Ads à Porter, apontar o Claude para o MCP da Porter, e fazer sua primeira pergunta.

1. Conecte seus dados do TikTok Ads à Porter

A Porter fica entre a Marketing API do TikTok e o Claude. Ela lida com OAuth, limitação de taxa, paginação e toda a infraestrutura para que o Claude só veja dados limpos e estruturados.

Cadastre-se na Porter. Crie uma conta gratuita em portermetrics.com. O plano gratuito é suficiente para executar este fluxo completo de ponta a ponta.

Conecte seu TikTok Ads Developer Token / acesso à API. Na Porter, clique em Criar → escolha Claude como destino → selecione TikTok Ads como fonte → faça login com TikTok para conceder acesso às suas contas de anúncios.

Selecione suas contas de anúncios. Escolha as contas de anúncios do TikTok Ads que você deseja que o Claude consulte. Quando você seleciona várias contas de anúncios sob uma única conexão, a Porter automaticamente mistura seus dados para que você possa consultá-las como uma só.

Opcional: ative o armazenamento automático BigQuery se você está conectando várias contas de anúncios com grandes volumes de dados. Isso mantém as respostas do Claude rápidas mesmo em escala.

2. Conecte o MCP ao Claude

A URL do MCP da Porter é o que você cola no Claude. Uma vez adicionada, o Claude pode consultar dados do TikTok Ads sob demanda em qualquer conversa.

Vá para claude.ai e clique no + ícone no campo de chat para abrir o menu de ferramentas.

No menu que abre, passe o mouse sobre Conectores e clique em Gerenciar conectores.

No painel de Conectores, clique no + botão no topo da lista para começar a adicionar um novo conector.

Escolha Adicionar conector personalizado no menu suspenso que aparece.

Uma caixa de diálogo abre com os campos de nome e URL. Digite Porter no primeiro campo para nomear o conector.

No segundo campo, cole https://mcp.portermetrics.com/mcp. Não altere as configurações avançadas.

Clique em Adicionar no canto inferior direito da caixa de diálogo. O Claude abre uma janela de login — use a mesma conta Google vinculada ao seu workspace da Porter e aprove o acesso.

Quando a autorização terminar, você verá as ferramentas somente leitura da Porter aparecerem no painel de conectores. Você está pronto para começar a fazer perguntas.

Para um guia mais completo com capturas de tela em cada etapa, veja o tutorial do Porter MCP.

3. Comece a criar perguntas e dashboards

Com a Porter conectada, abra um novo chat do Claude e pergunte qualquer coisa sobre seu TikTok Ads em inglês simples. O Claude chama a Porter nos bastidores, puxa dados ao vivo do TikTok e responde com tabelas, gráficos ou resumos.

Experimente uma destas para verificar se a configuração está funcionando:

Para um catálogo completo de prompts prontos para copiar e colar organizados por caso de uso (performance, fadiga, orçamento, agência, B2B, e-commerce, multicanal), vá para a seção de prompts abaixo.

Outras formas de conectar TikTok Ads ao Claude

O MCP é o caminho que acabamos de percorrer — e o que recomendamos para a maioria dos profissionais de marketing. Mas não é a única forma de colocar dados do TikTok Ads na frente do Claude. As alternativas mais comuns são a API direta do TikTok Ads (ou seu MCP oficial, se houver), uma ponte com Google Sheets ao vivo, e o BigQuery para escala. Cada uma tem seus prós e contras — escolha a que se encaixa em como sua equipe já trabalha.

• 🔌 TikTok Ads’s direct API (or official MCP) — Converse diretamente com a Marketing API você mesmo, ou instale o MCP oficial do TikTok Ads (se existir). Controle máximo, mas você lida com autenticação, limites de taxa e paginação — e só obtém uma fonte.
• 📊 Google Sheets — Planilha ao vivo ou upload único de CSV. Auditável, familiar, mais rápido para grandes exportações — mas a agregação acontece na Planilha, não na API.
• 🗄️ Google BigQuery — Para grandes contas de anúncios ou agências executando análise multi-conta. O BigQuery agrega; o Claude só consulta resumos pré-construídos.

Via API direta do TikTok Ads (ou MCP oficial)

Se você está construindo um produto em torno do TikTok Ads — ou é um desenvolvedor que prefere possuir cada camada da integração — o caminho mais direto é conversar com a Marketing API você mesmo, ou instalando o MCP oficial do TikTok Ads (se existir). O TikTok ainda não lançou um MCP oficial, então isso significa escrever chamadas de API diretamente no Claude Code ou em seus próprios scripts. Você precisará seguir os limites de taxa e cotas do TikTok e solicitar um Developer Token / API access quando aplicável. De qualquer forma, você pula a Porter inteiramente e chama o TikTok a partir do seu próprio código ou do Claude Code com requisições HTTP brutas.

Via Google Sheets (planilha ao vivo ou CSV manual)

Se sua equipe já vive no Google Sheets — ou você quer um rastro de auditoria antes que o Claude toque em qualquer coisa — alimente o TikTok Ads em uma Planilha, depois deixe o Claude ler a Planilha. Você pode automatizar o pipeline TikTok Ads → Sheets com a Porter para que ele atualize diariamente, ou fazer exportações pontuais de CSV do TikTok Ads Manager para análise estática.

Leia o tutorial completo de Sheets →

Via Google BigQuery (para escala)

Este é o caminho que a maioria das pessoas ignora — e é o que te salva quando sua conta de anúncios do TikTok Ads fica séria. Um único anunciante grande ou uma agência gerenciando 10+ contas de anúncios atingirá limites de taxa da API e problemas de latência consultando o Claude diretamente. O Claude literalmente te dirá que está demorando demais ou expirando em grandes extrações.

O BigQuery resolve isso. Você carrega dados do TikTok Ads em tabelas do BigQuery em um cronograma, depois conecta o BigQuery ao Claude — seja através de um MCP do BigQuery ou via Claude Code com consultas SQL. Em vez de pedir ao Claude para puxar dados brutos do TikTok Ads, você deixa o BigQuery agregar em tabelas pequenas e otimizadas, e o Claude só consulta a saída resumida. Problema de escala resolvido.

Leia o tutorial completo de BigQuery →

Conectando TikTok Ads ao Claude Code

A maioria dos profissionais de marketing agrupa Claude e Claude Code juntos e perde a maior vantagem de todo o ecossistema MCP. Eles não são a mesma ferramenta — e a diferença importa enormemente quando você começa a trabalhar com dados do TikTok Ads seriamente.

O Claude é uma interface de chat. Você faz uma pergunta, o Claude puxa dados ao vivo através do MCP, responde, talvez construa um dashboard rápido dentro da conversa. Ótimo para análise pontual. O problema: tudo é efêmero. Quer atualizar o dashboard amanhã? Você o regenera do zero. Quer o mesmo relatório toda segunda-feira? Você refaz a pergunta toda segunda-feira.

O Claude Code é o Claude rodando dentro do terminal do seu computador. Porque ele tem acesso ao seu sistema de arquivos, runtime e outras ferramentas de desenvolvedor, ele não só responde perguntas — ele pode construir software de verdade. Scripts persistentes, rotinas agendadas, apps HTML, dashboards internos, integrações que rodam 24/7 sem sua intervenção. Uma vez conectado ao MCP da Porter para TikTok Ads, uma categoria inteira de trabalho se torna possível.

O que o Claude Code desbloqueia que o Claude sozinho não pode

É aqui que o ecossistema MCP mais compensa. Porque o Claude Code pode combinar o MCP da Porter com outros MCPs — Firecrawl para web scraping, Airtable para dados estruturados, Notion para wikis, Vercel para deploy, Slack e Gmail para entrega — você não está mais consultando dados. Você está construindo ferramentas.

🛠️ Construa seu próprio app de gestão de orçamento Stack: Porter MCP + Vercel MCP (ou Cloudflare Pages, Netlify) Alimente o Claude Code com suas metas e objetivos do TikTok Ads — metas de CPA, orçamentos diários, limites de ROAS — e peça para ele gerar um dashboard de ROI personalizado para cada cliente. Ele constrói o HTML, puxa dados ao vivo, faz deploy para uma URL. Sem embed do Data Studio para quebrar quando o fornecedor muda preços, sem restrições de template. O dashboard atualiza automaticamente porque consulta o MCP da Porter em cada carregamento de página. Ideal para: agências que querem dashboards white-label para clientes sem depender do Looker ou Data Studio.

🔍 Monitoramento completo de concorrentes + performance Stack: Porter MCP + Firecrawl MCP Combine sua própria performance do TikTok Ads da Porter com páginas de destino de concorrentes e anúncios ao vivo da Meta Ad Library raspados via Firecrawl. O Claude Code costura ambos em um relatório semanal de inteligência competitiva — seus números ao lado dos ângulos criativos e preços deles, com um resumo de LLM no topo do que mudou semana a semana. Roda em cron, chega na sua caixa de entrada toda segunda-feira de manhã. Ideal para: equipes internas que precisam de contexto de mercado, não só números internos.

📚 Wiki interno de marketing com métricas ao vivo Stack: Porter MCP + Airtable MCP (ou Notion MCP) Use Airtable ou Notion como schema, Porter como fonte de dados. O Claude Code mantém cada página populada com gasto atual, CPA e ROAS para cada conta de anúncios — sem capturas de tela defasadas, sem copiar e colar do Excel. Novos funcionários leem uma entrada do wiki e têm contexto completo sobre a conta de um cliente. Ideal para: agências e equipes de operações que onboardam analistas ou rotacionam gerentes de conta frequentemente.

🔔 Alertas 24/7 sobre gasto, CTR e quedas de qualidade Stack: Porter MCP + Slack MCP (ou Gmail MCP) Uma rotina do Claude Code em cron puxa TikTok Ads via Porter, avalia limites — CTR cai abaixo de 1%, gasto diário dispara 2× a média móvel — e envia alertas no Slack ou Gmail no momento em que algo cruza a linha. Você para de verificar dashboards reativamente; o dashboard se verifica e te diz quando olhar. Ideal para: qualquer equipe que já descobriu um problema 48 horas tarde demais porque ninguém abriu o relatório.

Conclusão: O Claude é para perguntas rápidas e dashboards pontuais. O Claude Code é para construir apps, dashboards ao vivo, alertas e ferramentas de verdade — qualquer coisa que você queira rodar sozinha sem refazer perguntas. A mesma URL do MCP da Porter funciona em ambos, então você não escolhe uma vez e fica preso.

Casos de uso — o que você pode fazer de verdade quando o TikTok Ads está conectado ao Claude

Acertar a conexão é metade da batalha. O valor real aparece no que você faz em seguida. Aqui estão os casos de uso que os usuários da Porter constroem em torno de seus dados do TikTok Ads — desde perguntas simples até fluxos de trabalho completos voltados para cliente.

1. Converse e faça perguntas diretamente

O caso de uso mais simples — e ainda o que 80% dos profissionais de marketing começam. Abra o Claude, faça uma pergunta, obtenha uma resposta baseada em dados ao vivo.

É a forma mais rápida de substituir uma verificação diária do TikTok Ads Manager. Mas o chat é o básico — os casos de uso interessantes vêm a seguir.

2. Misture TikTok Ads com seus dados de vendas (Stripe, HubSpot, Shopify)

É aqui que uma visão 360° fica real. Quando você conecta o TikTok Ads e sua fonte de receita (Stripe para SaaS, HubSpot CRM para B2B, Shopify para e-commerce), o Claude pode mapear campanhas de anúncios para negócios fechados ou compras reais — usando UTMs, nomes de campanhas e timestamps — e te dar atribuição que nenhum número de plataforma consegue.

O Claude lida com o mapeamento de UTM e junções. Você obtém um relatório de atribuição pronto para cliente que nenhuma plataforma individual consegue gerar sozinha.

3. Alertas e notificações automatizados no Slack ou Gmail

Com o Claude Code você pode transformar o monitoramento do TikTok Ads em uma rotina que roda sozinha. Conecte o MCP da Porter (para os dados) junto com um MCP do Slack ou Gmail (para entrega), depois escreva uma tarefa agendada do Claude Code que puxa performance toda manhã e te notifica só quando algo realmente precisa de atenção.

Sem dashboards, sem verificações diárias. O relatório vem até você — e só quando importa.

4. Apresentações prontas para cliente com dados ao vivo (Gamma, HTML, PDF)

Uma dor comum de agências: você envia aos clientes um link do Data Studio, o Looker quebra, o cliente entra em pânico — e você passa uma hora explicando um dashboard quebrado. Com o Claude você pode construir a própria apresentação — como um deck Gamma, uma página HTML personalizada, ou um PDF — populada com números ao vivo cada vez.

A apresentação se torna um artefato de entrega que você envia ao cliente, não um dashboard que depende de outra ferramenta ficar no ar. Sem iframe quebrado, sem prompts de login, só o conteúdo.

Campos e métricas do TikTok Ads que você pode consultar com o Claude

Antes de começar a escrever prompts, ajuda saber quais dados estão realmente disponíveis. O MCP da Porter dá ao Claude acesso a 597 métricas do TikTok Ads em todos os níveis de relatório, mais detalhamentos por público, posicionamento, dispositivo e geografia. E a mesma URL MCP também desbloqueia 25+ outras fontes — então o Claude pode misturar TikTok Ads com Google Ads, GA4, Shopify, HubSpot e mais em um único prompt.

Prompts que você pode copiar e colar hoje

1. Para agências gerenciando múltiplas contas do TikTok

Use estes quando estiver gerenciando campanhas multi-cliente, detectando fadiga criativa em ciclos de 4–7 dias, e enviando relatórios white-label.

2. Para profissionais de marketing B2B executando geração de leads

Use estes quando estiver otimizando campanhas de geração de leads com preenchimentos de formulário, cadastros e públicos lookalike.

3. Para equipes de e-commerce vendendo no TikTok Shop

Use estes quando estiver rastreando compras onsite do TikTok Shop, ROAS e performance criativa para campanhas de produto.

4. Multicanal: TikTok Ads + Meta + Google

Use estes quando estiver comparando a performance do TikTok contra Meta e Google Ads em uma única conversa.

Como usar o Claude Code para TikTok Ads sem ser bloqueado

A reconstrução de conformidade da infraestrutura publicitária do TikTok em 2025-2026 criou dores reais de qualidade de dados para profissionais de marketing que dependem de métricas reportadas via API. Durante a transição, dados históricos de conversão se tornaram não confiáveis, filas de revisão criativa aumentaram, e sistemas de segmentação/entrega experimentaram interrupções temporárias. Para um profissional de marketing de performance que gasta €1.000+/mês, isso significava previsões de pipeline erradas, cálculos de ROAS defasados, e decisões de pacing de orçamento feitas com dados incompletos — não um cenário de “banimento”, mas um cenário de “dados quebrados” que custou dinheiro real em gasto mal alocado.

A aplicação do TikTok é baseada em limitação de taxa, não baseada em ferramentas. O TikTok não bane contas porque você usou o Claude ou um servidor MCP. Ele limita (HTTP 429) ou restringe (HTTP 403) por causa de como a API foi usada: volume excessivo de requisições, padrões semelhantes a spam, ou escopos de acesso não aprovados. Acesso de relatório somente leitura dentro de volumes razoáveis de requisição é seguro. Requisições paralelas em rajada, operações de escrita em escala, ou comportamento semelhante a scraping não é. A interface programática primária do TikTok para anúncios — a Commercial Content API — tem requisitos de acesso extremamente restritivos e sem limites de taxa documentados abertamente para desenvolvedores em geral, significando que a maioria das integrações “TikTok Ads API” opera através de endpoints aprovados por parceiros ou whitelisted em vez de uma API totalmente pública.

Os dois padrões que levam a relatórios imprecisos do TikTok Ads

Após revisar documentos oficiais e threads da comunidade, dois padrões aparecem repetidamente.

1. Depender de dados da API em tempo real para decisões de otimização no mesmo dia. Os dados de relatório do TikTok Ads podem experimentar atrasos de até 24 horas para algumas métricas, e durante transições de plataforma (como a reconstrução de 2025-2026), lacunas em dados históricos de conversão foram documentadas. Profissionais de marketing que tratam números reportados via API como verdade absoluta para mudanças intradiárias de orçamento ou pausas criativas tomam decisões com dados incompletos. A consequência não é um banimento — é gasto mal alocado e sinais de performance falsos negativos. Fonte: documentação de reconstrução de conformidade do TikTok for Business, 2025-2026.

2. Assumir paridade de acesso de escrita com acesso de leitura. Servidores MCP de terceiros e conectores open-source frequentemente anunciam “gerenciamento de campanhas” (operações CRUD) mas podem só suportar operações GET para campanhas e grupos de anúncios, com CREATE/UPDATE ou não documentado ou não suportado. Profissionais de marketing que constroem fluxos automatizados assumindo capacidades completas de escrita descobrem lacunas só após o deploy, quebrando pipelines de automação. Fonte: análise de concorrente — repositório AdsMCP lista endpoints CREATE/UPDATE sem requisitos de parâmetros documentados.

Ambos os comportamentos desencadeiam degradação de qualidade de dados e limitação de taxa. Se você quer usar o Claude para TikTok Ads com segurança, mantenha-se em relatório somente leitura dentro de volumes razoáveis de requisição e trate os dados da API como “a verdade de ontem”, não como evangelho em tempo real.

O protocolo de segurança de 5 regras

Baseado nos limites de taxa documentados do TikTok Ads e nos comportamentos que realmente causaram limitação — não suposições:

• Trate os dados da API como “a verdade de ontem”, não como evangelho em tempo real. A infraestrutura de relatório do TikTok tem atrasos documentados de 24 horas para algumas métricas durante transições de plataforma. Consequência se ignorado: mudanças intradiárias de orçamento baseadas em dados incompletos queimam gasto em criativos com performance ruim. O Porter MCP lida com isso ao exibir timestamps de frescor de dados e sinalizar métricas conhecidas por terem disponibilidade atrasada.

• Limite requisições simultâneas da API a 10 ou menos por app. Implementações de MCP de terceiros documentadas pela comunidade citam 10 requisições simultâneas como um teto seguro para evitar limitação HTTP 429. Consequência se ignorado: requisições limitadas, sincronizações de dados incompletas, e loops de automação quebrados. O Porter MCP impõe batching de requisições no nível de conexão e backoff automático para permanecer dentro de faixas seguras de concorrência.

• Limite o volume de requisições a 1.000 por hora por app. Este número aparece na documentação de MCP de terceiros (AdsMCP) mas não é confirmado em documentos oficiais do TikTok disponíveis publicamente. Consequência se ignorado: limitação de taxa (HTTP 429) que pausa a recuperação de dados por minutos a horas. O Porter MCP implementa pacing de requisições e gerenciamento de fila para distribuir a carga uniformemente ao longo da hora.

• Valide que as operações de escrita são totalmente suportadas antes de automatizá-las. Nem todas as contas de desenvolvedor ou apps de API têm permissões de escrita para campanhas, grupos de anúncios, ou anúncios. Consequência se ignorado: scripts de automação falham silenciosamente ou parcialmente, deixando campanhas em estados inconsistentes. O conector nativo do Porter MCP opera com escopos pré-validados — somente leitura por padrão, com capacidades de escrita explicitamente habilitadas e testadas por conta.

• Use location IDs (não códigos de país) para todas as chamadas de API de segmentação geográfica. A API de segmentação do TikTok requer location IDs específicos em vez de códigos de país ISO. Consequência se ignorado: parâmetros de segmentação falham na validação, campanhas não veiculam para os públicos pretendidos, e erros de API bloqueiam a criação de campanhas. O Porter MCP mapeia seleções de país/região para a taxonomia de location IDs canônica do TikTok automaticamente.

O que o Porter MCP faz de diferente: ele impõe essas salvaguardas no nível da plataforma. O conector nativo de TikTok Ads da Porter é somente leitura por padrão, com escopos de escrita opcionais explicitamente habilitados por conta. O volume de requisições é automaticamente controlado para evitar limitação. Timestamps de frescor de dados são exibidos para cada métrica puxada. Parâmetros de segmentação geográfica são automaticamente mapeados para a taxonomia de location IDs do TikTok. Batching por conta impede vazamento de cota entre contas. Esse é o comportamento que os sistemas automatizados do TikTok lidam graciosamente — uso previsível de API de volume moderado, predominantemente leitura, de um único app parceiro whitelisted.

Perguntas frequentes