TikTok Ads über MCP mit Meta Muse verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → TikTok Ads klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

TikTok Ads + Meta Muse

Lass deine KI deine TikTok-Anzeigen analysieren: Ausgaben, Impressionen, Klicks und Conversions nach Kampagne, Anzeigengruppe, Anzeige, Tag oder Zielgruppe, dazu Kampagnen, Smart+-Kampagnen, Zielgruppen, Pixel und die Creative-Bibliothek. Sie kann Kampagnen, Anzeigengruppen und Anzeigen pausieren oder aktivieren und Kampagnenbudgets ändern, sobald du diese Tools einschaltest und bestätigst.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

TIKTOK_ADS_API_HOST, TIKTOK_ADS_ACCESS_TOKEN, TIKTOK_ADS_ADVERTISER_ID

Schritt 1 — Zugangsdaten holen

1. Melde dich im Entwicklerportal von TikTok API for Business unter https://business-api.tiktok.com/portal mit einem TikTok-for-Business-Konto an, das Zugriff auf dein Werbekonto hat, und klicke auf Become a Developer.
2. Gib unter My Apps → Create an app einen Namen, eine Beschreibung und eine Advertiser redirect URL ein (irgendeine https-Seite von dir: Du kopierst nur einen Code aus ihrer Adresse) und hake die Berechtigungs-Scopes Ad Account Management, Ads Management, Reporting und Audience Management an, für die entsprechenden Tools außerdem Pixel Management und Creative Management. TikTok prüft neue Apps, meist innerhalb von zwei bis drei Werktagen.
3. Sobald die App freigegeben ist, kopiere ihre App ID und ihr Secret in TIKTOK_ADS_APP_ID und TIKTOK_ADS_APP_SECRET. Beide sind optional: Der Connector nutzt sie nur, um die Werbekonten aufzulisten, die dein Token abdeckt.
4. Öffne die Advertiser authorization URL der App, melde dich an, hake die Werbekonten an und bestätige. Dein Browser landet auf der Redirect-URL mit auth_code=... in der Adresszeile. Der Code funktioniert nur einmal und läuft nach einer Stunde ab.
5. Tausche den Code sofort gegen ein langlebiges Access Token ein. Das musst du nur einmal machen:

   curl -X POST https://business-api.tiktok.com/open_api/v1.3/oauth2/access_token/ -H "Content-Type: application/json" -d '{"app_id":"<App ID>","secret":"<Secret>","auth_code":"<auth_code>"}'
   

   Füge data.access_token aus der Antwort in TIKTOK_ADS_ACCESS_TOKEN ein und eine der data.advertiser_ids in TIKTOK_ADS_ADVERTISER_ID. Das Token läuft nicht ab; es funktioniert nur dann nicht mehr, wenn die Autorisierung widerrufen oder das App-Secret zurückgesetzt wird.
6. Setze TIKTOK_ADS_API_HOST auf https://business-api.tiktok.com, installiere den Connector und führe tiktok_ads_get_advertiser_info aus, um das Konto zu prüfen.

Sandbox: Um ohne echte Ausgaben zu testen, öffne deine App im Entwicklerportal → Sandbox, lege ein Sandbox-Werbekonto an und erzeuge dort sein Token; eine Prüfung ist nicht nötig. Nutze dieses Token und die Sandbox-Advertiser-ID und setze TIKTOK_ADS_API_HOST auf https://sandbox-ads.tiktok.com. Sandbox-Konten spielen keine Anzeigen aus und liefern keine echten Daten.

Ein Werbekonto pro Connector: Jedes Tool arbeitet mit dem Werbekonto aus TIKTOK_ADS_ADVERTISER_ID. Ein Token deckt oft mehrere Konten ab, und tiktok_ads_list_authorized_advertisers listet sie auf. Installiere den Connector für jedes weitere Konto erneut.

