Il lunedì mattina vuoi capire quanto hanno speso le campagne, quali risultati sono cambiati e se i numeri dei vari canali sono confrontabili. Collegare un assistente ai tuoi account può toglierti il lavoro di copiare dati da più interfacce; non risolve però le differenze di attribuzione. Parti da un account che puoi consultare, da un report ben definito e da un perimetro di sola lettura.

Che differenza c’è tra MCP e API?

Un client AI invoca il server MCP, che legge un report dall’API pubblicitaria autorizzata.

Schema originale. I permessi del client e della piattaforma possono essere distinti. Restituisci report aggregati, non cartelle individuali.

L’API di una piattaforma pubblicitaria stabilisce quali campagne, metriche e operazioni sono accessibili. MCP, il Model Context Protocol, stabilisce invece come un client può individuare e invocare strumenti messi a disposizione da un server. Una configurazione comune è: assistente → server MCP → API della piattaforma → dati strutturati. MCP non sblocca metriche riservate, non sostituisce le autorizzazioni sulla piattaforma e non rende comparabili due conversioni solo perché arrivano nello stesso formato.

Un connettore nativo è integrato nel client: può semplificare la configurazione, ma la sua disponibilità non implica che includa la reportistica pubblicitaria del tuo account. Un adattatore di terze parti o autogestito può esporre soltanto certi report, account o campi e uniformare il formato di risposta; in cambio devi verificare chi tratta i dati, dove vengono conservati e chi mantiene l’integrazione. Un test utile vale più del logo di una piattaforma: il connettore riesce a leggere la spesa dell’account pubblicitario selezionato senza offrire funzioni per modificarlo?

OAuth: controlla chi concede accesso, e a cosa

OAuth consente di autorizzare un’applicazione ad accedere a risorse delimitate senza passarle la password. Distingui tre livelli: l’accesso del client al connettore, i permessi con cui il connettore interroga la piattaforma e il ruolo dell’utente sul singolo account pubblicitario. Possono esserci token distinti per i primi due passaggi. Una connessione riuscita al server MCP non dimostra che l’API pubblicitaria permetta di leggere il report. Se ricevi un 401 o un 403, verifica scadenza e destinazione del token, permessi e ruolo prima di chiedere accessi più ampi.

La sola lettura si applica a monte, non con un semplice prompt. Usa i permessi minimi disponibili per la reportistica, limita gli account consentiti e non esporre al modello funzioni per cambiare budget, pubblicare annunci o caricare liste di pubblico. Conserva i token nel gestore di segreti del servizio, mai nella chat, nei documenti condivisi o nel repository. Se dismetti l’integrazione, revoca le autorizzazioni e controlla che la raccolta sia cessata. Per il livello di trasporto, consulta la specifica di autorizzazione MCP.

Metti d’accordo i denominatori, non solo le colonne

Per ogni riga conserva piattaforma, account, intervallo, fuso orario, valuta, definizione della conversione e finestra di attribuzione. Confronta periodi completi ed evidenzia i giorni più recenti se i dati possono ancora cambiare. Due piattaforme possono attribuirsi la stessa prenotazione: sommare le loro conversioni non restituisce il numero di persone uniche. I report delle piattaforme aiutano a diagnosticare un singolo canale; per un totale trasversale, usa dati aggregati e deduplicati del CRM o del sistema prenotazioni, quando l’uso è autorizzato. Tieni separate le valute o indica fonte e data del cambio. Se c’è spesa ma le conversioni sono zero, il CPA non è calcolabile: non indicarlo come zero.

Nel marketing sanitario, un contatto, una prenotazione confermata e una visita effettuata sono tre esiti diversi. Al modello bastano, per esempio, i conteggi settimanali per canale. Non inviare nomi, numeri di telefono, diagnosi, note cliniche o identificativi dei pazienti. Accorpa o nascondi i segmenti troppo piccoli per evitare che i risultati permettano di risalire alle persone.

Esegui il primo test con l’appendice

Scegli una piattaforma nella tabella e verifica che il connettore supporti il report e l’account desiderati. Nell’esempio, sostituisci i parametri con ID account, date, valuta e definizione di conversione pertinenti; non incollare credenziali. Chiedi anche l’ora di aggiornamento e l’elenco dei campi mancanti, che non vanno convertiti in zeri. Controlla una settimana completa nell’interfaccia pubblicitaria con gli stessi filtri e la stessa attribuzione.

