Meta Ads mit einem Befehl in Claude Code
Claude Code
Meta Ads mit Claude Code verbinden: claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp ausführen, /mcp eingeben, mit PaidSync.ai anmelden.
Claude Code erreicht Ihre Meta-Werbekonten dann über 92 Tools: Leistung nach Placement, Alter, Land und Gerät, Ad Sets, Zielgruppen, Creatives und Kampagnenaufbau. Claude Code fragt vor jedem Tool nach, und die meisten Meta-Schreibvorgänge zeigen zuerst einen Testlauf.
Ein Befehl. OAuth-Login, kein Key. Gratis-Plan mit 100 Aufgaben im Monat, Wert $50, ohne Karte.
Der Befehl
Claude Code spricht über Streamable HTTP mit Remote-MCP-Servern. PaidSync ist einer davon. Fügen Sie ihn einmal hinzu, und dasselbe Terminal, in dem Sie Code bearbeiten, kann Ihre Meta-Werbekonten lesen und ändern.
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpStandardmäßig registriert das den Server nur für das aktuelle Projekt. Fügen Sie --scope user hinzu, damit er in jedem Projekt auf Ihrem Rechner verfügbar ist.
Führen Sie claude mcp list aus, um zu prüfen, dass er da ist, starten Sie dann eine Sitzung und tippen Sie /mcp, um sich anzumelden.
Einrichtung in 5 Schritten
1Bei paidsync.ai/signup registrieren
Dauert 10 Sekunden. Anmeldung mit Google oder E-Mail. Der Free-Plan sind 100 Tasks im Monat für $0, keine Karte.
2Meta Ads im PaidSync-Dashboard verbinden
Klicken Sie bei Meta Ads auf Verbinden und melden Sie sich mit dem Facebook-Konto an, das Ihren Business Manager verwaltet. Meta Ads autorisiert über Facebook OAuth mit den Berechtigungen ads_read und ads_management. PaidSync speichert die Tokens im Ruhezustand verschlüsselt mit AES-256-GCM.
Sie sind schon in Claude Code? Bitten Sie es, connect_facebook_ads auszuführen. Das Tool gibt einen OAuth-Link zurück, den Sie im Browser öffnen.
3Das Werbekonto wählen, mit dem Claude Code arbeiten soll
Nach der Anmeldung listet PaidSync die Meta-Werbekonten auf, die dieses Login erreicht. Haken Sie die an, die in diesen Workspace gehören. In einer Sitzung zeigt list_fb_ad_accounts sie an, und set_fb_ad_account wählt das aktive Konto.
4PaidSync zu Claude Code hinzufügen
Führen Sie in Ihrem Terminal aus:
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpStarten Sie eine Sitzung, tippen Sie /mcp, wählen Sie paidsync und melden Sie sich im sich öffnenden Browserfenster mit Ihrem PaidSync-Login an. Claude Code speichert das OAuth-Token für Sie. Es wird nirgends ein Schlüssel eingefügt.
Richten Sie das für ein Team ein? Committen Sie eine .mcp.json im Repo-Stammverzeichnis, damit jeder Entwickler denselben Connector bekommt:
{
"mcpServers": {
"paidsync": { "type": "http", "url": "https://mcp.paidsync.ai/mcp" }
}
}Lieber einen API-Schlüssel, zum Beispiel für Headless-Läufe? Senden Sie ihn in einem Header, nie in der URL, wo er in Logs landen würde:
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp --header "Authorization: Bearer $PAIDSYNC_API_KEY"Fügen Sie in einer committeten .mcp.json "headers": { "Authorization": "Bearer ${PAIDSYNC_API_KEY}" } hinzu, damit der Schlüssel in der Umgebung jedes Entwicklers bleibt und nie in Git gelangt. Eine Änderung in Google Ads anzuwenden erfordert weiterhin die OAuth-Anmeldung. Auf anderen Plattformen kann ein Schlüssel ebenfalls Änderungen anwenden, behandeln Sie ihn also wie ein Passwort und bevorzugen Sie OAuth.
5Die Verbindung testen
Fragen Sie in einer Claude-Code-Sitzung: “Zeige mir die Meta-Leistung der letzten 7 Tage nach Kampagne”
Claude Code liefert Ausgaben, Impressionen, Klicks, CTR, CPC und ROAS für jede Kampagne im aktiven Werbekonto. Die Verbindung ist live.
Der Free-Plan enthält 100 Tasks im Monat. Pro ab $99 im Monat, Team ab $249.
Meta-Ads-Prompts für Claude Code
Jeder Prompt unten entspricht Tools in der PaidSync-Meta-Ads-Gruppe. Claude Code wählt das Tool. Die letzte Spalte sagt, ob der Aufruf etwas im Werbekonto ändern kann.
| Anfrage | Aufgerufene Tools | Ändert Ihr Konto? |
|---|---|---|
| “Zeige die Kampagnenleistung der letzten 7 Tage mit Ausgaben, CTR, CPC und ROAS” | get_fb_performance | Nein |
| “Welche Platzierungen brachten diesen Monat die günstigsten Conversions?” | get_fb_performance_by_placement | Nein |
| “Ordne jede Anzeige nach CTR der letzten 14 Tage” | get_fb_ad_performance | Nein |
| “Wie steht das Budget-Pacing diesen Monat im aktiven Konto?” | get_fb_budget_pacing | Nein |
| “Pausiere die drei Anzeigengruppen mit den höchsten Kosten pro Ergebnis” | get_fb_adset_performance, pause_fb_adset | Ja, nach Ihrer Bestätigung |
| “Dupliziere die beste Anzeigengruppe samt Anzeigen in die Prospecting-Kampagne” | duplicate_fb_adset | Ja, nach Ihrer Bestätigung |
| “Erstelle eine 1-Prozent-Lookalike der Zielgruppe Purchasers in den USA” | create_fb_lookalike_audience | Ja, nach Ihrer Bestätigung |
| “Entwirf eine Sales-Kampagne mit $50 Tagesbudget und zeige mir die Vorschau” | create_fb_campaign | Ja, nach Ihrer Bestätigung |
Headless ausführen mit claude -p
Das Flag -p führt Claude Code ohne interaktive Sitzung aus. Melden Sie sich einmal über /mcp an, und das gespeicherte OAuth-Token wird übernommen. Ein Bericht, der in einer Datei landet, sieht so aus:
claude -p "Pull last 7 days Meta performance by placement and list the placements with the highest cost per result." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/meta-ads-$(date +%F).jsonLesezugriffe laufen direkt durch, Schreibzugriffe ebenso. --allowedTools "mcp__paidsync" erlaubt jedes PaidSync-Tool, auch die schreibenden, ohne Abfrage.
Erlauben Sie für einen unbeaufsichtigten Job nur die Lese-Tools, die er braucht, jeweils namentlich als mcp__paidsync__tool_name.
Was liest und was schreibt
Von den 92 Meta-Ads-Tools lesen 53 nur, und 36 können schreiben.
Lesen umfasst die Leistung auf Kampagnen-, Anzeigengruppen- und Anzeigenebene, Aufschlüsselungen nach Alter und Geschlecht, Land, Gerät, Platzierung und Zeit, Budget-Pacing, Pixel, Kataloge und das Kontoaktivitätsprotokoll.
Mehr lesen
Schreiben umfasst Kampagnen, Anzeigengruppen, Anzeigen, Creatives, Zielgruppen, Lead-Formulare, automatisierte Regeln und Budgetpläne. Jede Aktion zeigt standardmäßig eine Vorschau mit dry_run, außer upload_fb_ad_image und upload_fb_ad_video, die beim ersten Aufruf angewendet werden.
Über MCP ist die Freigabe die eigene Abfrage von Claude Code. Sie fragt vor dem Ausführen eines Tools nach, außer Sie haben es mit --allowedTools oder in Ihren Einstellungen erlaubt. PaidSync ergänzt Prüfungen auf seiner Seite. Löschen, Pausieren und Budgetänderungen brauchen confirm_destructive, und eine Regelprüfung vor dem Schreiben blockiert unsichere Argumente. Die Freigabekarte und Rückgängig bei einer angewendeten Karte, deren Änderung sich sicher umkehren lässt, gelten nur im PaidSync-Workspace.
Zu ChatGPT hinzufügen: Öffnen Sie PaidSync.ai im Plugin-Verzeichnis von ChatGPT, installieren Sie es und melden Sie sich an.
Zu Claude hinzufügen: Öffnen Sie PaidSync.ai im Connector-Verzeichnis von Claude, klicken Sie auf Verbinden und melden Sie sich an.
Limits im Blick
delete_fb_campaignunddelete_fb_audiencesind endgültig. Pausieren Sie stattdessen, wenn Sie den Verlauf behalten möchten.- Eine duplizierte Anzeigengruppe landet pausiert und standardmäßig ohne ihre Anzeigen. Übergeben Sie
deep_copy, um die Anzeigen mitzukopieren. get_fb_leadsliefert Namen, E-Mail-Adressen und Telefonnummern. Wenn Sie die Ausgabe in eine Datei in einem Repo schreiben, halten Sie diese Datei aus der Versionskontrolle heraus.- Wo das Budget liegt, entscheidet über den Rest. Ein Budget auf der Kampagne heißt, Meta verteilt es auf die Anzeigengruppen. Lassen Sie es weg, trägt jede Anzeigengruppe ihr eigenes.
Häufig gestellte Fragen
Wie verbinde ich Meta Ads mit Claude Code?
Registrieren Sie sich unter paidsync.ai, verbinden Sie Meta Ads per Facebook OAuth im Dashboard und führen Sie dann claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp in Ihrem Terminal aus. Geben Sie in einer Sitzung /mcp ein, wählen Sie paidsync und melden Sie sich mit Ihrem PaidSync-Login an.
Kann Claude Code Meta-Kampagnen erstellen?
Ja. Meta Ads ist in PaidSync eine Plattform der Build-Stufe. Claude Code kann Kampagnen, Anzeigengruppen, Anzeigen und Zielgruppen erstellen. Die meisten Schreibaktionen zeigen zuerst einen Testlauf, und Claude Code fragt vor jedem Tool nach. Bild- und Video-Uploads werden beim ersten Aufruf angewendet.
Welche Meta-Berechtigungen fordert PaidSync an?
PaidSync fordert ads_read und ads_management über Facebook OAuth an. Das deckt Lesen und Schreiben bei Kampagnen, Anzeigengruppen, Anzeigen, Zielgruppen und Leistungsdaten für die verbundenen Werbekonten ab.
Funktioniert es im Headless-Modus mit claude -p?
Ja. Sobald Sie sich über /mcp angemeldet haben, nutzt claude -p das gespeicherte OAuth-Token weiter. Lesezugriffe laufen direkt durch. Schreibzugriffe brauchen Sorgfalt. Niemand ist da, um die Claude-Code-Abfrage zu beantworten, deshalb läuft jedes Schreib-Tool, das Sie mit --allowedTools erlaubt haben, direkt durch. Erlauben Sie für einen unbeaufsichtigten Job nur die Lese-Tools, die er braucht.
Ist es kostenlos?
Ja. Der Free-Plan kostet $0 für 100 Tasks im Monat, ohne Karte. Pro beginnt bei $99 im Monat und Team bei $249 im Monat.
92 Meta-Ads-Tools. Ein Befehl in Claude Code.