Meta Ads MCP in Cursor, VS Code en Claude Code: installatiegids

Je zet Meta Ads in Cursor, VS Code of Claude Code door één remote MCP-serveradres toe te voegen, https://teraads.co/mcp, en in je browser in te loggen bij Tera Ads. Er valt niets te installeren of te hosten. Cursor en VS Code krijgen een korte JSON-vermelding, Claude Code één commando, en daarna lezen alle drie je live campagnes en de winst na retouren van je Shopify-winkel. Per koppeling kies je of je AI alleen leest, eerst vraagt of wijzigingen doorvoert.

Waarom je Meta Ads aan je code-editor koppelt

Bouw je je Shopify-thema, scripts of interne tools zelf, dan zit je de hele dag al in je editor. Een AI-agent daar kan een advertentievraag beantwoorden zonder omweg via Ads Manager, het antwoord in een bestand in je repo schrijven, of controleren of de landingspagina die je net hebt aangepast de pagina is waar je beste advertenties mensen naartoe sturen.

MCP, het Model Context Protocol, is de open standaard die dit mogelijk maakt: de agent in je editor roept tools aan die een server aanbiedt, en de server praat met het advertentieplatform. MCP-connectors uitgelegd (in het Engels) laat zien hoe dat werkt. De documentatie van Cursor noemt stdio, SSE en Streamable HTTP als ondersteunde transports en zegt dat Cursor OAuth ondersteunt voor servers die dat nodig hebben (MCP-documentatie van Cursor). Claude Code logt via OAuth in bij remote servers met het commando /mcp (MCP-documentatie van Claude Code). Een gehoste server heeft dus geen sleutels nodig die je in een configuratiebestand plakt.

Tera Ads Connect is zo'n server, gebouwd voor Shopify-merken. Naast live gegevens uit Meta antwoordt hij vanuit je winkel: bestellingen, retouren, productkosten, verzending, transactiekosten en terugbetalingen, min je advertentie-uitgaven aan Meta en Google. De toegeschreven omzet van Meta staat gelabeld als die van Meta, zodat je AI hem niet voor verkopen aanziet. Wil je het bredere overzicht van servers die je in plaats daarvan kunt gebruiken, dan vergelijkt Meta Ads MCP-opties ze. Werk je liever in de terminal met Codex of Gemini CLI, lees dan Meta Ads in Codex en Gemini CLI.

Voordat je begint

• Een gratis Tera Ads-account. Meld je aan en koppel je Meta-advertentieaccount. Koppel ook Shopify, zodat je AI de verkopen en winst van je winkel kan zien.
• Toegang als eigenaar. Alleen de eigenaar van het bedrijf kan in Tera Ads een AI aan een bedrijf koppelen.
• Je editor. Cursor, VS Code met de chatweergave, of Claude Code in de terminal.
• Een besluit over wijzigingen. Bepaal of de AI alleen rapporteert, of ook advertenties pauzeert en budgetten wijzigt. De gids over veilige AI-toegang (in het Engels) bevat een kort beleid dat je kunt overnemen.

In vijf stappen ingesteld

1. Maak een gratis Tera Ads-account aan. Meld je aan, koppel je Meta-advertentieaccount en daarna Shopify, zodat de antwoorden de winst na retouren van je winkel bevatten.
2. Voeg het serveradres toe aan je editor. Plak https://teraads.co/mcp in de MCP-instellingen van Cursor of VS Code, of voer één commando uit in Claude Code; de secties hieronder geven per editor de exacte vermelding.
3. Log in je browser in bij Tera Ads. De editor opent Tera Ads, waar je inlogt en het ene bedrijf kiest dat je deelt.
4. Kies wat je AI mag doen. Kies voor deze koppeling alleen lezen, eerst vragen (ask me first) of wijzigingen doorvoeren; tussen de laatste twee wissel je later onder AI connections in Tera Ads.
5. Stel een vraag die je kunt controleren. Begin met iets als “Wat heb ik gisteren aan Meta uitgegeven?” en vergelijk het antwoord met Ads Manager voordat je op iets groters vertrouwt.

Inloggen gaat via OAuth 2.1 met PKCE, en de server ondersteunt dynamische clientregistratie, dus je editor registreert zichzelf en je krijgt nooit met een client-ID of secret te maken. Tera Ads bewaart tokens alleen als eenrichtingshashes. Toegangstokens zijn een uur geldig en worden automatisch vernieuwd; een koppeling blijft 30 dagen geldig voordat je opnieuw inlogt.

Cursor

Cursor leest MCP-servers uit een JSON-bestand. Volgens de documentatie maakt ~/.cursor/mcp.json in je thuismap de tools overal beschikbaar, en houdt .cursor/mcp.json in een project ze binnen dat project (MCP-documentatie van Cursor). Voeg deze vermelding toe, dezelfde die Tera Ads als configs/cursor/mcp.json publiceert in zijn GitHub-repo:

