X Ads mit einem Befehl in Claude Code
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/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 per Google oder E-Mail. Der Gratis-Tarif umfasst 100 Aufgaben im Monat im Wert von $50, für $0, keine Karte.
2X 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.
3Das 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.
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 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.
| Anfrage | Aufgerufene Tools | Ändert Ihr Konto? |
|---|---|---|
| “Liste meine X-Werbekonten auf und mache Acme zum aktiven” | list_x_accounts, set_active_x_account | Nein |
| “Zeige meine Kampagnen der letzten 7 Tage mit Ausgaben, Impressionen, Klicks und Engagements” | get_x_performance | Nein |
| “Welche Line Items haben in den letzten 30 Tagen am meisten ausgegeben” | get_x_performance | Nein |
| “Liste die Line Items dieser Kampagne auf” | list_x_line_items | Nein |
| “Pausiere die Kampagne Spring Launch” | list_x_campaigns, pause_x_campaign | Ja, nach Ihrer Bestätigung |
| “Setze das Tagesbudget der Kampagne Retargeting auf 80” | update_x_campaign_budget | Ja, nach Ihrer Bestätigung |
| “Senke das Gebot des Line Items Lookalikes auf 1.50” | list_x_line_items, update_x_line_item | 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 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).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 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_itempausiert und aktiviert, Kampagnen überpause_x_campaignundenable_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.
Claude Code