Status- und Budgetänderungen sind standardmäßig aus: tiktok_ads_update_campaign_status, tiktok_ads_update_ad_group_status, tiktok_ads_update_ad_status und tiktok_ads_update_campaign_budget sind bei der Installation ausgeschaltet, denn sobald etwas aktiviert wird, fallen sofort Kosten an. Schalte sie einzeln ein, wenn die KI Anzeigen pausieren oder Budgets ändern soll. Sie nennt dann die Kampagne, Anzeigengruppe oder Anzeige, den aktuellen und den neuen Wert und wartet auf dein Ja. Eine Anzeige wird nur ausgespielt, wenn die Anzeige, ihre Anzeigengruppe und ihre Kampagne alle aktiv sind. Budgets sind Beträge in der Kontowährung (50 steht für 50,00), und TikTok lehnt ein Budget unter dem Mindestwert oder unter 105 % des bereits ausgegebenen Betrags ab. Der Connector legt nie Kampagnen oder Anzeigen an.

Berichte: tiktok_ads_get_report liefert Ausgaben, Impressionen, Klicks, Conversions und mehr pro Kampagne, Anzeigengruppe, Anzeige oder für das ganze Konto, pro Tag oder pro Stunde, oder aufgeschlüsselt nach Alter, Geschlecht, Land oder Placement. Tageswerte umfassen bis zu 30 Tage pro Anfrage, deshalb teilt die KI längere Zeiträume auf; Summen ohne zeitliche Aufschlüsselung können bis zu ein Jahr abdecken. Datumsangaben folgen der Zeitzone des Werbekontos, Beträge seiner Währung.

Häufige Fehler: TikTok meldet Fehler als Code in einer ansonsten normalen Antwort, und der Connector macht daraus eine klare Fehlermeldung. 40001: Der App oder dem Token fehlt die Berechtigung für dieses Konto oder diese Aktion, autorisiere das Werbekonto also erneut mit den nötigen Scopes. 40104 oder 40105: Das Token ist ungültig, abgelaufen oder widerrufen oder gehört zu einem anderen Konto; erzeuge ein neues. 40100: zu viele Anfragen, warte kurz. 40300: TikTok kennt die Advertiser-ID nicht.

Der Connector legt keine Kampagnen, Anzeigengruppen, Anzeigen oder Zielgruppen an und bearbeitet sie auch nicht, lädt keine Creatives hoch, verwaltet kein Business Center und deckt TikTok Shop nicht ab.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Muse hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Muse bindet Remote-MCP-Server als Custom Connectors ein und meldet sich per OAuth bei ihnen an.

1. Öffne in Muse Settings → Connectors und wähle Add custom connector.
2. Füge die MCP-Server-URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID ein.
3. Muse öffnet die Anmeldeseite von AnythingMCP: Melde dich an und bestätige den Zugriff.
4. Bitte Muse im Chat um etwas, wofür es die TikTok Ads-Tools braucht.

Du kannst den Connector auch per Chat einrichten, im Web, in den Apps für iOS und Android oder in WhatsApp. Schick Muse diese Nachricht:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Muse verbindet sich aus der Cloud von Meta, localhost funktioniert deshalb nicht.

Verfügbare Tools

Beispiel-Prompts

• „Wie viel haben wir letzte Woche für TikTok ausgegeben, und welche Kampagne hatte die niedrigsten Kosten pro Conversion?“
• „Zeig mir die täglichen Ausgaben, Klicks und Conversions jeder Kampagne der letzten 30 Tage.“
• „Schlüssel die Ergebnisse des letzten Monats nach Alter und Geschlecht auf.“
• „Empfängt unser TikTok Pixel noch Kauf-Events? Vergleiche die letzten 7 Tage mit der Woche davor.“

FAQ

Wo ist Muse verfügbar? Meta bietet Muse derzeit in den USA und in Kanada an, im Web, in den Apps für iOS und Android und in WhatsApp.

Prüft Meta diesen Connector? Nein. Meta prüft Custom Connectors nicht. Muse sieht nur die Tools, die du in AnythingMCP für diesen MCP-Server eingeschaltet hast, und du kannst den Connector jederzeit unter Settings → Connectors trennen.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden