Para desenvolvedores · compatível com Claude e Cursor

Guia de integração MCP

Use o Model Context Protocol para que o Claude, o Cursor ou seu próprio agente de IA consultem seus dados na DEXUN AdWhiz: contas de anúncios conectadas das três plataformas, recomendações da IA e atividade recente. Somente leitura.

O que é MCP?

MCP (Model Context Protocol) é o padrão aberto que a Anthropic lançou em 2024 para definir como aplicações de IA acessam dados e ferramentas externas com segurança. Pense nele como "o USB-C da IA" — uma única interface para que qualquer cliente MCP (Claude Desktop, Cursor, seu próprio agente) chame qualquer servidor MCP (DEXUN AdWhiz, Notion, GitHub etc.).

O servidor MCP da DEXUN AdWhiz expõe 5 ferramentas somente leitura: suas contas de anúncios conectadas, as recomendações em aberto da IA, seu resumo de economia, a atividade recente da conta e sua cota de API. Ele não altera, não pausa e não cria nada nas suas contas de anúncios. Toda chamada é autenticada com sua API key e conta para os mesmos limites por plano da nossa API REST.

Início rápido

Três passos. Cerca de cinco minutos para você poder perguntar ao seu assistente de IA sobre suas contas de anúncios.

1

Configure o Claude Desktop

Edite o claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\) e adicione:

# Claude Desktop config: ~/.../claude_desktop_config.json
{
  "mcpServers": {
    "dexun-adwhiz": {
      "command": "npx",
      "args": ["-y", "@dexun/adwhiz-mcp@latest"],
      "env": {
        "ADWHIZ_API_KEY": "dxk_live_..."
      }
    }
  }
}
2

Configure o Cursor

Via .cursor/mcp.json no nível do projeto ou na configuração global:

# Cursor: ~/.cursor/mcp.json (or Project → Settings → MCP)
{
  "mcpServers": {
    "dexun-adwhiz": {
      "command": "npx",
      "args": ["-y", "@dexun/adwhiz-mcp@latest"],
      "env": { "ADWHIZ_API_KEY": "dxk_live_..." }
    }
  }
}
3

Verifique

Reinicie o Claude ou o Cursor e teste este prompt. Se a IA chamar list_ad_accounts ou list_recommendations e retornar seus dados reais, a conexão está pronta.

Pergunte ao Claude:

“Liste minhas contas de anúncios conectadas e resuma as recomendações em aberto da IA: quais campanhas ela sugere alterar e por quê?”

Catálogo de ferramentas

O servidor MCP expõe 5 ferramentas, todas somente leitura. Cada uma tem um JSON Schema completo, então a IA decide sozinha quando chamar cada uma.

list_ad_accounts

Somente leitura

Suas contas conectadas do Google Ads, Meta Ads e TikTok Ads e o status de cada conexão.

list_recommendations

Somente leitura

As recomendações de otimização em aberto da IA (aumentar orçamento, reduzir, pausar), cada uma com motivo, impacto esperado e nível de confiança.

get_savings_summary

Somente leitura

Seu resumo de economia: aponta para os valores de economia no seu painel, junto com seu plano.

get_recent_activity

Somente leitura

Atividade recente da conta: logins, mudanças de API keys, conexões de contas de anúncios e mudanças de assinatura.

get_quota

Somente leitura

Seu limite de API atual: requisições por minuto, quantas restam e quando a janela é reiniciada.

Seu cliente de IA lista essas mesmas ferramentas, com os parâmetros, pela requisição padrão tools/list do MCP.

Sessão de exemplo

Uma conversa de exemplo (dados fictícios) mostrando como é o acesso somente leitura:

Quais contas de anúncios eu tenho conectadas à AdWhiz?

Você tem três contas conectadas: uma do Google Ads, uma do Meta Ads e uma do TikTok Ads. As três aparecem como conectadas.

list_ad_accounts

O que a IA recomenda agora?

Há 2 recomendações em aberto: ① reduzir o orçamento diário da campanha da Meta “Lookalike 1%”, cujo ROAS ficou abaixo da média da conta na última semana; ② aumentar o orçamento de uma campanha de TikTok Spark Ads. Cada uma traz o motivo e um nível de confiança. Se quiser aplicá-las, faça isso na sua plataforma de anúncios — daqui eu não consigo alterar nada.

list_recommendations

Algo mudou na minha conta recentemente?

Nos últimos 7 dias: 2 logins, 1 nova API key e a reconexão da sua conta do TikTok Ads. Não há mais nada registrado.

get_recent_activity

Segurança e permissões

  • As 5 ferramentas são somente leitura: a IA consulta seus dados, mas não altera orçamentos, não pausa anúncios nem cria campanhas
  • O servidor MCP roda localmente — sua API key dxk_ nunca sai da sua máquina para terceiros
  • As chamadas são autenticadas com sua API key e compartilham os limites da API REST do seu plano (confira com get_quota)
  • Alterações nas suas campanhas são feitas por você, não pelo MCP
  • Revogue o acesso MCP a qualquer momento em painel → Configurações → API Keys