Montar painéis e automatizar com API e MCP sob controle humano

Escalar por degraus pede a mesma conta todo dia, e a Aroeira fazia essa conta abrindo quatro telas: Ads Manager, Seller Center, GA4 e a planilha de margem. Cada tela tem relógio e régua próprios, e a reunião de segunda-feira começava discutindo qual número estava certo.

Somar números de fontes que contam de jeitos diferentes produz decisão errada com cara de dado. O Seller Center reporta as vendas do dia; o Ads Manager reporta, para os anúncios da loja, as vendas dentro da janela de 7 dias. O Events Manager não mostra dados em tempo real. Um painel que ignora essas diferenças mostra lucro onde há empate.

Três painéis com perguntas separadas resolvem a leitura, e a Marketing API junto com o TikTok for Business MCP Server resolve a coleta. O risco novo é o agente de IA que lê e mexe na conta. Com permissão mínima, teto financeiro e aprovação humana, ele economiza horas sem tocar em verba por conta própria.

Painel executivo responde a uma pergunta: a operação deu dinheiro no mês? Ele mostra GMV, receita líquida (o GMV menos cancelamentos, devoluções e descontos pagos pelo vendedor) e margem de contribuição depois de mídia e afiliado. Ao lado do ROI reportado, uma coluna traz o ROI incremental estimado. É o painel de Helena, lido às segundas, com os números do fechamento financeiro.

O painel criativo responde a outra: quais vídeos merecem mais verba e quais estão cansando. O Smart+ atualizado traz relatório por ID de material criativo, e o painel da Aroeira cruza esse ID com o nome do conceito, o produto e a data de entrada. É o painel de Otávio, lido todo dia, com gasto, custo por compra e queda de desempenho por criativo.

Na LIVE, o terceiro painel junta o que o Seller Center mostra por transmissão: receita, pedidos, compradores, unidades vendidas, taxa de conversão e CTR, com GPM (o GMV por mil exibições) entre as métricas opcionais. A definição de cada métrica fica no ícone de ajuda do próprio painel. O LIVE Dashboard compara a transmissão com a média do mercado e guarda 14 dias de histórico.

Integração de dados é o encanamento que alimenta os três painéis. A API for Business do TikTok tem três partes: Marketing API, para campanhas e relatórios de anúncios; Organic API, para contas, menções, TikTok One e Spark Ads; e Business Messaging API, para mensagens. O Split Test também tem API, o que permite abrir e registrar testes pelo mesmo fluxo.

Do lado da loja, a Aroeira leva ao painel os relatórios da área de Finanças do Seller Center, com demonstrações e pagamentos; do lado do site, o GA4. A ligação do GA4 com o Events Manager aceita hoje só o evento purchase, e o painel respeita essa limitação sem inventar etapa de funil que a fonte não entrega.

Alerta é um painel que chama você em vez de esperar ser aberto. Cada alerta tem condição, dono e ação: conta do degrau negativa vai para Otávio, atraso de envio perto de 4 por cento vai para a expedição, pontuação de saúde da conta abaixo de 200 vai para Helena. Alerta sem dono vira ruído, e em duas semanas ninguém lê.

MCP (Model Context Protocol) é o padrão que liga um agente de IA a ferramentas externas. O TikTok anunciou o seu servidor MCP de anúncios em 13/05/2026, no TikTok World, e o apresentou ao mercado brasileiro em 19/05/2026, em São Paulo, junto com as Ads Skills. A Central de Ajuda o chama de TikTok for Business MCP Server.

O servidor expõe cerca de 400 ferramentas, que são endpoints da API for Business, para campanhas (inclusive Smart+ atualizado e GMV Max), relatórios, catálogo, criativos, públicos e Business Center. Há duas formas de conexão: a flat carrega as cerca de 400 de uma vez, e a página a recomenda para o Claude; a layer começa com cerca de 40 e busca as outras sob demanda.

Os limites fazem parte do desenho. São 3 consultas por segundo, por ferramenta e por usuário; a autorização vale 30 dias e depois precisa ser refeita; nem todos os endpoints estão disponíveis; a disponibilidade varia por região e por conta. O acesso dispensa credencial de desenvolvedor e chave de API, então quem autoriza empresta ao agente as permissões do próprio usuário.

Agentic Hub, lançado em 30/06/2026, é um marketplace de habilidades de IA, do próprio TikTok e de terceiros, construídas sobre o MCP. Entre os parceiros do lançamento estão HubSpot, Wix, Constant Contact e Kochava. A página não diz quais habilidades funcionam em conta brasileira, então cada uma é conferida na própria conta antes de entrar na rotina.

Controle de agente começa pela permissão mínima. No Business Center, as funções básicas são Admin e Standard, e as financeiras, Finance Analyst e Finance Manager, se somam a elas. Como o agente herda a função de quem autorizou, a autorização sai de um usuário Standard, sem função financeira, com acesso só às contas de anúncio que o agente precisa ler.

Teto financeiro é o limite que nenhum erro atravessa. No pagamento manual, o anunciante deposita antes, e nenhum anúncio veicula além do saldo; em reais, esse modo aceita cartão e Pix. Com recarga semanal do tamanho do plano, o pior erro possível de um agente custa no máximo uma semana de verba, e a regra interna limita cada mudança a 30 por cento, com 48 horas entre ajustes na mesma campanha.

Aprovação humana separa ler de mexer. O agente lê relatórios à vontade e escreve propostas; toda mudança de orçamento, pausa ou ativação espera o aceite de uma pessoa com nome. Auditoria fecha o ciclo: cada chamada de ferramenta vai para um registro com quem pediu, quando, qual ferramenta, os parâmetros, o antes, o depois e quem aprovou.

Armadilha comum: autorizar o agente com o usuário Admin para ele não travar em permissão. A partir daí, o agente alcança usuários, verificação e contas que ninguém pensou em incluir, e um erro de interpretação vira mudança de verdade. O processo falha na autorização, antes de o agente fazer qualquer coisa.

A Aroeira ligou o MCP em agosto de 2026 pela conexão layer, que começa com uma lista menor de ferramentas e fica mais fácil de auditar. Otávio criou um usuário só para o agente, com a função Standard e sem função financeira (o usuário dele tem Finance Analyst), autorizou a conexão por ele e escreveu a política abaixo, num formato interno que o orquestrador do agente lê antes de cada chamada.

Às 8h, o agente monta o resumo do dia a partir dos três painéis e fecha a conta de cada degrau aberto. A regra usa o fator de metade do teste de agosto e a margem média de 46 por cento. Ela propõe e nunca executa.

Foi essa regra que apontou, em 20 de setembro, a perda de R$ 730 do degrau de setembro, dois dias antes da reunião que voltou a verba aos R$ 12.000. No mês, o agente fez 11 propostas e Otávio aprovou 7. Das 4 que não passaram, uma pedia dobrar o orçamento de um grupo ainda em aprendizagem e foi barrada pela política antes de chegar à fila.

O limite de 3 consultas por segundo apareceu na primeira semana, quando o agente puxou o relatório por criativo dos 34 produtos de uma vez; uma fila de chamadas resolveu. O tempo que Otávio gastava montando relatório caiu de cerca de 6 horas por semana para 1 hora e meia, e a primeira renovação da autorização, em setembro, só aconteceu depois de Helena ler o registro inteiro.

Na Aroeira, os três painéis substituíram as quatro telas, e a reunião de segunda-feira passou a começar pela decisão. O agente ganhou velocidade para ler e propor, sem ganhar autonomia sobre dinheiro: o teto é uma semana de verba, e cada chamada fica registrada.

Grave a política do seu agente antes de conectá-lo: função de quem autoriza, ferramentas livres, com aprovação e proibidas, teto de recarga e intervalo entre ajustes. O controle funciona se nenhuma mudança de orçamento dos próximos 30 dias acontecer sem um nome no campo de aprovação. O próximo capítulo leva essa operação para quem vende o serviço a clientes, com escopo, contrato e entrega.