{"mcpServers": {"tera-ads": {"url": "https://teraads.co/mcp"}}}

Staan er al andere servers in het bestand, zet de vermelding "tera-ads" dan in het bestaande mcpServers-object in plaats van dat te vervangen. Log in je browser in bij Tera Ads wanneer Cursor erom vraagt. Je hoeft geen API-sleutel of header toe te voegen.

Standaard vraagt Cursor om goedkeuring voordat het een MCP-tool gebruikt. De documentatie beschrijft ook hoe je tools op een allowlist zet, zodat ze zonder vragen draaien. Gebruik je dat, zet dan alleen leestools zoals get_insights en get_profit op de lijst, en houd de wijzigingstools (pause, resume, set_budget, duplicate en de create-tools) achter een bevestiging.

VS Code

VS Code geeft je twee routes:

• MCP: Add Server. Open het Command Palette, voer MCP: Add Server uit, kies HTTP, plak https://teraads.co/mcp en geef de server de ID tera-ads.
• Een workspacebestand. Zet de vermelding uit configs/vscode/mcp.json in de repo in .vscode/mcp.json: {"servers": {"tera-ads": {"type": "http", "url": "https://teraads.co/mcp"}}}. VS Code gebruikt servers waar Cursor mcpServers gebruikt, dus kopieer het bestand van de ene editor niet naar de andere.

De MCP-documentatie van VS Code stuurt nieuwe installaties nu via de begeleide flow en zegt dat .vscode/mcp.json-bestanden in de workspace beschikbaar blijven voor compatibiliteit, dus beide routes werken. Start de server, log in bij Tera Ads wanneer VS Code erom vraagt en zet Tera Ads daarna aan onder Configure Tools in het invoerveld van de chat. De documentatie van VS Code raadt aan alleen acties goed te keuren die je begrijpt, en dat is de juiste gewoonte voor elk verzoek dat aan een budget raakt.

Claude Code

Eén commando voegt de server toe:

claude mcp add --transport http tera-ads https://teraads.co/mcp

Start Claude Code, typ /mcp, kies tera-ads en log in je browser in bij Tera Ads. Volgens de documentatie van Claude Code voert /mcp de OAuth-login uit en worden tokens automatisch opgeslagen en vernieuwd; claude mcp list laat zien of elke server verbonden is of authenticatie nodig heeft.

De server wordt standaard toegevoegd op local scope: alleen voor jou, alleen in het huidige project. Voeg --scope user toe om hem in al je projecten te hebben, of --scope project om hem in een .mcp.json-bestand te schrijven dat je via versiebeheer deelt. Een gedeeld bestand deelt alleen het adres. Iedereen logt afzonderlijk in, en alleen de eigenaar van het bedrijf kan een AI aan een Tera Ads-bedrijf koppelen.

De plug-in, met zes skills

Wil je de server samen met kant-en-klare workflows toevoegen, installeer Tera Ads dan als plug-in. Voer claude plugin marketplace add Teralabsx/meta-ads-mcp uit en daarna claude plugin install tera-ads@tera-ads. De plug-indocumentatie van Claude Code zegt dat een plug-in zijn skills, agents, hooks en MCP-servers toevoegt, en dat de skills verschijnen in de vorm /<plugin>:<skill>, dus de eerste hieronder is /tera-ads:profit-check.

Volgens dezelfde documentatie worden plug-ins uit marketplaces van derden standaard niet automatisch bijgewerkt. Voer claude plugin update tera-ads@tera-ads uit om een nieuwe versie op te halen.

De drie editors naast elkaar

Wat je eerst vraagt

Begin met vragen waarvan je het antwoord binnen een minuut in Ads Manager kunt controleren. Kloppen de cijfers, ga dan over op vragen die de gegevens van je winkel nodig hebben. De promptbibliotheek voor advertentieanalyse en vragen om aan AI te stellen over je advertenties (allebei in het Engels) hebben er meer.

Twee dingen om te onthouden als je de antwoorden leest. Ten eerste zijn de aankopen en omzet van Meta de attributie van Meta, niet de verkopen van je winkel; waarom Meta Ads en Shopify het oneens zijn (in het Engels) verklaart het verschil. Ten tweede beoordeelt get_ads_review elke campagne die geld uitgaf op winst na de gebruikelijke retouren van je winkel, met je eigen kosten, tegen je break-even-ROAS. De winst zelf is een schatting voor de hele winkel, opgebouwd uit je bestellingen met je marge-instelling, geen geld op de bank.

Houd advertentiewijzigingen in eigen hand

Wijzigingen worden op twee plekken bewaakt: in je editor, die voor elke tool om bevestiging kan vragen, en in Tera Ads, dat bepaalt wat de koppeling überhaupt mag.

