Servidor MCP (Model Context Protocol) do Ads Editor, plataforma independente de gestão de Meta Ads e Google Ads para gestores de tráfego e agências. Com ele, o Claude, o ChatGPT, o Codex e o Cursor consultam e executam ações nas suas contas de anúncio: listar campanhas, criar conjuntos, clonar entre contas, ajustar orçamento, criar regras, ler relatórios e vendas.
O Ads Editor não é o Google Ads Editor nem um produto da Meta ou do Google. Este repositório contém apenas documentação, identidade visual e configuração de conexão para clientes MCP. O servidor é remoto e roda exclusivamente na infraestrutura do Ads Editor.
O que é
Um servidor MCP remoto (Streamable HTTP) que expõe as funções do Ads Editor como ferramentas para clientes de IA. Cada usuário conecta com a própria credencial e só enxerga as contas às quais tem permissão dentro do Ads Editor.
Diferença para os conectores oficiais: o conector da Meta cobre só a Meta e o do Google é só de leitura. O Ads Editor cobre Meta Ads e Google Ads, lê e escreve, e soma funções da própria plataforma (regras, escala, monitor de saldo, relatórios, vendas por UTM).
Como conectar
Pré-requisito: conta no Ads Editor (7 dias de teste) com pelo menos uma conta de anúncio conectada. A URL e a forma de autenticação (OAuth ou token pessoal) aparecem em https://app.adseditor.com.br/mcp. Os passos abaixo seguem o formato genérico de servidor MCP remoto; a tela de cada cliente muda com a versão, então confira a documentação do cliente se algum menu tiver outro nome.
Claude (Desktop e web)
- Configurações > Conectores > Adicionar conector personalizado.
- Nome:
Ads Editor. URL: https://app.adseditor.com.br/mcp.
- Autorize quando o Claude abrir a tela de login do Ads Editor.
Claude Code (terminal):
claude mcp add --transport http adseditor "https://app.adseditor.com.br/mcp"
ChatGPT
- Configurações > Conectores > Criar (é preciso ativar o modo de desenvolvedor).
- Nome:
Ads Editor. URL do servidor MCP: https://app.adseditor.com.br/mcp.
- Autenticação: OAuth. Autorize na tela do Ads Editor.
- Em uma conversa nova, ative o conector Ads Editor. Conversa aberta antes do cadastro não vê as ferramentas.
Codex
codex mcp add adseditor --url "https://app.adseditor.com.br/mcp"
Ou em ~/.codex/config.toml:
[mcp_servers.adseditor]
url = "https://app.adseditor.com.br/mcp"
Cursor
Este repositório inclui o pacote de conexão para o Cursor. Instalar o plugin conecta o cliente ao serviço remoto; não instala um servidor local.
- É necessário ter uma conta no Ads Editor com acesso ao MCP, conforme o plano e as permissões da conta.
- Ao conectar, conclua o login e a autorização OAuth no domínio
app.adseditor.com.br. O Cursor recebe uma autorização individual; o pacote não inclui tokens.
- Cada usuário continua limitado às contas e funções que pode acessar no Ads Editor. A instalação do plugin não concede permissões adicionais.
- Para conexão manual, use a configuração abaixo. Após salvar, abra as configurações de MCP do Cursor e conclua a autenticação quando solicitado.
Em .cursor/mcp.json (projeto) ou ~/.cursor/mcp.json (global):
{
"mcpServers": {
"adseditor": {
"url": "https://app.adseditor.com.br/mcp"
}
}
}
Se a tela do Ads Editor entregar um token pessoal em vez de OAuth, acrescente "headers": { "Authorization": "Bearer <token>" } dentro de adseditor.
Capacidades disponíveis
Conforme o plano e as permissões da conta, o serviço permite trabalhar com campanhas Meta Ads e Google Ads, públicos, orçamentos, regras, alertas, relatórios e atribuição de vendas.
O catálogo efetivo é apresentado ao cliente de IA após a autenticação. Este pacote não distribui implementações, esquemas ou documentação de operações administrativas internas.
Exemplos de prompt
- "Liste as campanhas ativas da conta X com gasto e resultado dos últimos 7 dias."
- "Clone a campanha Y da conta A para a conta B trocando a página, o Instagram, o pixel e o WhatsApp pelos da conta B. Deixe pausada."
- "Crie 5 públicos de envolvimento no Instagram nas contas A, B e C, com os mesmos nomes."
- "Quais contas estão com saldo abaixo do gasto diário previsto?"
- "Crie uma regra que pause qualquer conjunto com CPA acima do dobro da meta por 2 dias seguidos."
- "No Google Ads, adicione estas palavras-chave negativas em todas as campanhas de pesquisa da conta X."
- "Quantas vendas da Hotmart vieram da campanha Z esta semana e qual foi o custo por venda?"
Segurança
- Identidade: cada usuário conecta com a própria conta do Ads Editor, por OAuth ou token pessoal gerado na tela de MCP. O token é do usuário, não da empresa, e pode ser revogado ali.
- Permissão por conta: membro de equipe só enxerga e só age nas contas liberadas para ele no Ads Editor. A permissão vale também no MCP: ferramenta de uma área sem permissão não aparece na lista e é negada na chamada.
- Escrita com freio: campanhas, conjuntos e anúncios criados ou clonados pela IA nascem pausados; há teto de segurança para orçamento diário criado ou alterado por ferramenta.
- Credenciais das plataformas: os tokens da Meta e do Google ficam cifrados no servidor e nunca passam pelo cliente de IA.
- 2FA: disponível para toda conta do Ads Editor.
Preços
Planos de R$ 97 por mês (10 contas) a R$ 697 por mês (70 contas), 20% de desconto no anual, 7 dias de teste. O MCP está incluído nos planos; detalhes em https://adseditor.com.br/pricing.
English
Ads Editor MCP is a remote MCP server (Streamable HTTP) for Ads Editor, an independent Meta Ads and Google Ads management platform for media buyers and agencies. It lets Claude, ChatGPT, Codex and Cursor read and write to your ad accounts: list and create campaigns, clone campaigns between accounts while swapping Page, Instagram, pixel and WhatsApp, create audiences in bulk, adjust budgets, create automated rules, read reports and UTM-attributed sales, and manage Google Ads (Search, Performance Max, negative keywords).
Ads Editor is not Google Ads Editor and not a Meta or Google product.
Connect: get the server URL and credentials at https://app.adseditor.com.br/mcp, then add it as a remote MCP server in your client (Claude: Settings > Connectors > Add custom connector; ChatGPT: Settings > Connectors > Create, developer mode; Codex: codex mcp add adseditor --url <URL>; Cursor: .cursor/mcp.json with "url").
Security: OAuth or per-user token, per-account permissions for team members, AI-created objects start paused, platform tokens encrypted server-side, 2FA available.
Pricing: from R$ 97/month (10 ad accounts) to R$ 697/month (70 ad accounts), 20% off yearly, 7-day trial. Interface in Portuguese (Brazil).
Connection guide: https://adseditor.com.br/mcp. Guides: https://adseditor.com.br/blog.
Conteúdo deste pacote
mcp.json: endereço HTTPS do serviço remoto, sem credenciais..cursor-plugin/plugin.json: identificação do plugin para o Cursor.assets/logo.svg: ícone público do Ads Editor.server.json: metadados para diretórios MCP.README.md: instruções de conexão.
O código-fonte do servidor, implementações de ferramentas, regras de negócio, banco de dados e credenciais não são distribuídos neste repositório. Baixar estes arquivos não permite executar uma cópia do servidor Ads Editor. A disponibilidade pública deste pacote de conexão não concede acesso ao serviço nem licença sobre o código privado ou a marca.