PELO AGENTE
============================================================
# BRIEFING COMPLETO — CLAUDE + META ADS API
---
## TEMA
Conectar o Claude AI à API de Anúncios da Meta (Facebook/Instagram Ads) gratuitamente, usando o protocolo MCP (Model Context Protocol) para gerenciar campanhas, gerar relatórios e criar dashboards diretamente por prompts de linguagem natural — sem pagar cursos ou ferramentas caras.
---
## GANCHO PRINCIPAL
> **"O que outros querem te cobrar em curso, você vai aprender aqui de graça: como transformar o Claude em um gerente de tráfego que acessa sua conta de anúncios da Meta por comando de voz."**
**Ângulos alternativos de gancho:**
- *"Você está pagando alguém para olhar seus anúncios. A IA faz isso de graça — e em segundos."*
- *"Token de acesso + Claude + Meta API = o gerenciador de tráfego que nunca dorme e não cobra por hora."*
- *"Ninguém te conta isso: o Claude consegue entrar no seu Gerenciador de Anúncios e te dar relatórios completos sem você abrir o Facebook."*
---
## CONTEXTO E PROFUNDIDADE
### O que é MCP (Model Context Protocol)?
O **Model Context Protocol (MCP)** é um padrão aberto criado pela Anthropic (empresa por trás do Claude) que permite conectar modelos de IA a fontes de dados externas de forma **segura, estruturada e padronizada**. É, em essência, uma "tomada universal" que permite ao Claude se "plugar" em sistemas como bancos de dados, APIs de anúncios, CRMs, etc.
- **Analogia direta:** Se o Claude é um funcionário inteligente, o MCP é o crachá de acesso que permite a ele entrar nos sistemas da empresa.
- MCP **não funciona na versão web do Claude (claude.ai no navegador)**. Só funciona no **Claude Desktop App** (versão baixável para Mac e Windows).
### Por que isso é relevante agora?
- O gerenciamento de anúncios via IA ainda é visto como recurso exclusivo de grandes agências ou de quem paga ferramentas como Madgicx, Adzviser, etc.
- A Meta oferece acesso gratuito à sua **Marketing API** para qualquer desenvolvedor cadastrado no Facebook Developers — mas poucos criadores de conteúdo ou gestores de tráfego sabem disso.
- A combinação **Claude + Meta API** permite que qualquer pessoa com conta no Facebook Developers execute análises, relatórios e otimizações **sem pagar nenhuma ferramenta intermediária**.
### O fluxo técnico simplificado:
1. Criar um App no **Facebook Developers** (developers.facebook.com)
2. Gerar um **Token de Acesso** com permissões de marketing (`ads_read`, `ads_management`, etc.)
3. Configurar o **Claude Desktop App** com o servidor MCP correto
4. Conectar via prompt — e pedir ao Claude para analisar, otimizar ou reportar campanhas
### Tipos de Token na Meta API:
| Tipo de Token | Para que serve |
|---|---|
| **User Access Token** | Acesso em nome de um usuário (você) |
| **Page Access Token** | Leitura/escrita de dados de uma Página do Facebook |
| **App Access Token** | Ações programáticas em nome do app, sem usuário |
| **System User Access Token** | Ações automatizadas em objetos de anúncios — ideal para integrações permanentes |
> **O mais relevante para esta integração:** User Access Token de longa duração (*long-lived token*) ou System User Access Token — ambos evitam ter que reautenticar frequentemente.
### Long-Lived Tokens (Tokens de Longa Duração):
- Tokens padrão expiram rapidamente (em horas)
- Tokens de longa duração duram **~60 dias** e são obtidos trocando o token curto por um longo via chamada à Graph API
- System User Access Tokens **não expiram** — são ideais para automações permanentes
### Ferramentas intermediárias (pagas) que fazem isso por você:
- **Adzviser:** trial de 14 dias por $0,99 — conecta Meta Ads ao Claude via MCP no-code
- **Composio:** gera uma URL MCP que conecta o Claude Code à conta Meta Ads
- **EasyInsights:** guia de conexão sem código com suporte a Meta e Google Ads
- **n8n:** plataforma de automação que integra Claude com Facebook Graph API em fluxos de trabalho
> **O diferencial do vídeo original:** ensinar o caminho **direto e gratuito**, sem depender dessas ferramentas pagas.
---
## DADOS E NÚMEROS
- **$0,99** — custo do trial de 14 dias do Adzviser para conectar Meta Ads ao Claude (opção paga mais barata)
- **v20.11.0** — versão LTS do Node.js necessária para rodar servidores MCP localmente
- **~60 dias** — duração de um long-lived user access token da Meta
- **Ilimitado** — duração de um System User Access Token (não expira)
- **2 plataformas** — Claude Desktop está disponível para Mac e Windows
- **0 reais** — custo para criar um app no Facebook Developers e gerar um token de acesso
- **Múltiplos tipos** — A Meta oferece 4 tipos de tokens diferentes, cada um com nível de permissão distinto
- **Permissões-chave necessárias:** `ads_read`, `ads_management`, `business_management`, `pages_read_engagement`
---
## CASOS E EXEMPLOS REAIS
### Empresas que já usam integrações Claude + Meta Ads (via Adzviser):
A plataforma Adzviser lista em seu site clientes de grande porte que usam a integração Meta Ads → Claude, incluindo:
- **Costco**
- **WeWork**
- **Baskin-Robbins**
- **Cole Haan**
- **Optimum Nutrition**
- **Chipotle**
- **Booking.com**
- **SurveyMonkey**
- **Pinterest**
> Isso demonstra que a prática de conectar dados de anúncios ao Claude **já é usada por marcas globais** — não é coisa de nicho ou experimental.
### Caso de uso prático documentado (Composio):
A plataforma Composio descreve o servidor MCP da Meta Ads como capaz de:
- Criar campanhas diretamente pelo agente de IA
- Gerenciar anúncios individuais
- Analisar insights de performance
- Gerenciar públicos-alvo (*audiences*)
> **Em outras palavras:** não é só relatório. É possível **criar e modificar campanhas** via prompt de texto.
### Alerta de segurança real (Madgicx):
O blog da Madgicx relata um problema real e frequente:
> *"Já vi muitos negócios terem suas contas de anúncios comprometidas porque trataram tokens de API como informação pública."*
Isso reforça a importância de **nunca expor o token em vídeos, repositórios públicos ou prints**.
---
## CITAÇÕES UTILIZÁVEIS
> *"Vou te ensinar de graça o que outros querem te cobrar em curso."*
— Gancho original do vídeo
---
> *"O servidor MCP da Meta Ads dá ao seu agente de IA acesso estruturado e seguro aos seus ativos de publicidade, para que ele possa criar campanhas, gerenciar anúncios, analisar insights e administrar públicos em seu nome."*
— Composio (traduzido)
---
> *"Já vi muitos negócios terem suas contas de anúncios comprometidas porque trataram tokens de API como informação pública. Seu token da Facebook Marketing API é sua chave de acesso — proteja-o como uma senha."*
— Madgicx Blog (traduzido)
---
> *"Atenção: conexões MCP só funcionam no Claude Desktop (o app baixável). Elas NÃO funcionam na versão web do Claude.ai no navegador."*
— EasyInsights (traduzido)
---
> *"Com o MCP, você pode criar relatórios, construir dashboards e obter insights acionáveis — tudo conversando com o Claude em linguagem natural."*
— Adzviser (traduzido)
---
> *"O Claude Pro ou Desktop é necessário — a versão gratuita não suporta conexões MCP."*
— Madgicx (traduzido)
---
## ÂNGULOS PARA CONTEÚDO
### 🎯 Ângulo 1: "O Guia Passo a Passo Gratuito"
**Formato ideal:** Vídeo tutorial / Carrossel técnico
Mostrar o processo completo do zero:
1. Criar app no Facebook Developers
2. Gerar token com as permissões certas
3. Instalar Claude Desktop + Node.js
4. Configurar o arquivo MCP
5. Fazer o primeiro prompt e ver o resultado
> **Promessa:** *"Em 20 minutos, o Claude vai estar dentro da sua conta de anúncios."*
---
### 💰 Ângulo 2: "Quanto Você Está Desperdiçando Por Não Saber Disso"
**Formato ideal:** Carrossel de conscientização / Vídeo de dor
Comparar o custo de:
- Ferramentas como Adzviser, Madgicx, EasyInsights (pagas)
- Cursos de gestão de tráfego com IA (pagos)
- Agências de tráfego (pagas)
vs.
- Facebook Developers: **R$ 0**
- Claude Desktop: **gratuito para uso básico**
- Node.js: **gratuito**
- Resultado: análise, relatório e otimização de campanhas **sem pagar nada extra**
---
### 🔐 Ângulo 3: "O Erro que Pode Destruir Sua Conta de Anúncios"
**Formato ideal:** Vídeo de alerta / Carrossel de segurança
Focado no risco de segurança: o que acontece quando você expõe seu token de acesso.
- Nunca mostrar o token em vídeos ou prints
- Nunca subir o token para repositórios públicos (GitHub)
- Usar variáveis de ambiente para proteger credenciais
- Diferença entre token temporário e permanente — qual usar e por quê
- Como revogar um token comprometido pelo painel da Meta
> **Promessa:** *"Antes de conectar qualquer IA aos seus anúncios, assista isso."*
---
### 🤖 Ângulo 4: "O Que Você Pode Mandar o Claude Fazer na Sua Conta de Anúncios"
**Formato ideal:** Carrossel de casos de uso / Vídeo de possibilidades
Listar prompts reais e resultados esperados:
- *"Qual campanha teve o menor CPL nos últimos 30 dias?"*
- *"Gere um relatório comparando a performance dos meus 3 conjuntos de anúncios"*
- *"Crie um dashboard com ROAS, CPC e frequência por campanha"*
- *"Pause todos os anúncios com CTR abaixo de 1%"*
- *"Sugira uma otimização de orçamento baseada nos dados dos últimos 7 dias"*
> **Promessa:** *"Esses são os prompts que substituem 2 horas de trabalho manual no Gerenciador."*
---
### 🆚 Ângulo 5: "MCP Direto vs. Ferramentas Pagas — Qual Escolher?"
**Formato ideal:** Vídeo comparativo / Carrossel de decisão
Comparação honesta entre os caminhos:
| | **Caminho direto (gratuito)** | **Adzviser/Composio (pago)** |
|---|---|---|
| Custo | R$ 0 | A partir de $0,99/mês |
| Dificuldade | Média (precisa configurar) | Baixa (no-code) |
| Controle | Total | Limitado ao plano |
| Segurança | Você gerencia | Terceiro gerencia |
| Ideal para | Desenvolvedores, criadores tech | Iniciantes, agências |
> **Conclusão:** depende do seu perfil — mas saber o caminho gratuito te dá autonomia total.
---
## FONTES
| Fonte | URL |
|---|---|
| EasyInsights — Como conectar Meta e Google Ads ao Claude AI | https://easyinsights.ai/blog/connect-meta-google-ads-claude-ai/ |
| Adzviser — Conectar Meta Ads ao Claude via MCP | https://adzviser.com/connect/meta-ads-to-claude-integration |
| Composio — Integração Metaads MCP com Claude Code | https://composio.dev/toolkits/metaads/framework/claude-code |
| Composio — Integração Facebook MCP com Claude Code | https://composio.dev/toolkits/facebook/framework/claude-code |
| Meta for Developers — Guia de Access Tokens | https://developers.facebook.com/docs/facebook-login/guides/access-tokens/ |
| Meta for Developers — Long-Lived Access Tokens | https://developers.facebook.com/documentation/facebook-login/guides/access-tokens/get-long-lived |
| Meta for Developers — User Access Tokens | https://developers.facebook.com/documentation/business-messaging/whatsapp/access-tokens/ |
| Madgicx — Como conectar Meta Ads ao Claude AI | https://madgicx.com/blog/connect-meta-ads-to-claude |
| n8n — Integração Claude + Facebook Graph API | https://n8n.io/integrations/claude/and/facebook-graph-api/ |
| Zapier — Claude API: como obter uma chave e usar a API | https://zapier.com/blog/claude-api/ |