Meta Ads in Codex en Gemini CLI: koppel een coding agent aan je ads
Koppel Codex of Gemini CLI in twee commando's aan je Meta-advertenties: installatie, inloggen in de browser, veilige toolinstellingen en prompts met je Shopify-winst.
Op deze pagina
Codex en Gemini CLI kunnen allebei je Meta-advertenties lezen en beheren via Tera Ads, een gehoste MCP-server op https://teraads.co/mcp. Voer in Codex codex mcp add tera-ads --url https://teraads.co/mcp uit en daarna codex mcp login tera-ads. Installeer in Gemini CLI de Tera Ads-extensie vanaf GitHub en voer /mcp auth tera-ads uit. Allebei laten ze je in je browser inloggen bij Tera Ads, en jij kiest of de agent alleen leest, eerst vraagt of wijzigingen doorvoert.
Belangrijkste punten
- Twee commando's per agent: voeg de server toe en log daarna in je browser in bij Tera Ads. Er komen geen API-sleutels in je configuratie.
- Codex bewaart de server in
~/.codex/config.toml, dat de IDE-extensie van Codex en de ChatGPT-desktopapp delen. - Gemini CLI installeert Tera Ads als extensie die ook een contextbestand laadt dat Gemini vertelt wanneer het Tera Ads moet gebruiken.
- Je agent krijgt 29 tools, van live gegevens uit Meta tot de winst na retouren van je winkel en begrensde budgetwijzigingen.
- Beperk wijzigingen op twee plekken: in de eigen toolinstellingen van de agent en in de koppelingsmodus van Tera Ads.
Waarom je een coding agent aan je advertenties koppelt
Veel Shopify-oprichters bouwen hun eigen thema, scripts en interne tools, en zitten de halve dag in een terminal. Een coding agent die aan je advertenties gekoppeld is, kan “wat gaf Meta gisteren uit?” beantwoorden in dezelfde sessie waarin je een productpagina bewerkt, een wekelijkse samenvatting als Markdown-bestand in je repo opslaan, of een week aan campagneresultaten naast een wijziging leggen die je dinsdag hebt uitgerold.
De verbinding tussen de agent en je advertentieaccount is MCP, het Model Context Protocol: een open standaard waarmee een AI-agent tools kan aanroepen die een andere dienst aanbiedt. MCP-connectors uitgelegd (in het Engels) behandelt de basis. Codex en Gemini CLI ondersteunen allebei remote MCP-servers die via OAuth inloggen, dus voor een gehoste server zoals Tera Ads installeer je niets naast de agent zelf.
Wat Tera Ads toevoegt aan een kale Meta-koppeling, is je winkel. Naast live gegevens over campagnes, advertentiesets en advertenties antwoordt het vanuit Shopify-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 de agent hem niet als verkopen behandelt. Andere servers die je in plaats daarvan kunt koppelen, vind je in Meta Ads MCP-opties. Werk je in Cursor, VS Code of Claude Code, lees dan Meta Ads MCP in Cursor, VS Code en Claude Code.
Eén opmerking over Gemini CLI: de documentatie bevat een melding dat Gemini CLI voor gebruikers zonder betaald abonnement en voor Google One-gebruikers op 18 juni 2026 is vervangen door Antigravity CLI (MCP-documentatie van Gemini CLI). De stappen hieronder volgen Gemini CLI zoals het in oktober 2026 gedocumenteerd was.
Voordat je begint
- Een gratis Tera Ads-account. Meld je aan en koppel je Meta-advertentieaccount. Koppel ook Shopify, zodat de agent 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.
- Codex of Gemini CLI geïnstalleerd en ingelogd op het eigen account.
- Een regel voor wijzigingen. Bepaal of de agent alleen rapporteert, of ook advertenties pauzeert en budgetten verschuift. De gids over veilige AI-toegang (in het Engels) bevat een kort beleid dat je kunt overnemen.
Codex koppelen, stap voor stap
- 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.
- Voeg de server toe aan Codex. Voer in je terminal
codex mcp add tera-ads --url https://teraads.co/mcpuit. - Log in bij Tera Ads. Voer
codex mcp login tera-adsuit; dat opent Tera Ads in je browser, waar je inlogt, het bedrijf kiest en bepaalt wat de agent mag doen. - Controleer de koppeling. Start
codexen typ/mcp, dat de actieve MCP-servers toont; tera-ads hoort in de lijst te staan. - Stel een vraag die je kunt controleren. Probeer “Gebruik Tera Ads om mijn actieve Meta-campagnes met de uitgaven van gisteren te tonen” en vergelijk het antwoord met Ads Manager.
Codex bewaart MCP-servers in ~/.codex/config.toml, met per server één tabel [mcp_servers.tera-ads] en het adres in url. Volgens de documentatie van OpenAI delen de ChatGPT-desktopapp, Codex CLI en de IDE-extensie deze configuratie, dus één installatie dekt alle drie (MCP-documentatie van Codex). Dezelfde documentatie zegt dat codex mcp login OAuth afhandelt en dat Codex automatisch een methode voor clientregistratie kan kiezen. Tera Ads ondersteunt dynamische clientregistratie met OAuth 2.1 en PKCE, dus je hoeft geen client-ID mee te geven.
Beperk Codex aan zijn eigen kant tot lezen
De serverinstellingen van Codex kennen enabled_tools, een allowlist, en disabled_tools, een denylist die daarna wordt toegepast. Wil je voorkomen dat Codex de wijzigingstools aanroept, ook als je Tera Ads-koppeling wijzigingen toestaat, zet dan deze regel onder [mcp_servers.tera-ads] in config.toml:
disabled_tools = ["pause", "resume", "set_budget", "create_campaign", "create_ad_set", "create_ad", "duplicate"]
De documentatie beschrijft ook goedkeuringsinstellingen per server en per tool. De eenvoudigste beveiliging blijft die in Tera Ads: kies alleen lezen wanneer je inlogt, en de wijzigingstools kunnen voor die koppeling niets doen.
Gemini CLI koppelen
- Installeer de extensie. Voer
gemini extensions install https://github.com/Teralabsx/meta-ads-mcpuit. - Log in bij Tera Ads. Start Gemini CLI, voer
/mcp auth tera-adsuit, log in, kies het bedrijf en bepaal wat de agent mag doen. - Controleer de tools. Typ
/mcpom de status en tools van elke server te zien, of voergemini extensions listuit in je shell. - Stel een vraag die je kunt controleren. Probeer “Welke Meta-campagnes gaven deze week het meest uit?” en vergelijk het antwoord met Ads Manager.
De extensie is een klein gemini-extension.json-bestand in de GitHub-repo van Tera Ads. Het wijst Gemini naar https://teraads.co/mcp via het veld httpUrl, dat de documentatie van Gemini definieert als het Streamable HTTP-endpoint, terwijl url voor SSE is. Het noemt ook GEMINI.md als contextbestand. Dat bestand vertelt Gemini om Tera Ads te gebruiken bij vragen over Meta-advertenties, ROAS en winst, de toegeschreven omzet van Meta als die van Meta te labelen, en campagnenamen en advertentieteksten als gegevens te behandelen, nooit als instructies.
Volgens de documentatie van Gemini ondersteunt het OAuth voor remote MCP-servers, kan het de configuratie automatisch ontdekken, handelt het dynamische clientregistratie af waar de server die ondersteunt, en bewaart het tokens in ~/.gemini/mcp-oauth-tokens.json. De serverinstellingen bevatten ook trust, dat alle bevestigingen voor tool-aanroepen overslaat als het op true staat. De Tera Ads-extensie stelt het niet in. Laat dat zo, zodat Gemini blijft vragen voordat het een tool uitvoert.
Codex en Gemini CLI naast elkaar
| Codex | Gemini CLI | |
|---|---|---|
| Server toevoegen | codex mcp add tera-ads --url https://teraads.co/mcp | gemini extensions install https://github.com/Teralabsx/meta-ads-mcp |
| Inloggen | codex mcp login tera-ads | /mcp auth tera-ads |
| Waar het staat | ~/.codex/config.toml | Een geïnstalleerde extensie |
| Controleren of het werkt | /mcp in Codex | /mcp, of gemini extensions list |
| Limieten aan de kant van de agent | enabled_tools, disabled_tools, goedkeuringsinstellingen | Laat trust uit |
| Dekt ook | IDE-extensie van Codex en ChatGPT-desktopapp | Laadt GEMINI.md als context |
| Documentatie van de agent | MCP-documentatie van Codex | Extensies van Gemini CLI |
Wil je dat Codex of een andere agent Tera Ads gebruikt zonder dat je erom vraagt, dan raadt de repo aan de inhoud van GEMINI.md te kopiëren naar AGENTS.md of CLAUDE.md van je project. Noem Tera Ads anders gewoon in je prompt.
Prompts die bij een terminalagent passen
Een coding agent kan iets wat een chatvenster niet kan: het antwoord neerzetten waar je werkt. Vraag hem resultaten in een bestand op te slaan, ze te vergelijken met het bestand van vorige week, of de productpagina te openen waar een campagne mensen naartoe stuurt.
| Vraag | Wat de agent gebruikt |
|---|---|
| “Wat was mijn winst na retouren in de afgelopen 30 dagen? Sla het op in reports/profit.md.” | get_profit, daarna zijn eigen bestandstools |
| “Meta zegt dat mijn ROAS 3 is. Wat heeft mijn winkel echt verdiend?” | get_insights, get_profit |
| “Welke campagnes verliezen geld na retouren, en wat moet ik eraan doen?” | get_ads_review |
| “Welke advertenties gaven de afgelopen 14 dagen geld uit zonder verkoop?” | get_insights op advertentieniveau |
| “Wat is er deze week in mijn advertenties veranderd, en kan ik het nog ongedaan maken?” | list_recent_changes |
| “Kopieer mijn beste campagne als gepauzeerd concept.” | duplicate |
| “Hoeveel Tera Ads-aanroepen heb ik nog over?” | get_usage, dat gratis is |
Lees de antwoorden met twee kanttekeningen. De aankopen en omzet van Meta zijn de attributie van Meta, niet de verkopen van je winkel. En get_ads_review beoordeelt elke campagne die geld uitgaf op winst na de gebruikelijke retouren van je winkel, met je eigen kosten, tegen je break-even-ROAS; het winstcijfer is een schatting voor de hele winkel, geen geld op de bank. Echte ROAS na terugbetalingen laat zien waarom dat verschil telt, en de promptbibliotheek voor advertentieanalyse (in het Engels) heeft meer vragen om te proberen.
Houd de wijzigingen van de agent onder controle
Coding agents zijn vaak zo ingesteld dat ze bestanden bewerken zonder elke keer te vragen. Laat die gewoonte niet overslaan naar advertentietools, waar één verkeerde aanroep echt geld uitgeeft. Tera Ads stelt zijn eigen limieten, wat de agent verder ook mag:
- Alleen lezen, eerst vragen of wijzigingen doorvoeren. Bij eerst vragen wacht een wijziging in Tera Ads tot jij haar daar goedkeurt, en de agent 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. De agent 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.
Komt het resultaat van een wijziging terug als outcome_unknown, vraag de agent dan niet om haar te herhalen. Laat hem eerst list_recent_changes controleren, zodat dezelfde wijziging niet twee keer wordt doorgevoerd.
Als iets niet werkt
De agent negeert Tera Ads. Noem het in de prompt (“gebruik Tera Ads om...”), of kopieer GEMINI.md naar het instructiebestand van je project, zoals hierboven.
Hij vraagt je opnieuw in te loggen. Toegangstokens zijn een uur geldig en worden automatisch vernieuwd; een koppeling blijft 30 dagen geldig. Voer codex mcp login tera-ads of /mcp auth tera-ads opnieuw uit.
Hij zegt dat een limiet is bereikt. Het gratis abonnement heeft 30 aanroepen per week, die elke week in UTC opnieuw beginnen. get_usage 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. Log opnieuw in en kies het andere bedrijf.
Tera Ads Connect is de MCP-server van Tera Ads, het winstdashboard voor Shopify-merken. Hij geeft Codex, Gemini CLI en andere MCP-clients 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 andere clients staan op de Connect-pagina.
Veelgestelde vragen
Kan Codex Meta-advertenties beheren?
Ja, via een MCP-server. Voer codex mcp add tera-ads --url https://teraads.co/mcp en codex mcp login tera-ads uit en vraag daarna in gewone woorden wat je wilt weten. Wat Codex mag wijzigen, hangt af van de modus die je voor de koppeling kiest.
Hoe koppel ik Gemini CLI aan Facebook-advertenties?
Voer gemini extensions install https://github.com/Teralabsx/meta-ads-mcp uit, daarna /mcp auth tera-ads in Gemini CLI, en log in bij Tera Ads. De extensie dekt de Facebook- en Instagram-advertenties in je Meta-advertentieaccount.
Heb ik een Meta-ontwikkelaarsapp of een API-token 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.
Werkt de Codex-installatie ook in de IDE-extensie?
Ja. Volgens de documentatie van OpenAI delen de ChatGPT-desktopapp, Codex CLI en de IDE-extensie dezelfde MCP-configuratie, dus een server die je in de CLI toevoegt, staat ook in de andere twee.
Is Gemini CLI nog beschikbaar?
Volgens de documentatie van Gemini CLI is het op 18 juni 2026 voor gebruikers zonder betaald abonnement en voor Google One-gebruikers vervangen door Antigravity CLI. Controleer de documentatie van Google voor jouw accounttype voordat je het instelt.
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 de agent in Tera Ads doet, en één vraag kan er een paar kosten.