Come collegare Snapchat Ads a Gemini via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Snapchat Ads, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Snapchat Ads + Gemini

Fai lavorare la tua AI con i tuoi annunci Snapchat: elenca organizzazioni, account pubblicitari, campagne, ad squad, annunci, creatività e pubblici, leggi impression, swipe e spesa per giorno o in totale, e metti in pausa o riattiva una campagna dopo la tua conferma. Accesso tramite una tua app OAuth in Snap Business Manager.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

SNAPCHAT_CLIENT_ID, SNAPCHAT_CLIENT_SECRET

Step 1 — Ottieni le credenziali

1. Accedi a business.snapchat.com come Organization Admin. Solo gli admin vedono le impostazioni delle app OAuth.
2. Apri Business Details (o Business Settings) → OAuth Apps e crea un'app. Dagli un nome e imposta il Redirect URI su https://cloud.anythingmcp.com/api/mcp-oauth/callback. Se ospiti AnythingMCP da solo, usa https://your-anythingmcp-host/api/mcp-oauth/callback. Accetta gli Snap Developer Terms e gli Snap Business Tools Terms.
3. Copia il Client ID in SNAPCHAT_CLIENT_ID e il Client Secret in SNAPCHAT_CLIENT_SECRET. Il secret viene mostrato una sola volta; se lo perdi, crea una nuova app.
4. Installa il connettore, clicca Authorize with Provider nella pagina del connettore, accedi con l'account Snapchat che ha accesso ai tuoi account pubblicitari e approva.
5. Inizia con snapchat_list_organizations: elenca le tue organizzazioni con i loro account pubblicitari, valuta e fuso orario.

La Marketing API è aperta a ogni inserzionista: non serve nessuna richiesta né revisione da parte di Snap.

Chi vede cosa: il connettore chiede lo scope snapchat-marketing-api e vede ciò che l'utente collegato può vedere in Ads Manager. Gli account pubblicitari su cui quell'utente non ha un ruolo rispondono 403.

Cosa legge: organizzazioni e account pubblicitari; campagne con obiettivo, periodo, budget giornaliero e limite di spesa; ad squad (i gruppi di annunci di Snapchat) con posizionamento, obiettivo di ottimizzazione, offerta, budget e targeting; annunci con stato di revisione e motivi di rifiuto; creatività; e segmenti di pubblico come liste clienti e lookalike con la loro dimensione approssimativa. Le statistiche danno impression, swipe, spesa e altre metriche per un account pubblicitario, una campagna, un ad squad o un annuncio, come totale unico o per giorno (fino a 31 giorni) o per ora (fino a 7 giorni), anche suddivise per campagna, ad squad o annuncio.

Importi in micro-valuta: Snapchat esprime budget, offerte e spesa in milionesimi della valuta dell'account, quindi una spesa di 12345678 vale 12,35. L'AI converte i valori prima di citarli. I numeri diventano definitivi 48 ore dopo la fine della giornata.

Chiede prima di ogni modifica: snapchat_set_campaign_status mette in pausa una campagna o la riattiva. Riattivarla fa partire la spesa del suo budget, quindi l'AI nomina la campagna, dice cosa succederà e aspetta il tuo sì. Cambia solo lo stato; Snapchat poi controlla l'intera campagna e rifiuta la modifica se qualcosa non è valido.

Disattivato all'installazione: snapchat_set_campaign_daily_budget. Una modifica al budget decide quanto denaro viene speso, quindi un amministratore attiva lo strumento consapevolmente; l'AI mostra poi la modifica e chiede prima anche in questo caso.

Restare collegati: gli access token durano un'ora e vengono rinnovati automaticamente. Se l'utente viene rimosso dall'organizzazione o l'app viene eliminata, l'accesso termina; a quel punto clicca di nuovo Authorize with Provider.

Errori comuni: 401: l'accesso è scaduto o è stato revocato; autorizza di nuovo. 403: l'utente non ha un ruolo su quell'organizzazione o account pubblicitario. 400: Snapchat indica il campo nel messaggio, per esempio quando rifiuta un cambio di stato; per le statistiche chiedi meno metriche o un periodo più breve. 429: troppe richieste; aspetta e riprova.

Il connettore non crea né elimina campagne, ad squad, annunci o creatività, non carica media, non cambia il targeting e non copre la Conversions API, i pixel, la fatturazione o le fatture.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in Gemini

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di Snapchat Ads.

Tool disponibili

Esempi di prompt

• "Quanto abbiamo speso su Snapchat la settimana scorsa per campagna, con impression e swipe?"
• "Quali dei nostri annunci sono stati rifiutati in revisione, e perché?"
• "Mostrami spesa e swipe giornalieri della campagna Summer Sale dal 1 al 14 ottobre."
• "Metti in pausa la campagna Back to School. Dimmi prima esattamente cosa succederà."
• "Elenca i nostri segmenti di pubblico utilizzabili per il targeting, con la loro dimensione approssimativa."

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT