Per sviluppatori · Claude e Cursor supportati

Guida all'integrazione MCP

Usa il Model Context Protocol per permettere a Claude, Cursor o al tuo agente AI di consultare i tuoi dati DEXUN AdWhiz: account pubblicitari collegati sulle tre piattaforme, suggerimenti dell'AI e attività recente. In sola lettura.

Cos'è MCP?

MCP (Model Context Protocol) è lo standard aperto lanciato da Anthropic nel 2024 che definisce come le applicazioni AI accedono in modo sicuro a dati e strumenti esterni. Pensalo come «l'USB-C dell'AI»: un'unica interfaccia che permette a qualsiasi client MCP (Claude Desktop, Cursor, il tuo agente) di chiamare qualsiasi server MCP (DEXUN AdWhiz, Notion, GitHub, ecc.).

Il server MCP di DEXUN AdWhiz espone 5 strumenti in sola lettura: i tuoi account pubblicitari collegati, i suggerimenti aperti dell'AI, il riepilogo dei risparmi, l'attività recente dell'account e la tua quota API. Non può modificare, mettere in pausa né creare nulla nei tuoi account pubblicitari. Ogni chiamata è autenticata con la tua API key e rientra negli stessi limiti per piano della nostra API REST.

Avvio rapido

Tre passaggi. Circa cinque minuti e potrai chiedere al tuo assistente AI dei tuoi account pubblicitari.

1

Configura Claude Desktop

Modifica claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\) e aggiungi:

# 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

Configura Cursor

Tramite il file .cursor/mcp.json del progetto o la configurazione globale:

# 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

Verifica

Riavvia Claude o Cursor e prova questo prompt. Se vedi l'AI chiamare list_ad_accounts o list_recommendations e restituire i tuoi dati reali, sei collegato.

Chiedi a Claude:

«Elenca i miei account pubblicitari collegati e riassumi i suggerimenti aperti dell'AI: quali campagne consiglia di modificare e perché?»

Catalogo degli strumenti

Il server MCP espone 5 strumenti, tutti in sola lettura. Ognuno ha uno JSON Schema completo, così l'AI decide da sola quale chiamare e quando.

list_ad_accounts

Sola lettura

I tuoi account Google Ads, Meta Ads e TikTok Ads collegati e il loro stato di connessione.

list_recommendations

Sola lettura

I suggerimenti di ottimizzazione aperti dell'AI (aumentare il budget, ridurlo, mettere in pausa), ognuno con motivazione, impatto previsto e livello di confidenza.

get_savings_summary

Sola lettura

Il riepilogo dei risparmi: rimanda ai valori di risparmio nella tua dashboard, insieme al tuo piano.

get_recent_activity

Sola lettura

Attività recente dell'account: accessi, modifiche alle API key, collegamenti di account pubblicitari e cambi di abbonamento.

get_quota

Sola lettura

Il tuo limite API attuale: richieste al minuto, quante ne restano e quando si azzera la finestra.

Il tuo client AI elenca gli stessi strumenti, con i relativi parametri, tramite la richiesta MCP standard tools/list.

Sessione di esempio

Una conversazione di esempio (dati fittizi) che mostra com'è l'accesso in sola lettura:

Quali account pubblicitari ho collegato ad AdWhiz?

Hai tre account collegati: uno Google Ads, uno Meta Ads e uno TikTok Ads. Tutti e tre risultano collegati.

list_ad_accounts

Cosa suggerisce l'AI in questo momento?

Ci sono 2 suggerimenti aperti: ① ridurre il budget giornaliero della campagna Meta «Lookalike 1%», il cui ROAS è sotto la media dell'account da una settimana; ② aumentare il budget di una campagna TikTok Spark Ads. Ognuno indica la motivazione e un livello di confidenza. Se vuoi applicarli, fallo nella tua piattaforma pubblicitaria: da qui non posso modificare nulla.

list_recommendations

Negli ultimi tempi è cambiato qualcosa nel mio account?

Negli ultimi 7 giorni: 2 accessi, 1 nuova API key e il ricollegamento del tuo account TikTok Ads. Non risulta altro.

get_recent_activity

Sicurezza e permessi

  • Tutti e 5 gli strumenti sono in sola lettura: l'AI può consultare i tuoi dati, ma non modificare budget, mettere in pausa inserzioni o creare campagne
  • Il server MCP gira in locale: la tua API key dxk_ non lascia mai il tuo computer verso terze parti
  • Le chiamate sono autenticate con la tua API key e condividono i limiti dell'API REST del tuo piano (verificabili con get_quota)
  • Le modifiche alle tue campagne le fai tu, non tramite MCP
  • Revoca l'accesso MCP in qualsiasi momento da dashboard → Impostazioni → API Keys