Meta Ads MCP in Cursor, VS Code und Claude Code: Einrichtung

Du holst Meta Ads in Cursor, VS Code oder Claude Code, indem du eine einzige Remote-MCP-Serveradresse, https://teraads.co/mcp, einträgst und dich im Browser bei Tera Ads anmeldest. Es gibt nichts zu installieren oder zu hosten. Cursor und VS Code brauchen einen kurzen JSON-Eintrag, Claude Code einen Befehl, und danach können alle drei deine Live-Kampagnen und den Gewinn deines Shopify-Shops nach Retouren lesen. Pro Verbindung legst du fest, ob deine KI nur liest, dich erst fragt oder Änderungen vornimmt.

Warum du Meta Ads mit deinem Code-Editor verbindest

Wenn du dein Shopify-Theme, deine Skripte oder internen Tools selbst baust, verbringst du den Tag ohnehin im Editor. Ein KI-Agent dort beantwortet eine Frage zu deinen Anzeigen ohne Umweg über den Ads Manager, schreibt die Antwort in eine Datei in deinem Repo oder prüft, ob die Landingpage, die du gerade geändert hast, die ist, auf die deine besten Anzeigen schicken.

MCP, das Model Context Protocol, ist der offene Standard dahinter: Der Agent im Editor ruft Tools auf, die ein Server bereitstellt, und der Server spricht mit der Werbeplattform. MCP-Connectors erklärt (auf Englisch) zeigt, wie das funktioniert. Cursors Dokumentation nennt stdio, SSE und Streamable HTTP als unterstützte Transportwege und unterstützt OAuth für Server, die es brauchen (Cursors MCP-Dokumentation). Claude Code meldet sich über seinen Befehl /mcp per OAuth bei Remote-Servern an (MCP-Dokumentation von Claude Code). Ein gehosteter Server braucht also keine Schlüssel in einer Konfigurationsdatei.

Tera Ads Connect ist so ein Server, gebaut für Shopify-Marken. Neben Live-Abfragen bei Meta antwortet er aus deinem Shop: Bestellungen, Retouren, Produktkosten, Versand, Gebühren und Erstattungen, abzüglich deiner Ausgaben für Meta und Google Ads. Metas zugeschriebener Umsatz ist als Metas Zahl gekennzeichnet, damit deine KI ihn nicht für Verkäufe hält. Welche anderen Server infrage kommen, vergleicht der Artikel zu den Meta-Ads-MCP-Optionen.

Bevor du startest

• Ein kostenloses Tera-Ads-Konto. Registrier dich und verbinde dein Meta-Werbekonto. Verbinde auch Shopify, damit deine KI Shop-Verkäufe und Gewinn sieht.
• Inhaberzugriff. Nur der Inhaber eines Unternehmens kann in Tera Ads eine KI mit diesem Unternehmen verbinden.
• Dein Editor. Cursor, VS Code mit seiner Chat-Ansicht oder Claude Code im Terminal.
• Eine Entscheidung über Änderungen. Leg fest, ob die KI nur berichtet oder auch Anzeigen pausiert und Budgets ändert. Der Leitfaden für sicheren KI-Zugriff (auf Englisch) enthält eine kurze Richtlinie zum Kopieren.

In fünf Schritten eingerichtet

1. Ein kostenloses Tera-Ads-Konto anlegen. Registrier dich, verbinde dein Meta-Werbekonto und dann Shopify, damit die Antworten den Gewinn deines Shops nach Retouren enthalten.
2. Die Serveradresse im Editor eintragen. Füge https://teraads.co/mcp in die MCP-Einstellungen von Cursor oder VS Code ein oder führ einen Befehl in Claude Code aus; die Abschnitte unten nennen den genauen Eintrag für jeden Editor.
3. Im Browser bei Tera Ads anmelden. Der Editor öffnet Tera Ads, wo du dich anmeldest und das eine Unternehmen wählst, das du freigibst.
4. Festlegen, was deine KI darf. Wähl für diese Verbindung „nur lesen“, „erst fragen“ oder „Änderungen vornehmen“; zwischen den letzten beiden kannst du später unter AI connections in Tera Ads wechseln.
5. Eine überprüfbare Frage stellen. Starte mit etwas wie „Was habe ich gestern für Meta ausgegeben?“ und vergleiche die Antwort mit dem Ads Manager, bevor du dich auf Größeres verlässt.

Die Anmeldung nutzt OAuth 2.1 mit PKCE, und der Server unterstützt Dynamic Client Registration: Dein Editor registriert sich selbst, und du hast nie mit einer Client-ID oder einem Secret zu tun. Tera Ads speichert Tokens nur als Einweg-Hashes. Access-Tokens gelten eine Stunde und werden automatisch erneuert; eine Verbindung hält 30 Tage, dann meldest du dich neu an.

Cursor

Cursor liest MCP-Server aus einer JSON-Datei. Laut Dokumentation macht ~/.cursor/mcp.json in deinem Home-Ordner die Tools überall verfügbar, während .cursor/mcp.json in einem Projekt sie auf dieses Projekt beschränkt (Cursors MCP-Dokumentation). Füge diesen Eintrag hinzu, denselben, den Tera Ads als configs/cursor/mcp.json in seinem GitHub-Repo veröffentlicht:

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

Wenn die Datei schon andere Server enthält, ergänze den Eintrag "tera-ads" im bestehenden mcpServers-Objekt, statt es zu ersetzen. Wenn Cursor fragt, meldest du dich im Browser bei Tera Ads an. Einen API-Schlüssel oder Header musst du nicht eintragen.

Standardmäßig fragt Cursor nach einer Freigabe, bevor es ein MCP-Tool nutzt. Die Dokumentation beschreibt auch eine Allowlist, mit der Tools ohne Nachfrage laufen. Wenn du sie nutzt, setz nur Lese-Tools wie get_insights und get_profit darauf und lass die Änderungs-Tools (pause, resume, set_budget, duplicate und die Create-Tools) hinter einer Nachfrage.

VS Code

VS Code bietet dir zwei Wege:

• MCP: Add Server. Öffne die Command Palette, führ MCP: Add Server aus, wähl HTTP, füge https://teraads.co/mcp ein und gib dem Server die ID tera-ads.
• Eine Workspace-Datei. Übernimm den Eintrag aus configs/vscode/mcp.json im Repo in .vscode/mcp.json: {"servers": {"tera-ads": {"type": "http", "url": "https://teraads.co/mcp"}}}. VS Code nutzt servers, wo Cursor mcpServers nutzt, kopier also nicht die Datei des einen Editors in den anderen.

Die MCP-Dokumentation von VS Code lenkt neue Einrichtungen inzwischen über den geführten Ablauf und sagt, dass .vscode/mcp.json-Dateien im Workspace aus Kompatibilitätsgründen weiter verfügbar bleiben; beide Wege funktionieren also. Starte den Server, melde dich bei Tera Ads an, wenn VS Code fragt, und schalte Tera Ads dann unter Configure Tools im Chat-Eingabefeld ein. VS Codes Dokumentation rät, nur Aktionen freizugeben, die du verstehst, und das ist die richtige Gewohnheit für jede Anfrage, die ein Budget berührt.

Claude Code

Ein Befehl fügt den Server hinzu:

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

Starte Claude Code, tippe /mcp, wähle tera-ads und melde dich im Browser bei Tera Ads an. Laut Dokumentation von Claude Code führt /mcp die OAuth-Anmeldung aus, und Tokens werden automatisch gespeichert und erneuert; claude mcp list zeigt, ob jeder Server verbunden ist oder eine Authentifizierung braucht.

Standardmäßig wird der Server im Scope local hinzugefügt: nur für dich, nur im aktuellen Projekt. Mit --scope user hast du ihn in all deinen Projekten, mit --scope project landet er in einer .mcp.json-Datei, die du über die Versionskontrolle teilst. Eine geteilte Datei teilt nur die Adresse. Jede Person meldet sich einzeln an, und nur der Inhaber kann eine KI mit einem Tera-Ads-Unternehmen verbinden.

