Agency AI

---

📋 Sumário

• Visão geral
• O que você pode fazer
• Referência de ferramentas
• Gestão de anúncios e Autopilot
• Plataformas
• Requisitos
• Início rápido
• Exemplos de prompts
• FAQ
• Links

---

🎯 Visão geral

O Agency AI MCP transforma o Claude e o ChatGPT em um gestor completo de anúncios para suas contas do Meta (Facebook, Instagram) e Google Ads. Faça perguntas, receba estratégias e faça mudanças reais em suas campanhas sem sair do chat:

✨ Análise de desempenho – dados de campanha, detalhamentos, NCROAS e KPIs avançados 🎯 Estratégia – orientação de orçamento, recomendações de criativos, planos de escala ⚡ Criação e edição de anúncios – crie anúncios otimizados para conversão, atualize orçamentos, pause ou lance campanhas 🤖 Autopilot – agende gestão recorrente de anúncios com tarefas programadas do Claude e ChatGPT ⏱️ Rápido e eficiente – respostas mais rápidas com menor gasto de tokens do que MCPs diretos de plataformas de anúncios

---

🎨 O que você pode fazer

📊 Analista

Obtenha dados de campanha, detalhamentos de desempenho, NCROAS e KPIs avançados no Meta e Google. Entenda o que está funcionando e o que não está.

💡 Example: "Compare my top 5 campaigns by ROAS last month"

🎯 Estrategista

Receba orientação de orçamento, recomendações de criativos, planos de escala e estratégias de planejamento de campanhas multicanal.

💡 Example: "Which campaigns should I scale and why?"

⚡ Gestor de anúncios

Crie novos anúncios, pause os de baixo desempenho, ajuste orçamentos e lance campanhas no Meta e Google em segundos – sem sair do chat. Coloque em uma programação e sua conta se gerencia sozinha.

💡 Example: "Pause all campaigns with ROAS below 2:1"

---

🧰 Referência de ferramentas

15 ferramentas: 10 ferramentas de leitura para análise e 5 ferramentas de escrita para gestão de anúncios.

📖 Ferramentas de leitura

Ferramenta	O que retorna
get_brand_info	Perfil da marca e economia – o que a loja vende, seu público e ROAS de equilíbrio
get_campaigns	Campanhas do Meta + Google com gastos, receita, ROAS, impressões, cliques, conversões, objetivo
get_adsets	Conjuntos de anúncios do Meta (com orçamento diário e desempenho) ou grupos de ativos do Google
get_ads	Anúncios do Meta com desempenho no período, classificados por gasto – também o seletor de anúncio de origem para create_ad
get_ad_creative	Criativo de um anúncio do Meta: tipo, texto principal, título, descrição, CTA, página de destino, URLs de mídia
get_performance_timeseries	Gasto diário, receita e ROAS por plataforma conectada
get_pacing	Gasto do mês até a data vs. o orçamento mensal definido, por plataforma
get_anomalies	Dias com gasto/ROAS estatisticamente incomuns nos últimos 30 dias
get_recommendations	Recomendações de otimização por IA com justificativa e confiança
get_operation_status	Progresso, resultado ou erro de uma criação de anúncio na fila

✍️ Ferramentas de gestão de anúncios (escrita)

Ferramenta	O que altera
create_ad	Cria uma nova campanha, conjunto de anúncios ou anúncio no Meta – com criativo novo otimizado para conversão ou o criativo de um anúncio existente
update_campaign	Nome da campanha, orçamento diário e/ou status – Meta e Google
update_adset	Nome do conjunto de anúncios do Meta, orçamento diário e/ou status; nome e/ou status do grupo de ativos do Google
update_ad	Nome e/ou status do anúncio do Meta
set_campaign_status	Inicia ou pausa até 25 campanhas em uma única chamada, em ambas as plataformas

---

⚡ Gestão de anúncios e Autopilot (ferramentas de escrita)

Cinco ferramentas de escrita permitem que o Claude ou ChatGPT criem anúncios, editem campanhas e atuem diretamente na sua conta de anúncios. Nada é executado sem você: seu assistente confirma cada escrita com você antes de executá-la – veja as Salvaguardas abaixo.

🛠️ O que cada ferramenta de escrita faz