Il test è riuscito se riesci a ricostruire l’origine di ogni dato, riconciliare il report con l’interfaccia e dimostrare che l’assistente non può modificare le campagne. Solo allora aggiungi un secondo account o canale. La prima vittoria non è l’automazione completa: è poter prendere una decisione sul budget sapendo esattamente cosa misurano i numeri.

Collegamento per piattaforma

Google Ads

Pacchetto ufficiale locale o deployment Streamable HTTP gestito da te. Servono progetto Cloud abilitato, Application Default Credentials e accesso all’account. Disattiva assets e labels via YAML; usa search_search. Indica l’ID del manager se necessario.

Meta Ads

Meta ospita https://mcp.facebook.com/ads. Usa un connettore supportato oppure OAuth della tua app. Per quest’ultima verifica ads_mcp_management e ads_read; abilita solo i report. Chiedi le campagne con maggiore spesa.

TikTok Ads

MCP ufficiale con lettura e scrittura. Autorizza con il flusso OAuth supportato. Parti dall’endpoint progressivo qui sotto e dai soli report. Flat e progressive cambiano la scoperta degli strumenti, non i permessi.

Snap Ads

MCP ufficiale in sola lettura: https://mcp.snapchat.com/ads. Segui i passaggi per l’approvazione dell’organizzazione e il consenso del membro in un client supportato. Parti da spesa e impression di un account.

Microsoft Advertising

Server ufficiale: https://partner.api.bingads.microsoft.com/ext/mcp/vnext. Usa Microsoft Entra OAuth seguendo i passaggi del client. Gli strumenti sono documentati come sola lettura, nonostante il nome msads.manage. Prova get_campaigns.

Amazon Ads

Beta aperta ufficiale per partner Ads API idonei. Usa la guida Lite di Amazon per l’endpoint e l’autorizzazione Ads, separata da Seller Central. Lite non equivale a sola lettura; parti dalla ricerca degli account e poi dai report.

LinkedIn Ads

App ChatGPT di sola lettura in beta, dove disponibile. Non è stato verificato un URL MCP pubblico per client generici. Per un’integrazione personalizzata usa Advertising API approvata, OAuth del membro e r_ads_reporting; vedi GET /rest/adAnalytics.

X Ads

Server ufficiale: https://ads-api.x.com/mcp. Usa OAuth utente con ads.read e offline.access per rinnovare il token, senza ads.write. Inizia con list_ads_accounts e vedi l’esempio OpenAI incluso.

TikTok progressive MCP

https://business-api.tiktok.com/open_mcp/tt-ads-mcp-layer

Esegui la demo locale

Esegui dalla cartella estratta. Lo smoke test stdio non contatta piattaforme pubblicitarie. Copia ads_demo dal TOML e sostituisci i percorsi. Chiedi l’account demo dal 2026-11-01 al 2026-11-07. Usa LinkedIn reale solo dopo aver caricato il token dal gestore dei segreti e impostato ADS_SOURCE=linkedin, LINKEDIN_AD_ACCOUNTS e una LINKEDIN_VERSION supportata. Le righe mostrate sono limitate, non rappresentano il totale dell’account.

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r code/requirements.txt
python code/smoke_test.py

File di codice e passo successivo

  • `Codex Examples.toml`: Configurazione Codex per server locale, Google e X.
  • `Google Read Only.yaml + Google Campaign Report.gaql`: Configurazione Google di sola lettura e query GAQL per l’API; non passare GAQL grezzo a uno strumento MCP che richiede campi strutturati.
  • `Meta Insights.sh`: Controllo Graph API separato da MCP; legge solo la prima pagina.
  • `OpenAI Remote Example.py`: OpenAI Responses API: URL HTTPS, token OAuth e uno strumento. Attendi la verifica dell’operatore quando è richiesta l’approvazione; l’esempio non approva automaticamente.

Collega Snap Ads a Codex

Esegui i comandi sul dispositivo in cui usi Codex e completa il consenso su Snapchat. Lo scope documentato è snapads.read. Se il client non è ancora autorizzato per l’organizzazione, serve l’approvazione di un amministratore.

codex mcp add snap-ads --url https://mcp.snapchat.com/ads --oauth-client-id codex-snap-ads
codex mcp login snap-ads

Snap for Developers: client setup

Scarica solo il codice di esempio (ZIP)

La demo è stata testata con dati sintetici e l’adattatore LinkedIn con risposte simulate. Nessun account pubblicitario reale è stato testato.