Startseite>Verbinden>X Ads mit Claude Code

X Ads mit einem Befehl in Claude Code

Von Ahmed Ashraf|Aktualisiert am 24. Oktober 2026

X 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 dann Ihre X-Werbekonten über 14 Tools: Leistung pro Konto, Kampagne oder Line Item sowie Pausieren, Aktivieren, Budget- und Gebotsänderungen an bestehenden Kampagnen. Claude Code fragt nach, bevor es jedes Tool ausführt.

Manage-Stufe. Claude Code arbeitet an Kampagnen, die Sie bereits betreiben. Es erstellt keine neuen X-Kampagnen.

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 über Ihre X-Kampagnen berichten und sie verwalten.

claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp

Standardmäß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

1

Bei paidsync.ai/signup registrieren

Dauert 10 Sekunden. Anmeldung per Google oder E-Mail. Der Gratis-Tarif umfasst 100 Aufgaben im Monat im Wert von $50, für $0, keine Karte.

2

X Ads im PaidSync-Dashboard verbinden

Klicken Sie bei X Ads auf Verbinden und melden Sie sich mit dem X-Konto an, das Ihre Werbekonten öffnen kann, und autorisieren Sie dann PaidSync. X Ads autorisiert per X OAuth, und PaidSync sieht Ihr X-Passwort nie.

Schon in Claude Code? Bitten Sie es, connect_x_ads auszuführen. Das Tool liefert einen Link, den Sie in Ihrem Browser öffnen.

3

Das Werbekonto wählen, mit dem Claude Code arbeiten soll

In einer Sitzung zeigt list_x_accounts jedes Werbekonto, das Ihre X-Anmeldung erreichen kann, und set_active_x_account wählt das, an dem Claude Code arbeitet.

4

PaidSync zu Claude Code hinzufügen

Führen Sie in Ihrem Terminal aus:

claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp

Starten 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.

5

Die Verbindung testen

Fragen Sie in einer Claude-Code-Sitzung: “Zeige mir X-Ausgaben, Impressionen und Klicks pro Kampagne der letzten 7 Tage”

Claude Code liefert Ausgaben, Impressionen, Klicks und Engagements für jede Kampagne. Die Verbindung ist live.

Der Free-Plan enthält 100 Tasks im Monat. Pro ab $99 im Monat, Team ab $249.

X-Ads-Prompts in Claude Code

Jeder Prompt unten entspricht Tools der PaidSync-Gruppe X Ads. Claude Code wählt das Tool. Die letzte Spalte sagt, ob der Aufruf etwas im Werbekonto ändern kann.

AnfrageAufgerufene ToolsÄndert Ihr Konto?
“Liste meine X-Werbekonten auf und mache Acme zum aktiven”list_x_accounts, set_active_x_accountNein
“Zeige meine Kampagnen der letzten 7 Tage mit Ausgaben, Impressionen, Klicks und Engagements”get_x_performanceNein
“Welche Line Items haben in den letzten 30 Tagen am meisten ausgegeben”get_x_performanceNein
“Liste die Line Items dieser Kampagne auf”list_x_line_itemsNein
“Pausiere die Kampagne Spring Launch”list_x_campaigns, pause_x_campaignJa, nach Ihrer Bestätigung
“Setze das Tagesbudget der Kampagne Retargeting auf 80”update_x_campaign_budgetJa, nach Ihrer Bestätigung
“Senke das Gebot des Line Items Lookalikes auf 1.50”list_x_line_items, update_x_line_itemJa, 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 30 days X performance at line item level and list the line items with the highest spend and no clicks." \ --allowedTools "mcp__paidsync" \ --output-format json > reports/x-ads-$(date +%F).json

Lesezugriffe 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 14 X-Ads-Tools lesen 7 nur und 5 können schreiben. Lesen umfasst Werbekonten, Kampagnen, Line Items, Promoted Posts und Leistung.

Mehr lesen

Schreiben umfasst das Pausieren und Aktivieren von Kampagnen, Tagesbudgets von Kampagnen, Status und Gebote von Line Items sowie Namen von Kampagnen und Line Items.

Änderungen an Budget, Gebot, Name und Status über die Update-Tools zeigen standardmäßig mit dry_run eine Vorschau, und PaidSync liest jede Änderung danach aus X zurück.

Ü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.

Was Claude Code auf X nicht kann

  • PaidSync erstellt keine X-Kampagnen, Line Items oder Promoted Posts. Erstellen Sie sie im X Ads Manager und verwalten Sie sie dann in Claude Code.
  • Es gibt keine Tools für Creative-Uploads.
  • PaidSync hat kein X-Tool für Targeting, Tailored Audiences oder Conversion-Reporting.
  • Line Items werden über update_x_line_item pausiert und aktiviert, Kampagnen über pause_x_campaign und enable_x_campaign.
  • Beträge stehen in der eigenen Währung und Zeitzone des Werbekontos.

Häufig gestellte Fragen

Wie verbinde ich X Ads mit Claude Code?

Registrieren Sie sich auf paidsync.ai, verbinden Sie X Ads per OAuth im Dashboard und führen Sie dann in Ihrem Terminal claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp aus. Geben Sie /mcp in einer Sitzung ein, wählen Sie paidsync und melden Sie sich mit Ihrem PaidSync-Login an.

Kann Claude Code X-Kampagnen erstellen?

Nein. X Ads ist in PaidSync eine Plattform der Manage-Stufe. Claude Code kann über bestehende Kampagnen berichten, sie pausieren und aktivieren sowie Budgets und Gebote von Line Items ändern. Neue Kampagnen werden im X Ads Manager erstellt.

Kann Claude Code X-Ads-Budgets ändern?

Ja. update_x_campaign_budget ändert das Tagesbudget einer Kampagne und update_x_line_item das Gebot eines Line Items. Beide zeigen zuerst einen Testlauf als Vorschau, und Claude Code fragt nach, bevor es jedes Tool ausführt.

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.

X-Ads-Berichte und Kampagnen. Ein Befehl in Claude Code.