TikTok Ads mit einem Befehl in Claude Code
Claude Code
TikTok 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 TikTok-Werbekonten über 24 Tools: Leistung je Werbetreibendem, Kampagne, Anzeigengruppe und Anzeige, dazu Pausieren, Aktivieren, Budget- und Gebotsänderungen bei bestehenden Kampagnen. Claude Code fragt vor jedem Tool nach.
Manage-Stufe. Claude Code arbeitet an Kampagnen, die Sie bereits betreiben. Es erstellt keine neuen TikTok-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 TikTok-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.
2TikTok Ads im PaidSync-Dashboard verbinden
Klicken Sie bei TikTok Ads auf Verbinden und melden Sie sich mit dem TikTok-Konto an, das Zugriff auf Ihre Werbekonten hat. TikTok Ads autorisiert per TikTok OAuth. PaidSync speichert die Tokens im Ruhezustand verschlüsselt mit AES-256-GCM.
Schon in Claude Code? Bitten Sie es, connect_tiktok_ads auszuführen. Das Tool liefert einen OAuth-Link, den Sie in Ihrem Browser öffnen.
3Werbetreibenden wählen, an dem Claude Code arbeiten soll
In einer Sitzung zeigt list_tiktok_advertisers jedes Werbekonto, das Ihre TikTok-Anmeldung erreichen kann, und set_active_tiktok_advertiser wählt das, an dem Claude Code arbeitet. TikTok-Schreibzugriffe brauchen zuerst einen aktiven Werbetreibenden.
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 TikTok-Ausgaben und Conversions pro Kampagne der letzten 7 Tage”
Claude Code liefert Impressionen, Klicks, CTR, CPC, CPM, Ausgaben und Conversions 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.
TikTok-Ads-Prompts in Claude Code
Jeder Prompt unten entspricht Tools der PaidSync-Gruppe TikTok 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 TikTok-Werbekonten auf und mache Acme zum aktiven” | list_tiktok_advertisers, set_active_tiktok_advertiser | Nein |
| “Zeige Ausgaben, CTR und Conversions pro Kampagne der letzten 7 Tage” | get_tiktok_performance | Nein |
| “Gehe für die Top-Kampagne auf Anzeigenebene” | get_tiktok_performance, list_tiktok_ads | Nein |
| “Liste die Anzeigengruppen dieser Kampagne mit Status und Budget auf” | list_tiktok_adgroups | Nein |
| “Pausiere die Kampagne mit den schlechtesten Kosten pro Conversion” | pause_tiktok_campaign | Ja, nach Ihrer Bestätigung |
| “Erhöhe das Budget der Kampagne Spring Sale auf $150” | update_tiktok_campaign_budget | Ja, nach Ihrer Bestätigung |
| “Senke das Gebot dieser Anzeigengruppe auf $0.80” | update_tiktok_adgroup | 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 TikTok performance at ad level and list the ads with the highest spend and no conversions." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/tiktok-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 24 TikTok-Ads-Tools lesen 11 nur und 11 können schreiben. Lesen umfasst Werbetreibende, Kampagnen, Anzeigengruppen, Anzeigen und Leistung.
Mehr lesen
Schreiben umfasst das Pausieren und Aktivieren von Kampagnen, Kampagnenbudgets, Kampagnennamen sowie Status, Budget, Gebot und Name von Anzeigengruppen.
Änderungen an Anzeigengruppen sowie Budget- und Namensänderungen von Kampagnen zeigen standardmäßig mit dry_run eine Vorschau. Das Pausieren oder Aktivieren einer Kampagne hat keinen Testlauf und braucht eine ausdrückliche Bestätigung.
Ü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 TikTok nicht kann
- PaidSync erstellt keine TikTok-Kampagnen, Anzeigengruppen oder Anzeigen. Erstellen Sie sie im TikTok Ads Manager und verwalten Sie sie dann in Claude Code.
- Es gibt in PaidSync keine Tools für Zielgruppen oder Creative-Uploads bei TikTok.
update_tiktok_campaignändert nur den Namen. Der Status läuft überpause_tiktok_campaignundenable_tiktok_campaign, das Budget überupdate_tiktok_campaign_budget.- Eine Gebotsänderung bei einer Anzeigengruppe greift nur, wenn die Anzeigengruppe einen individuellen Gebotstyp nutzt.
- Das TikTok-Reporting hinkt etwa ein bis zwei Stunden hinterher, daher zeigt eine Prüfung um 9 Uhr Daten bis ungefähr 7 oder 8 Uhr.
Häufig gestellte Fragen
Wie verbinde ich TikTok Ads mit Claude Code?
Registrieren Sie sich auf paidsync.ai, verbinden Sie TikTok Ads per TikTok 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 TikTok-Kampagnen erstellen?
Ja. PaidSync erstellt TikTok-Kampagnen, Anzeigengruppen und Videoanzeigen, alle pausiert. Claude Code kann außerdem über bestehende Kampagnen berichten, sie pausieren und aktivieren und Budgets sowie Gebote von Anzeigengruppen ändern.
Kann Claude Code TikTok-Budgets ändern?
Ja. update_tiktok_campaign_budget ändert ein Kampagnenbudget und update_tiktok_adgroup das Budget einer Anzeigengruppe. 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.
TikTok-Berichte und Kampagnen. Ein Befehl in Claude Code.