• Alleen lezen, eerst vragen of wijzigingen doorvoeren. Bij eerst vragen wacht een wijziging in Tera Ads tot jij haar daar goedkeurt, en je AI kan haar niet voor je goedkeuren.
• Nieuwe dingen starten gepauzeerd. Campagnes, advertentiesets, advertenties en kopieën geven niets uit tot iets ze aanzet.
• Budgetstappen zijn begrensd. Eén wijziging kan een budget hooguit verdrievoudigen of tot een tiende verlagen.
• Een daglimiet. Assistenten kunnen per bedrijf hooguit 50 wijzigingen per dag doorvoeren.
• Geen tool om te verwijderen. Je AI kan pauzeren, maar niets verwijderen.
• 7 dagen ongedaan maken. Een pauze, het aanzetten of een budgetwijziging kun je 7 dagen lang ongedaan maken in Tera Ads. Nieuwe campagnes, advertentiesets en advertenties kun je niet ongedaan maken, maar ze starten gepauzeerd.
• Eén bedrijf per koppeling. Een koppeling kan geen ander bedrijf lezen, ook niet een dat jij ook bezit.

Campagnenamen en advertentieteksten komen als gegevens bij je AI binnen, en Tera Ads vertelt hem geen instructies daarin op te volgen. De documentatie van Claude Code maakt hetzelfde algemene punt: servers die externe inhoud ophalen, kunnen je blootstellen aan prompt injection, dus koppel alleen servers die je vertrouwt. Wil je elke wijziging zien voordat ze gebeurt, kies dan eerst vragen.

Als iets niet werkt

De server zegt dat je moet inloggen. Voer in Claude Code /mcp uit en kies tera-ads; claude mcp list laat zien dat hij authenticatie nodig heeft tot je dat doet. Herstart in Cursor en VS Code de server en rond het inloggen in de browser af.

De tools verschijnen niet in de chat van VS Code. Open Configure Tools in het invoerveld van de chat en zet Tera Ads aan.

Je AI zegt dat een limiet is bereikt. Het gratis abonnement heeft 30 aanroepen per week, die elke week in UTC opnieuw beginnen. Vraag je AI om get_usage uit te voeren; dat is gratis en laat zien hoeveel aanroepen er over zijn en wanneer de teller opnieuw begint.

Budgetten lijken honderd keer te groot. list_campaigns toont budgetten in de eenheden van Meta, voor de meeste valuta honderdsten, dus 5000 betekent $50. set_budget gebruikt hele eenheden van de valuta van je account.

De antwoorden gaan over de verkeerde winkel. Elke koppeling dekt één bedrijf. Koppel opnieuw en kies het andere bedrijf.

Tera Ads Connect is de MCP-server van Tera Ads, het winstdashboard voor Shopify-merken. Hij geeft je editor live gegevens uit Meta, Shopify-verkopen en winst na retouren, en beperkte, vastgelegde advertentiewijzigingen. Het gratis abonnement omvat 30 aanroepen per week op één Meta-advertentieaccount, en Connect Pro kost $15 per maand voor 3.000 aanroepen per maand op maximaal drie advertentieaccounts; het zit inbegrepen bij de abonnementen Growth en Scale. De installatiestappen voor elke client staan op de Connect-pagina.

Veelgestelde vragen

Werkt Meta Ads MCP in Cursor?

Ja. Cursor ondersteunt remote MCP-servers met inloggen via OAuth. Voeg de Tera Ads-vermelding toe aan ~/.cursor/mcp.json of .cursor/mcp.json en log in bij Tera Ads wanneer Cursor erom vraagt.

Hoe voeg ik Meta Ads MCP toe aan VS Code?

Voer MCP: Add Server uit, kies HTTP en plak https://teraads.co/mcp, of zet de vermelding in .vscode/mcp.json. Start de server, log in en zet Tera Ads daarna aan onder Configure Tools in de chat.

Wat is het Claude Code-commando voor Meta Ads MCP?

claude mcp add --transport http tera-ads https://teraads.co/mcp. Typ daarna /mcp in Claude Code en log in. Voor zes kant-en-klare advertentieskills installeer je de plug-in met claude plugin marketplace add Teralabsx/meta-ads-mcp en claude plugin install tera-ads@tera-ads.

Heb ik een API-sleutel of een Meta-ontwikkelaarsapp nodig?

Nee. Je logt in je browser in bij Tera Ads, en wijzigingen bereiken Meta via de eigen goedgekeurde Meta-app van Tera Ads. Er komt niets geheims in je configuratiebestand.

Kan de AI in mijn editor mijn advertenties wijzigen?

Alleen als je dat voor die koppeling toestaat. Ook dan starten nieuwe dingen gepauzeerd, kan één budgetwijziging een budget hooguit verdrievoudigen of tot een tiende verlagen, en kun je een pauze, het aanzetten of een budgetwijziging 7 dagen lang ongedaan maken in Tera Ads.

Wat kost het?

Het gratis abonnement omvat 30 aanroepen per week op één Meta-advertentieaccount. Connect Pro kost $15 per maand voor 3.000 aanroepen per maand. Een aanroep is één opzoeking die je AI in Tera Ads doet, en één vraag kan er een paar kosten.