Meta Ads su MCP: Pilota Meta Ads da qualsiasi agente AI

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

Meta Ads

Fai analizzare alla tua AI le tue inserzioni Facebook e Instagram: spesa, copertura, clic e conversioni per campagna, gruppo di inserzioni, inserzione, età, paese o posizionamento, più campagne, creatività, pubblici e cronologia delle modifiche. Può mettere in pausa o attivare le inserzioni e cambiare i budget dopo la tua conferma.

Setup

1. Apri https://developers.facebook.com/apps/creation/ e crea un'app con il caso d'uso Create & manage ads with Marketing API, collegata al tuo portfolio business. Così riceve le autorizzazioni ads_read, ads_management e business_management.
2. Consigliato, un token che non scade mai: in Business Settings (https://business.facebook.com/settings) apri Users → System users e aggiungi un utente di sistema (ruolo Admin, oppure Employee per la sola lettura). In Assign assets assegnagli il tuo account pubblicitario (Manage campaigns, oppure View performance per la sola lettura). Fai clic su Generate token, scegli l'app, imposta la scadenza su Never e spunta ads_read, più ads_management per le modifiche di stato e budget. Meta può chiederti prima di verificare il portfolio business (Business Settings → Security Center); finché non è fatto, usa il token del passo 3.
3. Più rapido, per una prova: nel Graph API Explorer (https://developers.facebook.com/tools/explorer/) scegli la tua app e un User Token con ads_read e ads_management. Dura una o due ore, quindi aprilo nell'Access Token Debugger (https://developers.facebook.com/tools/debug/accesstoken) e fai clic su Extend Access Token per ottenere un token da 60 giorni.
4. Incolla il token in META_ADS_ACCESS_TOKEN (inizia con EA; incollalo senza la parola Bearer). Inserisci l'ID dell'account pubblicitario in META_ADS_ACCOUNT_ID con il prefisso act_, per esempio act_1234567890. Ads Manager mostra il numero nella barra degli indirizzi (act=1234567890).
5. Installa il connettore ed esegui meta_ads_list_ad_accounts. Elenca tutti gli account pubblicitari raggiungibili dal token, con stato, valuta e fuso orario.

Livello di accesso: una nuova app ha Limited access (prima Standard). Basta per gli account pubblicitari della tua azienda, ma ha limiti di frequenza molto stretti. Gli account pubblicitari di altre aziende richiedono Full access (prima Advanced) tramite App Review. Lascia disattivato Require App Secret (App settings → Advanced): se è attivo, Meta rifiuta le chiamate del connettore.

Prima la conferma: meta_ads_update_status mette in pausa o attiva una campagna, un gruppo di inserzioni o un'inserzione, e meta_ads_update_budget cambia un budget giornaliero o totale. Entrambi agiscono subito e cambiano quanto spendi: attivare avvia la spesa, mettere in pausa ferma la pubblicazione. L'AI indica l'oggetto (nome e ID), il valore attuale e quello nuovo, e aspetta il tuo sì. Un'inserzione viene pubblicata solo se l'inserzione, il suo gruppo di inserzioni e la sua campagna sono tutti ACTIVE. I budget sono numeri interi nell'unità minima della valuta dell'account (2000 vuol dire 20,00 EUR); valute come JPY o KRW non hanno un'unità minore.

Cosa legge: account pubblicitari, campagne, gruppi di inserzioni con il loro targeting, inserzioni con il motivo per cui una non viene pubblicata, creatività, pubblici personalizzati e simili, la cronologia delle modifiche (chi ha cambiato cosa e quando) e le prestazioni. Gli insights danno spesa, copertura, clic e conversioni per l'account o per una singola campagna, gruppo di inserzioni o inserzione, per un periodo predefinito come gli ultimi 7 giorni o il mese scorso o per date qualsiasi fino a 37 mesi indietro, se vuoi giorno per giorno, e suddivisi per età, genere, paese, regione o posizionamento.

Errori comuni: 190: il token non è valido o è scaduto, quindi creane uno nuovo. 10 o da 200 a 299: manca un'autorizzazione (294 vuol dire ads_management) oppure il token non ha accesso a questo account pubblicitario. 100: un parametro è sbagliato; con il subcode 1487534 la richiesta è troppo grande, quindi accorcia il periodo o togli le suddivisioni. 4, 17, 613, 80000 e 80004 sono limiti di frequenza: aspetta qualche minuto.

Il connettore non crea nulla: non crea né modifica campagne, gruppi di inserzioni, inserzioni, creatività o pubblici, non carica media e non gestisce moduli per contatti, pixel o la Conversions API.

Prerequisiti: META_ADS_ACCESS_TOKEN, META_ADS_ACCOUNT_ID

Installazione locale del connettore

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

Apri http://localhost:3000/connectors/store, scegli Meta Ads e inserisci le variabili elencate nei Prerequisiti.

Tool disponibili

Esempi di prompt

• "Quanto abbiamo speso su Facebook e Instagram il mese scorso, e quale campagna ha avuto il costo per acquisto più basso?"
• "Suddividi spesa e clic degli ultimi 30 giorni per età, genere e posizionamento."
• "Quali delle nostre inserzioni non vengono pubblicate in questo momento, e perché?"
• "Aumenta del 20 percento il budget giornaliero della nostra campagna più redditizia, ma prima di cambiarlo mostrami il budget attuale e quello nuovo."

Prossimi passi

• Collegare a Claude
• Collegare a ChatGPT