API
Claude Code na sua conta de anúncio
Você cria um aplicativo no site de desenvolvedores da Meta, gera um token no Explorador da Graph API e entrega ao Claude Code, que passa a listar as contas e responder sobre as campanhas. O passo a passo inclui o caminho oficial sem colar token.
Para quem usa o Claude Code no terminal e gerencia anúncios na Meta. Quem usa só o aplicativo do Claude resolve mais rápido pelo conector oficial.
Passo a passo
Veja se este é o seu caminho
Token gerado na mão é para quem trabalha no Claude Code. No aplicativo do Claude, o conector oficial da Meta faz a mesma ligação sem aplicativo e sem token.
Entre no site de desenvolvedores
Acesse developers.facebook.com com o Facebook que gerencia os anúncios e conclua o cadastro de desenvolvedor, se ainda não tiver.
Crie o aplicativo
Clique em Criar aplicativo, dê um nome e informe o e-mail. Nos casos de uso, marque o de anúncios (Criar e gerenciar anúncios com o servidor MCP de anúncios). Opções em cinza estão bloqueadas, é normal.
Escolha o portfólio empresarial
Selecione a BM dos seus anúncios, avance até o resumo e clique em Ir para o painel.
Gere o token
Abra Ferramentas e depois Explorador da Graph API. Selecione o seu aplicativo, adicione a permissão ads_read e gere o token de acesso. Para usar o servidor MCP da Meta, a documentação pede também ads_mcp_management.
Entregue ao Claude Code
Cole o prompt de conexão e, quando ele pedir, o token. Ele lista as suas contas de anúncio e responde às perguntas.
Comece só por relatório
Com a permissão ads_read o token só lê. Mantenha assim até confiar no que ele devolve.
Conheça o caminho sem colar token
A Meta documenta um comando que liga o Claude Code ao servidor dela com login pelo navegador. Está no bloco de copiar: troque o trecho indicado pelo ID do seu aplicativo.
Prompts para copiar
Prompt de conexão no Claude Code
Você vai consultar a minha conta de anúncios da Meta pela API de Marketing, só para leitura. Contexto: eu vou colar um token de acesso de usuário gerado no Explorador da Graph API, com a permissão ads_read. Ele vence em uma ou duas horas. Tarefa: peça o token, guarde só numa variável de ambiente desta sessão e liste as contas de anúncio que ele alcança, com nome, ID e moeda. Depois espere a minha pergunta. Formato: tabela com as contas. Em cada resposta seguinte, diga o período consultado e de qual conta saiu o dado. Não faça: não grave o token em arquivo, não repita o token na tela, não faça nenhuma chamada que crie, edite, pause ou apague algo. Se uma chamada falhar por permissão, me avise em vez de pedir permissão maior.
Pergunta de relatório
Na conta [NOME OU ID DA CONTA], nos últimos 7 dias, qual campanha ativa está com o custo por resultado mais alto? Mostre as campanhas ativas em tabela, com gasto, resultados e custo por resultado, e diga em duas frases o que explica a pior. Não altere nada.
Caminho oficial sem colar token (terminal)
claude mcp add --transport http --client-id <ID_DO_SEU_APLICATIVO> meta-ads https://mcp.facebook.com/ads
Links
- Meta for DevelopersSite de desenvolvedores da Meta, onde você cria o aplicativo.
- Guia do Explorador da Graph APIDocumentação oficial da ferramenta que gera o token.
- Servidor MCP de anúncios: como começarPágina oficial com as permissões e o comando para o Claude Code.
- Tokens de acesso da MetaExplica quanto tempo dura cada tipo de token.
O token vale como senha da conta de anúncio. Não mostre em vídeo, não mande por mensagem e não salve em arquivo.
Token de usuário de curta duração costuma durar de uma a duas horas, segundo a Meta. Serve para ver funcionando; uso contínuo pede o caminho oficial com login.
Dê só a permissão de leitura (ads_read) enquanto estiver testando. Com ads_management o Claude Code consegue alterar campanha.
Conferido em 14/11/2026. Ferramenta muda rápido: se algo não bater, me avisa no direct.