@adseditor/mcp-server

MCP (Model Context Protocol) Server para o Ads Editor.

Permite que clientes MCP — como o Claude Desktop — interajam com sua conta do Ads Editor para listar contas Meta/Google, ver métricas, clonar campanhas, criar relatórios e mais.

Pré-requisitos

• Node.js 18+
• Plano ativo no Ads Editor
• Um token MCP gerado em /mcp

Instalação no Claude Desktop

1. Faça login em https://app.adseditor.com.br e acesse MCP Server no menu lateral.
2. Clique em Novo Token, escolha um nome e copie o valor exibido.
3. Edite o arquivo claude_desktop_config.json:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
4. Adicione a configuração:

{
  "mcpServers": {
    "adseditor": {
      "command": "npx",
      "args": ["-y", "@adseditor/mcp-server"],
      "env": {
        "ADSEDITOR_MCP_TOKEN": "adseditor_mcp_SEU_TOKEN_AQUI",
        "ADSEDITOR_API_URL": "https://app.adseditor.com.br"
      }
    }
  }
}

5. Reinicie o Claude Desktop. Você verá as ferramentas do Ads Editor na lista do MCP.

Variáveis de ambiente

| Variável | Obrigatório | Default | Descrição | |-----------------------|-------------|----------------------------------|----------------------------------------| | ADSEDITOR_MCP_TOKEN | Sim | — | Token gerado em /mcp no painel | | ADSEDITOR_API_URL | Não | https://app.adseditor.com.br | Base URL do backend (custom domain) |

Ferramentas disponíveis

A lista exata é descoberta dinamicamente via tools/list. Ferramentas padrão:

| Tool | Descrição | |-----------------------|--------------------------------------------------------------| | list_meta_accounts | Lista contas de anúncio Meta conectadas | | list_google_accounts| Lista contas Google Ads conectadas | | list_campaigns | Lista campanhas/adsets/ads de uma conta | | get_campaign_metrics| Métricas (spend, CTR, CPM, ROAS, etc.) de um objeto | | get_account_summary | Totais agregados da conta no período | | list_audiences | Públicos personalizados | | pause_campaign | Pausa uma campanha/adset/ad | | activate_campaign | Ativa uma campanha/adset/ad | | update_budget | Atualiza daily_budget de um adset (em centavos) | | clone_campaign | Clona campanha (mesma conta ou cross-account) | | get_report | Recupera relatório por ID ou slug | | create_report | Cria novo relatório | | list_rules | Lista regras automatizadas |

Exemplos no Claude

"Liste minhas contas Meta e mostre o ROAS dos últimos 7 dias da minha melhor conta."

"Clone a campanha XYZ para a conta act_1234567890 mantendo a página atual."

"Pause todos os adsets da campanha ABC com CPA acima de R$ 30."

Segurança

• O token é enviado apenas ao backend Ads Editor via HTTPS, com header Authorization: Bearer ....
• O token nunca é logado em stdout; mensagens de erro vão para stderr e não incluem o valor.
• O backend valida o token (hash SHA-256), revogabilidade, plano ativo e permissões a cada chamada.
• Rate limit: 100 requisições/minuto por token.
• Você pode revogar qualquer token a qualquer momento em https://app.adseditor.com.br/mcp.

Desenvolvimento local

git clone https://github.com/theusmyep/saas-main.git
cd saas-main/mcp-server
npm install
ADSEDITOR_MCP_TOKEN=adseditor_mcp_xxx ADSEDITOR_API_URL=http://localhost:3000 node index.js

Licença

Uso interno Ads Editor. Consulte os termos em https://app.adseditor.com.br.