Das Plugin mit sechs Skills

Wenn du den Server zusammen mit fertigen Abläufen willst, installiere Tera Ads stattdessen als Plugin. Führ claude plugin marketplace add Teralabsx/meta-ads-mcp aus und danach claude plugin install tera-ads@tera-ads. Die Plugin-Dokumentation von Claude Code sagt, dass ein Plugin seine Skills, Agents, Hooks und MCP-Server hinzufügt und dass seine Skills in der Form /<plugin>:<skill> erscheinen; der erste unten heißt also /tera-ads:profit-check.

Dieselbe Dokumentation sagt, dass Plugins aus Marktplätzen von Drittanbietern standardmäßig nicht automatisch aktualisiert werden. Für eine neue Version führst du claude plugin update tera-ads@tera-ads aus.

Die drei Editoren im Vergleich

Was du zuerst fragst

Starte mit Fragen, deren Antworten du im Ads Manager in einer Minute prüfen kannst. Sobald die Zahlen stimmen, geh zu den Fragen über, die die Daten deines Shops brauchen. Die Prompt-Sammlung für die Anzeigenanalyse und die Fragen, die du einer KI zu deinen Anzeigen stellen kannst (beide auf Englisch), liefern mehr davon.

Beim Lesen der Antworten gilt zweierlei. Erstens: Metas Käufe und Umsatz sind Metas Attribution, nicht die Verkäufe deines Shops; warum Meta Ads und Shopify sich uneinig sind (auf Englisch) erklärt die Lücke. Zweitens: get_ads_review beurteilt jede Kampagne, die Geld ausgegeben hat, nach dem Gewinn nach den üblichen Retouren deines Shops, mit deinen eigenen Kosten, gemessen an deinem Break-even-ROAS. Der Gewinn selbst ist eine Schätzung für den ganzen Shop, berechnet aus deinen Bestellungen mit deiner Margeneinstellung, kein Geld auf dem Konto.

Änderungen an deinen Anzeigen unter Kontrolle halten

Änderungen werden an zwei Stellen kontrolliert: in deinem Editor, der vor jedem Tool-Aufruf fragen kann, und in Tera Ads, das festlegt, was die Verbindung überhaupt darf.

• Nur lesen, erst fragen oder Änderungen vornehmen. Mit „erst fragen“ wartet eine Änderung in Tera Ads, bis du sie dort freigibst, und deine KI kann sie nicht für dich freigeben.
• Neues startet pausiert. Kampagnen, Anzeigengruppen, Anzeigen und Kopien geben nichts aus, bis etwas sie einschaltet.
• Budgetschritte sind begrenzt. Eine einzelne Änderung kann ein Budget höchstens verdreifachen oder auf ein Zehntel kürzen.
• Eine Tagesgrenze. Assistenten können pro Unternehmen höchstens 50 Änderungen am Tag vornehmen.
• Kein Lösch-Tool. Deine KI kann pausieren, aber nichts löschen.
• 7 Tage rückgängig machen. Eine Pausierung, ein Einschalten oder eine Budgetänderung lässt sich in Tera Ads 7 Tage lang rückgängig machen. Neue Kampagnen, Anzeigengruppen und Anzeigen lassen sich nicht rückgängig machen, starten aber pausiert.
• Ein Unternehmen pro Verbindung. Eine Verbindung kann kein anderes Unternehmen lesen, auch keines, das dir ebenfalls gehört.

Kampagnennamen und Anzeigentexte erreichen deine KI als Daten, und Tera Ads weist sie an, darin enthaltene Anweisungen nicht zu befolgen. Die Dokumentation von Claude Code sagt das auch allgemein: Server, die fremde Inhalte abrufen, können dich Prompt-Injection aussetzen, also verbinde nur Server, denen du vertraust. Wenn du jede Änderung sehen willst, bevor sie passiert, wähle „erst fragen“.

Wenn etwas nicht funktioniert

Der Server verlangt eine Anmeldung. Führ in Claude Code /mcp aus und wähle tera-ads; bis dahin zeigt claude mcp list, dass eine Authentifizierung nötig ist. In Cursor und VS Code startest du den Server neu und schließt die Anmeldung im Browser ab.

Die Tools erscheinen nicht im Chat von VS Code. Öffne Configure Tools im Chat-Eingabefeld und schalte Tera Ads ein.

Deine KI meldet ein erreichtes Limit. Der kostenlose Plan hat 30 Aufrufe pro Woche, wöchentlich nach UTC zurückgesetzt. Bitte deine KI, get_usage auszuführen; das ist kostenlos und zeigt, wie viele Aufrufe übrig sind und wann der Zähler zurückgesetzt wird.

Budgets wirken hundertmal zu groß. list_campaigns zeigt Budgets in Metas Einheiten, bei den meisten Währungen in Hundertsteln, also bedeutet 5000 $50. set_budget nimmt ganze Einheiten deiner Kontowährung.

Die Antworten betreffen den falschen Shop. Jede Verbindung deckt ein Unternehmen ab. Verbinde dich neu und wähle das andere Unternehmen.

Tera Ads Connect ist der MCP-Server von Tera Ads, dem Gewinn-Dashboard für Shopify-Marken. Er gibt deinem Editor Live-Abfragen bei Meta, Shopify-Verkäufe und den Gewinn nach Retouren sowie begrenzte, protokollierte Änderungen an Anzeigen. Der kostenlose Plan umfasst 30 Aufrufe pro Woche auf einem Meta-Werbekonto, und Connect Pro kostet $15 im Monat für 3.000 Aufrufe im Monat auf bis zu drei Werbekonten; in den Plänen Growth und Scale ist es enthalten. Die Einrichtung für jeden Client steht auf der Connect-Seite. Arbeitest du mit Terminal-Agents, deckt der Leitfaden zu Meta Ads in Codex und Gemini CLI diese beiden ab; für Chat-Assistenten siehe Facebook Ads mit ChatGPT verbinden und Claude für Meta Ads.

Häufige Fragen

Funktioniert Meta Ads MCP in Cursor?

Ja. Cursor unterstützt Remote-MCP-Server mit OAuth-Anmeldung. Trag den Tera-Ads-Eintrag in ~/.cursor/mcp.json oder .cursor/mcp.json ein und melde dich bei Tera Ads an, wenn Cursor fragt.

Wie füge ich Meta Ads MCP zu VS Code hinzu?

Führ MCP: Add Server aus, wähle HTTP und füge https://teraads.co/mcp ein, oder trag den Eintrag in .vscode/mcp.json ein. Starte den Server, melde dich an und schalte Tera Ads im Chat unter Configure Tools ein.

Wie lautet der Claude-Code-Befehl für Meta Ads MCP?

claude mcp add --transport http tera-ads https://teraads.co/mcp. Tippe danach /mcp in Claude Code und melde dich an. Für sechs fertige Skills für Anzeigen installierst du das Plugin mit claude plugin marketplace add Teralabsx/meta-ads-mcp und claude plugin install tera-ads@tera-ads.

Brauche ich einen API-Schlüssel oder eine Meta-Entwickler-App?

Nein. Du meldest dich im Browser bei Tera Ads an, und Änderungen erreichen Meta über die eigene, freigegebene Meta-App von Tera Ads. Nichts Geheimes landet in deiner Konfigurationsdatei.

Kann die KI in meinem Editor meine Anzeigen ändern?

Nur, wenn du es für diese Verbindung erlaubst. Selbst dann startet Neues pausiert, eine einzelne Budgetänderung kann höchstens verdreifachen oder auf ein Zehntel kürzen, und eine Pausierung, ein Einschalten oder eine Budgetänderung lässt sich in Tera Ads 7 Tage lang rückgängig machen.

Was kostet das?

Der kostenlose Plan umfasst 30 Aufrufe pro Woche auf einem Meta-Werbekonto. Connect Pro kostet $15 im Monat für 3.000 Aufrufe im Monat. Ein Aufruf ist eine Abfrage, die deine KI in Tera Ads macht, und eine einzelne Frage kann mehrere brauchen.