MCP di Meta Ads in Cursor, VS Code e Claude Code: come configurarlo
Collega Meta Ads a Cursor, VS Code o Claude Code con un solo indirizzo MCP: la configurazione esatta per ogni editor, l'accesso e come controllare le modifiche.
In questa pagina
Puoi portare Meta Ads in Cursor, VS Code o Claude Code aggiungendo un solo indirizzo di server MCP remoto, https://teraads.co/mcp, e accedendo a Tera Ads dal browser. Non devi installare né ospitare nulla. Cursor e VS Code vogliono una breve voce JSON, Claude Code un solo comando; poi tutti e tre leggono le tue campagne in tempo reale e il profitto del tuo negozio Shopify al netto dei resi. Per ogni connessione scegli se la tua IA legge soltanto, ti chiede prima o fa modifiche.
Punti chiave
- Un solo indirizzo funziona in tutti e tre gli editor:
https://teraads.co/mcp, un server MCP ospitato con accesso dal browser e nessuna chiave API nella configurazione. - Cursor legge
~/.cursor/mcp.jsonper tutti i progetti o.cursor/mcp.jsonper uno solo; VS Code usa MCP: Add Server o.vscode/mcp.json. - Claude Code richiede un comando
claude mcp add, oppure un plugin che aggiunge il server e sei skill pronte per le inserzioni. - La tua IA ottiene 29 strumenti: letture in tempo reale da Meta, il profitto del negozio al netto dei resi, e pause, riattivazioni e modifiche al budget entro limiti fissi.
- Decidi cosa può fare l'IA prima di collegarla: sola lettura, chiedimi prima o fai modifiche.
Perché collegare Meta Ads al tuo editor di codice
Se il tema Shopify, gli script o gli strumenti interni li costruisci tu, l'editor è già il posto dove passi la giornata. Un agente IA lì dentro può rispondere a una domanda sulle inserzioni senza passare da Ads Manager, scrivere la risposta in un file del tuo repository o verificare se la landing page che hai appena modificato è quella verso cui le tue inserzioni migliori mandano le persone.
MCP, il Model Context Protocol, è lo standard aperto che lo rende possibile: l'agente dell'editor richiama strumenti esposti da un server, e il server parla con la piattaforma pubblicitaria. La guida ai connettori MCP (in inglese) spiega come funziona. La documentazione di Cursor elenca stdio, SSE e Streamable HTTP tra i trasporti supportati e dice che supporta OAuth per i server che lo richiedono (documentazione MCP di Cursor). Claude Code accede ai server remoti con OAuth tramite il comando /mcp (documentazione MCP di Claude Code). Quindi un server ospitato non richiede chiavi incollate in un file di configurazione.
Tera Ads Connect è un server di questo tipo, pensato per i brand Shopify. Oltre alle letture in tempo reale da Meta, risponde partendo dal tuo negozio: ordini, resi, costo del prodotto, spedizione, commissioni e rimborsi, meno la spesa pubblicitaria su Meta e Google. Il fatturato attribuito da Meta è etichettato come di Meta, così la tua IA non lo scambia per vendite. Se vuoi il quadro completo dei server che potresti usare al suo posto, le opzioni MCP per Meta Ads li mettono a confronto.
Prima di iniziare
- Un account Tera Ads gratuito. Registrati e collega il tuo account pubblicitario Meta. Collega anche Shopify, così la tua IA vede vendite e profitto del negozio.
- Accesso da titolare. Solo il titolare dell'attività può collegare un'IA a un'attività in Tera Ads.
- Il tuo editor. Cursor, VS Code con la sua vista chat, oppure Claude Code nel terminale.
- Una decisione sulle modifiche. Decidi se l'IA si limiterà ai report o metterà anche in pausa inserzioni e cambierà budget. La guida all'accesso sicuro dell'IA (in inglese) contiene una breve policy che puoi copiare.
Configuralo in cinque passaggi
- Crea un account Tera Ads gratuito. Registrati, collega il tuo account pubblicitario Meta e poi Shopify, così le risposte includono il profitto del negozio al netto dei resi.
- Aggiungi l'indirizzo del server al tuo editor. Incolla
https://teraads.co/mcpnelle impostazioni MCP di Cursor o VS Code, oppure esegui un comando in Claude Code; le sezioni qui sotto riportano la voce esatta per ciascuno. - Accedi a Tera Ads dal browser. L'editor apre Tera Ads, dove accedi e scegli l'unica attività da condividere.
- Scegli cosa può fare la tua IA. Per questa connessione scegli sola lettura, chiedimi prima o fai modifiche; in seguito puoi passare da una all'altra delle ultime due in AI connections, dentro Tera Ads.
- Fai una domanda che puoi verificare. Parti da qualcosa come "Quanto ho speso su Meta ieri?" e confronta la risposta con Ads Manager prima di affidarti all'IA per qualcosa di più grosso.
L'accesso usa OAuth 2.1 con PKCE, e il server supporta la registrazione dinamica dei client, quindi l'editor si registra da solo e non devi mai gestire un client ID o un secret. Tera Ads conserva i token solo come hash unidirezionali. I token di accesso durano un'ora e vengono rinnovati in automatico; una connessione dura 30 giorni, poi accedi di nuovo.
Cursor
Cursor legge i server MCP da un file JSON. La sua documentazione dice che ~/.cursor/mcp.json nella tua cartella home rende gli strumenti disponibili ovunque, mentre .cursor/mcp.json dentro un progetto li limita a quel progetto (documentazione MCP di Cursor). Aggiungi questa voce, la stessa che Tera Ads pubblica come configs/cursor/mcp.json nel suo repository GitHub:
{"mcpServers": {"tera-ads": {"url": "https://teraads.co/mcp"}}}
Se il file elenca già altri server, aggiungi la voce "tera-ads" dentro l'oggetto mcpServers esistente invece di sostituirlo. Quando Cursor te lo chiede, accedi a Tera Ads dal browser. Non c'è nessuna chiave API né header da aggiungere.
Per impostazione predefinita, Cursor chiede l'approvazione prima di usare uno strumento MCP. La sua documentazione descrive anche come mettere degli strumenti in una allowlist perché girino senza chiedere. Se usi questa opzione, metti in allowlist solo strumenti di lettura come get_insights e get_profit, e lascia gli strumenti di modifica (pause, resume, set_budget, duplicate e quelli di creazione) dietro una conferma.
VS Code
VS Code ti offre due strade:
- MCP: Add Server. Apri la Command Palette, esegui MCP: Add Server, scegli HTTP, incolla
https://teraads.co/mcpe dai al server l'IDtera-ads. - Un file del workspace. Aggiungi a
.vscode/mcp.jsonla voce diconfigs/vscode/mcp.jsondel repository:{"servers": {"tera-ads": {"type": "http", "url": "https://teraads.co/mcp"}}}. VS Code usaserversdove Cursor usamcpServers, quindi non copiare il file di un editor nell'altro.
La documentazione MCP di VS Code ora indirizza le nuove configurazioni verso la procedura guidata e dice che i file .vscode/mcp.json del workspace restano disponibili per compatibilità, quindi funzionano entrambe le strade. Avvia il server, accedi a Tera Ads quando VS Code te lo chiede, poi attiva Tera Ads in Configure Tools, nel campo di input della chat. La documentazione di VS Code consiglia di approvare solo le azioni che capisci: è l'abitudine giusta per ogni richiesta che tocca un budget.
Claude Code
Un solo comando aggiunge il server:
claude mcp add --transport http tera-ads https://teraads.co/mcp
Avvia Claude Code, scrivi /mcp, scegli tera-ads e accedi a Tera Ads dal browser. La documentazione di Claude Code dice che /mcp esegue il login OAuth e che i token vengono salvati e rinnovati in automatico; claude mcp list mostra se ogni server è connesso o richiede l'autenticazione.
Per impostazione predefinita il server viene aggiunto con scope locale: solo per te, solo nel progetto corrente. Aggiungi --scope user per averlo in tutti i tuoi progetti, oppure --scope project per scriverlo in un file .mcp.json condiviso tramite il controllo di versione. Un file condiviso condivide solo l'indirizzo. Ognuno accede per conto suo, e solo il titolare dell'attività può collegare un'IA a un'attività Tera Ads.
Il plugin, con sei skill
Per aggiungere il server insieme a flussi di lavoro pronti, installa invece Tera Ads come plugin. Esegui claude plugin marketplace add Teralabsx/meta-ads-mcp, poi claude plugin install tera-ads@tera-ads. La documentazione sui plugin di Claude Code dice che un plugin aggiunge le sue skill, i suoi agenti, hook e server MCP, e che le sue skill compaiono nella forma /<plugin>:<skill>, quindi la prima della tabella è /tera-ads:profit-check.
| Skill | Cosa fa |
|---|---|
profit-check | Mette i numeri di Meta accanto al profitto del tuo negozio al netto dei resi |
weekly-ads-review | Confronta questa settimana con la precedente e suggerisce modifiche, senza farne nessuna |
pause-wasted-spend | Trova le inserzioni che spendono senza vendite e mette in pausa quelle che scegli |
scale-a-winner | Alza il budget di una vincente a passi sicuri, oppure la copia come bozza in pausa |
launch-paused-campaign | Crea un'intera campagna, con gruppo di inserzioni e inserzione, tutto in pausa, da controllare |
refresh-ad-copy | Scrive nuove versioni di un'inserzione stanca, come inserzioni in pausa accanto a lei |
La stessa documentazione dice che i plugin dei marketplace di terze parti non si aggiornano automaticamente per impostazione predefinita. Per avere una nuova versione, esegui claude plugin update tera-ads@tera-ads.
I tre editor a confronto
| Cursor | VS Code | Claude Code | |
|---|---|---|---|
| Dove va l'impostazione | ~/.cursor/mcp.json o .cursor/mcp.json | MCP: Add Server, o .vscode/mcp.json | claude mcp add, con scope local, user o project |
| Formato della voce | mcpServers con un url | servers con "type": "http" e un url | Un comando, nessun file da modificare |
| Accesso | Dal browser, quando Cursor lo chiede | Dal browser, dopo aver avviato il server | /mcp, poi il browser |
| Prima del primo uso | Nient'altro | Attivarlo in Configure Tools | Nient'altro |
| Extra | Nessuno | Nessuno | Plugin con sei skill |
| Documentazione dell'editor | Cursor | VS Code | Claude Code |
Cosa chiedere per primo
Parti da domande le cui risposte puoi verificare in Ads Manager in un minuto. Quando i numeri tornano, passa a quelle che richiedono i dati del negozio. La raccolta di prompt per l'analisi delle inserzioni e le domande da fare all'IA sulle tue inserzioni (entrambe in inglese) ne contengono altre.
| Domanda | Cosa consulta la tua IA |
|---|---|
| "Quali campagne hanno speso di più questa settimana, e cosa hanno portato?" | get_insights |
| "Qual è stato il mio profitto al netto dei resi negli ultimi 30 giorni?" | get_profit |
| "Meta dice che il mio ROAS è 3. Quanto ha guadagnato davvero il mio negozio?" | get_insights, get_profit |
| "Quali campagne perdono soldi dopo i resi, e cosa dovrei farne?" | get_ads_review |
| "Quali inserzioni hanno speso negli ultimi 14 giorni senza una vendita?" | get_insights a livello di inserzione |
| "Cosa è cambiato nelle mie inserzioni questa settimana, e posso ancora annullarlo?" | list_recent_changes |
Due cose da tenere a mente quando leggi le risposte. Primo, acquisti e fatturato di Meta sono l'attribuzione di Meta, non le vendite del tuo negozio; perché Meta Ads e Shopify non coincidono (in inglese) spiega la differenza. Secondo, get_ads_review giudica ogni campagna che ha speso in base al profitto dopo i resi abituali del tuo negozio, con i tuoi costi, rispetto al tuo ROAS di pareggio. Il profitto in sé è una stima per l'intero negozio, costruita dai tuoi ordini con la tua impostazione di margine, non denaro in banca.
Tieni sotto controllo le modifiche alle inserzioni
Le modifiche si controllano in due punti: il tuo editor, che può chiedere prima di eseguire ogni strumento, e Tera Ads, che decide cosa può fare la connessione in primo luogo.
- Sola lettura, chiedimi prima o fai modifiche. Con chiedimi prima, una modifica aspetta in Tera Ads finché non la approvi lì, e la tua IA non può approvarla al posto tuo.
- Le novità partono in pausa. Campagne, gruppi di inserzioni, inserzioni e copie non spendono nulla finché qualcosa non le attiva.
- I passi di budget hanno un tetto. Una singola modifica può al massimo triplicare un budget o ridurlo a un decimo.
- Un tetto giornaliero. Gli assistenti possono fare al massimo 50 modifiche al giorno su un'attività.
- Nessuno strumento per eliminare. La tua IA può mettere in pausa, ma non può eliminare nulla.
- Annullamento per 7 giorni. Una pausa, una riattivazione o una modifica al budget si può annullare in Tera Ads per 7 giorni. Nuove campagne, gruppi di inserzioni e inserzioni non si possono annullare, ma partono in pausa.
- Un'attività per connessione. Una connessione non può leggere un'altra attività, nemmeno una che possiedi.
I nomi delle campagne e i testi delle inserzioni arrivano alla tua IA come dati, e Tera Ads le dice di non seguire le istruzioni che contengono. Anche la documentazione di Claude Code lo dice in generale: i server che recuperano contenuti esterni possono esporti alla prompt injection, quindi collega solo server di cui ti fidi. Se vuoi vedere ogni modifica prima che avvenga, scegli chiedimi prima.
Quando qualcosa non funziona
Il server dice che serve l'accesso. In Claude Code, esegui /mcp e scegli tera-ads; claude mcp list mostra che richiede l'autenticazione finché non lo fai. In Cursor e VS Code, riavvia il server e completa l'accesso nel browser.
Gli strumenti non compaiono nella chat di VS Code. Apri Configure Tools nel campo di input della chat e attiva Tera Ads.
La tua IA dice che è stato raggiunto un limite. Il piano gratuito ha 30 chiamate a settimana, con il conteggio azzerato ogni settimana in UTC. Chiedi alla tua IA di eseguire get_usage, che è gratuito e dice quante chiamate restano e quando si azzera il conteggio.
I budget sembrano cento volte più grandi. list_campaigns mostra i budget nelle unità di Meta, che per la maggior parte delle valute sono centesimi, quindi 5000 significa $50. set_budget usa unità intere della valuta del tuo account.
Le risposte riguardano il negozio sbagliato. Ogni connessione copre un'attività. Collegati di nuovo e scegli l'altra attività.
Tera Ads Connect è il server MCP di Tera Ads, la dashboard del profitto per i brand Shopify. Dà al tuo editor letture in tempo reale da Meta, vendite Shopify e profitto al netto dei resi, più modifiche alle inserzioni limitate e registrate. Il piano gratuito include 30 chiamate a settimana su un account pubblicitario Meta, e Connect Pro costa $15 al mese per 3.000 chiamate al mese su un massimo di tre account pubblicitari; è incluso nei piani Growth e Scale. I passaggi di configurazione per ogni client sono nella pagina di Connect. Se lavori con agenti da terminale, la guida a Meta Ads in Codex e Gemini CLI copre questi due; per gli assistenti in chat, vedi come collegare Facebook Ads a ChatGPT e come usare Claude con Meta Ads.
Domande frequenti
Si può usare un MCP di Meta Ads in Cursor?
Sì. Cursor supporta i server MCP remoti con accesso OAuth. Aggiungi la voce di Tera Ads a ~/.cursor/mcp.json o .cursor/mcp.json, poi accedi a Tera Ads quando Cursor te lo chiede.
Come aggiungo un MCP di Meta Ads a VS Code?
Esegui MCP: Add Server, scegli HTTP e incolla https://teraads.co/mcp, oppure aggiungi la voce a .vscode/mcp.json. Avvia il server, accedi, poi attiva Tera Ads in Configure Tools nella chat.
Qual è il comando di Claude Code per un MCP di Meta Ads?
claude mcp add --transport http tera-ads https://teraads.co/mcp. Poi scrivi /mcp in Claude Code e accedi. Per avere sei skill pronte per le inserzioni, installa il plugin con claude plugin marketplace add Teralabsx/meta-ads-mcp e claude plugin install tera-ads@tera-ads.
Mi servono una chiave API o un'app sviluppatore di Meta?
No. Accedi a Tera Ads dal browser, e le modifiche arrivano a Meta tramite l'app Meta approvata di Tera Ads. Nel file di configurazione non finisce niente di segreto.
L'IA del mio editor può modificare le mie inserzioni?
Solo se lo permetti per quella connessione. Anche allora le novità partono in pausa, una singola modifica al budget può al massimo triplicarlo o ridurlo a un decimo, e una pausa, una riattivazione o una modifica al budget si può annullare in Tera Ads per 7 giorni.
Quanto costa?
Il piano gratuito include 30 chiamate a settimana su un account pubblicitario Meta. Connect Pro costa $15 al mese per 3.000 chiamate al mese. Una chiamata è una consultazione che la tua IA fa in Tera Ads, e una domanda può richiederne diverse.