create_ad – Cria uma nova campanha, conjunto de anúncios ou anúncio no Meta. O criativo vem de um de dois lugares: criativo novo otimizado para conversão e texto gerados pelo Agency AI, ou um anúncio existente que você indicar (o criativo dele é reutilizado). placement decide quanta estrutura é criada:

placement	O que é criado
new-campaign	Campanha + conjunto de anúncios + anúncio (precisa de orçamento diário)
new-adset	Conjunto de anúncios + anúncio dentro de uma campanha existente
existing-adset	Somente anúncio, dentro de um conjunto de anúncios existente

A criação é executada em segundo plano e retorna um operation_id; peça ao seu assistente para verificar e ele chamará get_operation_status. A programação de um conjunto de anúncios de origem não é herdada: o novo conjunto de anúncios é executado sem data de término, a menos que você forneça uma futura.

update_campaign – Renomeia uma campanha, altera o orçamento diário e/ou inicia/pausa, no Meta ou Google. Cada campo relata seu próprio resultado, então um resultado parcial ("renomeada, mas o orçamento foi rejeitado") volta honestamente em vez de uma falha genérica.

update_adset – Os mesmos três campos para um conjunto de anúncios do Meta. Os grupos de ativos do Google suportam apenas nome e status; o orçamento deles fica na campanha.

update_ad – Renomeia ou inicia/pausa um anúncio do Meta. Somente Meta – o Google Performance Max não tem nível separado de anúncio.

set_campaign_status – Início/pausa em massa de até 25 campanhas em uma única chamada, misturando Meta e Google. Cada campanha é bem-sucedida ou falha de forma independente e o resultado lista cada desfecho, então um ID ruim nunca bloqueia o restante.

🤖 Autopilot

Combine as ferramentas de escrita com as tarefas programadas integradas do Claude e ChatGPT e a gestão rotineira de anúncios se executa sozinha. Defina a regra uma vez em inglês simples; seu assistente a executa conforme a programação:

• Uma verificação diária às 9h que pausa qualquer coisa abaixo do ROAS de equilíbrio
• Um reequilíbrio de orçamento às segundas-feiras em direção aos vencedores da semana anterior
• Uma varredura diária de anomalias que sinaliza gastos incomuns antes que se acumulem

🛡️ Salvaguardas

• 🔐 Somente sua conta – a conta é resolvida a partir da sua conexão verificada, nunca do que o assistente informa. IDs que não pertencem à sua conta conectada do Meta ou Google são rejeitados antes que qualquer coisa seja escrita.
• ✅ Confirmação primeiro – as ferramentas de escrita são declaradas ao Claude e ChatGPT como destrutivas (readOnlyHint: false, destructiveHint: true), então seu assistente pergunta antes de executar uma e o cliente pode mostrar seu próprio prompt de aprovação. O servidor também instrui o modelo a confirmar com você antes de qualquer escrita.
• 💰 Teto de orçamento – os orçamentos diários do Meta são limitados a US$ 1–US$ 5.000/dia, no chat exatamente como no painel.
• 📋 Mesmo pipeline do painel – as escritas passam pelos mesmos serviços e verificações de propriedade que o painel do Agency AI usa, e cada mudança entra no seu registro de atividades.
• 📊 Medido – cada chamada de ferramenta é registrada para sua conta (ferramenta, duração, tamanho da resposta, erros), então o que seu assistente fez é auditável.
• ↩️ Reversível – qualquer coisa pausada pode ser reativada da mesma forma. Uma criação de anúncio na fila pode ser verificada com get_operation_status; pause o resultado se mudar de ideia.

---

🛒 Plataformas

O Agency AI MCP funciona com qualquer plataforma de e-commerce ou site – conecte suas contas de anúncios do Meta e Google e tudo acima funciona.

No Shopify? O aplicativo Agency AI para Shopify adiciona uma camada de dados mais profunda – receita da loja comparada ao gasto com anúncios, NCROAS e KPIs avançados – para a análise e automação mais precisas. Recomendamos para lojas Shopify.

Não está no Shopify? Crie uma conta independente do Agency AI em agencyai.app/mcp e conecte suas contas de anúncios do Meta e Google diretamente.

---

✅ Requisitos

• ✔️ Uma conta Agency AI – instale o aplicativo Shopify ou crie uma conta em qualquer plataforma
• ✔️ Assinatura Claude Max OU plano ChatGPT com suporte a conectores personalizados
• ✔️ Pelo menos uma conta de anúncios conectada (Meta e/ou Google) no Agency AI

---

🚀 Início rápido

URL do endpoint

https://s.agencyai.app/mcp

Você precisará desta URL para o ChatGPT; o Claude encontra o Agency AI no diretório de conectores.

📱 Configuração no Claude

1. Abra o Claude (claude.ai)
2. Clique no seu perfil → Configurações → Conectores
3. Clique em Procurar conectores e pesquise por Agency AI
4. Clique em Conectar
5. Entre com sua conta Agency AI quando solicitado
6. ✅ Pronto! Comece a perguntar ao Claude sobre seus anúncios

Não está vendo? Clique em Adicionar conector personalizado e cole https://s.agencyai.app/mcp.

💬 Configuração no ChatGPT

1. Abra o ChatGPT (chatgpt.com)
2. Clique no seu perfil → Configurações → Conectores
3. Clique em Adicionar conector
4. Cole: https://s.agencyai.app/mcp
5. Entre com sua conta Agency AI quando solicitado
6. ✅ Pronto! Comece a perguntar ao ChatGPT sobre seus anúncios

📖 Precisa de etapas detalhadas? Veja llms-install.md para um passo a passo completo.

---

💬 Exemplos de prompts

Experimente estas perguntas com seu Claude ou ChatGPT conectado:

📊 Analysis
"How did my Meta campaigns perform last 30 days vs prior 30?"
"Show me my top 10 best-performing ads by ROAS"
"Which campaigns are underperforming and why?"

🎯 Strategy
"Which ads should I iterate on and which should I cut?"
"Where should I shift budget this week?"
"Give me creative recommendations for my top 5 performers"

⚡ Ad Management
"Pause all campaigns with ROAS below 2:1"
"Create a new ad for our bestseller and launch it in a new campaign at $50/day"
"Raise Spring Drop's daily budget to $150"
"Every weekday at 9am, check my account and pause anything below breakeven"

---

❓ FAQ

O que é o Agency AI MCP? Um servidor MCP que conecta suas contas de anúncios do Meta e Google ao Claude e ChatGPT. Ele lida com análise de desempenho, otimização de orçamento, recomendações de criativos e estratégia de escala, e cria anúncios, edita campanhas e executa sua conta no autopilot – tudo por chat.

Preciso do Shopify? Não. O Agency AI MCP funciona com qualquer plataforma de e-commerce ou site. Lojas Shopify obtêm a camada de dados mais profunda e a automação mais precisa por meio do aplicativo Agency AI para Shopify, então recomendamos se você estiver no Shopify.

O Claude ou ChatGPT podem realmente criar e editar meus anúncios? Sim. Seu assistente pode criar novos anúncios otimizados para conversão, alterar orçamentos e nomes, e pausar ou lançar campanhas, conjuntos de anúncios e anúncios no Meta e Google.

Ele mudará algo sem minha aprovação? Não. As ferramentas de escrita são declaradas destrutivas, então seu assistente confirma com você antes de agir. As mudanças têm teto de orçamento, verificação de propriedade e cada uma entra no seu registro de atividades.

Como isso é diferente de conectar MCPs do Meta ou Google diretamente? Um único conector cobre ambas as plataformas com KPIs pré-calculados, uma camada de estratégia e criação de anúncios integrada. As respostas voltam mais rápido com menor gasto de tokens do que MCPs diretos de plataformas de anúncios.

Quanto custa? O acesso ao MCP está incluído nos planos do Agency AI. Crie uma conta em agencyai.app/mcp para começar.

---

🔗 Links

Link	Finalidade
🌐 Site	Saiba mais sobre o Agency AI
🚀 Começar	Crie uma conta e conecte
🛍️ Aplicativo Shopify	Instale pela Shopify App Store
📧 Suporte	Obtenha ajuda ou envie feedback

📄 Licença

Este projeto está licenciado sob a Apache License 2.0 – veja o arquivo LICENSE para detalhes.