TikTok Shop MCP mit Cursor verbinden

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

TikTok Shop Seller + Cursor

Lass deine KI mit deinem TikTok Shop arbeiten: Bestellungen mit Käufernachrichten und Adressen, Produkte, Bestand, Lager, Versandlabels und Sendungsverfolgung, Retouren und Abrechnungen, dazu Versand-, Produkt-, Bestands- und Preisänderungen auf Wunsch.

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_SHOP_APP_KEY, TIKTOK_SHOP_APP_SECRET, TIKTOK_SHOP_SERVICE_ID

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 15 Minuten, sobald die App existiert. Du brauchst eine eigene App im TikTok Shop Partner Center (App key, App secret und Service ID) und das Seller-Center-Konto des Shop-Inhabers.

Zuerst der Seller-Developer-Zugang: TikTok lässt einen Verkäufer nur dann als Seller Developer registrieren und eine App für den eigenen Shop anlegen, wenn dem Shop ein Account Manager zugewiesen ist. Ohne ihn antwortet das Partner Center mit „This account is not eligible for seller developer registration“. Bitte TikTok Shop in dem Fall über das Help Center im Seller Center um eine Prüfung, ob dein Shop einen Account Manager bekommen kann, oder nutze die App eines Entwicklers, der Seller-Developer-Zugang hat.

1. Melde dich auf partner.tiktokshop.com (US-Shops: partner.us.tiktokshop.com) mit dem Konto des Shop-Inhabers an, öffne App & Service und leg eine Custom App für deinen Shop an. Aktiviere unter Manage API die Scopes, die die Tools brauchen: Shop authorized information, Order information, Product basic und Product write, Fulfillment basic, Logistics basic, Return and refund basic sowie Finance information.
2. Trag als Redirect URL der App deine AnythingMCP-Adresse gefolgt von /api/tiktok-shop/callback ein: https://cloud.anythingmcp.com/api/tiktok-shop/callback bei AnythingMCP Cloud, <SERVER_URL>/api/tiktok-shop/callback (mit deiner eigenen SERVER_URL) bei Self-Hosting.
3. Kopiere den App key der App in TIKTOK_SHOP_APP_KEY, das App secret in TIKTOK_SHOP_APP_SECRET und die Service ID (App & Service → deine App → Basic Information) in TIKTOK_SHOP_SERVICE_ID. Für einen US-Shop setzt du TIKTOK_SHOP_MARKET auf US; für Großbritannien, die EU und alle anderen Märkte bleibt es leer.
4. Installiere den Connector, öffne ihn und klicke auf Authorize with Provider. Bei TikTok Shop wählst du die Region, meldest dich im Seller Center an und gibst die App frei; danach landest du wieder in AnythingMCP, und der Connector ist bereit. Prüfe die Verbindung mit tiktok_shop_get_authorized_shops.

Cloud und Self-Hosting funktionieren gleich: Der Connector nutzt immer deine eigene App. Nur die Redirect URL ist eine andere.

Mehrere Shops: Deckt eine Autorisierung mehrere Shops ab (Cross-Border-Verkäufer), setz TIKTOK_SHOP_SHOP_ID vor dem Autorisieren auf die Shop-ID, den Shop-Code oder den exakten Shop-Namen. Ohne diesen Wert nimmt der Connector den ersten Shop.

Tokens erneuern sich selbst: Das Zugriffstoken gilt 7 Tage und wird automatisch erneuert; das Refresh-Token gilt so lange wie die Autorisierung des Verkäufers und wird verschlüsselt gespeichert. Läuft die Autorisierung ab oder wird sie im Seller Center widerrufen, zeigt der Connector an, dass er eine neue Autorisierung braucht, sein Besitzer bekommt eine E-Mail, und ein Klick auf Authorize with Provider behebt es.

Dein App secret bleibt bei AnythingMCP: Jeder Aufruf wird damit signiert (HMAC-SHA256), das Secret selbst wird nie gesendet. TikTok lehnt einen Zeitstempel ab, der älter als 5 Minuten ist. Geht die Uhr eines selbst gehosteten Servers falsch, gibt es deshalb einen Zeitstempel-Fehler.

Was der Connector liest: Bestellungen mit Positionen, Käufernachricht und Verkäufernotiz, Name und Adresse des Empfängers, Zahlungssummen, Versanddienstleister, Sendungsnummer und Paketen; die Preisaufschlüsselung einer Bestellung; Produkte mit Kategorie, Marke, Bildern, Attributen und jeder SKU mit Preis und Bestand pro Lager; die Kategorien, in denen der Shop verkaufen darf, ihre Attribute und Listing-Regeln sowie Marken; Lager, Versandoptionen und Versanddienstleister; Pakete, Abhol- und Abgabeoptionen, Versandlabels und Lieferscheine zum Drucken und Tracking-Ereignisse; Retouren-, Erstattungs- und Stornoanfragen; Abrechnungen und was für jede Bestellung nach Gebühren und Provision ausgezahlt wurde.

Bei der Installation deaktiviert: tiktok_shop_ship_package, tiktok_shop_mark_package_shipped, tiktok_shop_update_order_shipping_info, tiktok_shop_create_product, tiktok_shop_edit_product, tiktok_shop_partial_edit_product, tiktok_shop_update_inventory, tiktok_shop_update_price, tiktok_shop_activate_products und tiktok_shop_deactivate_products. Sie organisieren Sendungen, schicken Sendungsnummern an Käufer, legen Produkte an und bearbeiten sie, überschreiben den Bestand, setzen Preise und nehmen Produkte in den Verkauf oder heraus: Sie ändern deinen Live-Shop oder das, was Käufer sehen. Schalte auf der Connector-Seite nur die ein, die du brauchst; die KI lässt sich jede Änderung vorher von dir bestätigen. tiktok_shop_upload_product_image ist eingeschaltet: Es speichert nur ein Bild für ein späteres Produkt und ändert kein Angebot.

Kein Geld wird bewegt: Kein Tool erstattet, storniert Bestellungen oder antwortet Käufern. Das bleibt im Seller Center.

IDs, Zeiten und Seiten: IDs sind lange Zahlen, die die KI als Strings übergibt; Zeiten sind Unix-Sekunden; Listen blättern mit page_token.

Häufige Fehler: 106001 heißt, dass die Signatur falsch ist: App key und App secret gehören nicht zur selben App. 105005 heißt, dass der App oder der Autorisierung der Scope für diese API fehlt: Aktiviere ihn unter Manage API und autorisiere neu. 36009033 heißt, dass die App eine IP-Allowlist hat, in der die Adresse von AnythingMCP fehlt. 36009002 oder ein 429 ist das Rate-Limit: Warte eine Minute und versuch es dann erneut.

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

Cursor liest MCP-Server aus ~/.cursor/mcp.json. Füge diesen Eintrag hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte Cursor neu.
3. Öffne Cursor → Settings → MCP und prüfe, ob anythingmcp aufgeführt und verbunden ist.
4. Leg los: Der Agent kann jetzt die TikTok Shop Seller-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Welche Bestellungen warten auf den Versand, und hat ein Käufer eine Nachricht hinterlassen?“
• „Hol mir die Versandlabels und Lieferscheine für die Pakete, die heute angelegt wurden.“
• „Welche Produkte haben in irgendeinem Lager weniger als 10 Stück auf Bestand?“
• „Zeig mir die offenen Retouren- und Erstattungsanfragen mit Grund und Betrag.“
• „Wie viel haben mir die Abrechnungen letzte Woche nach Gebühren und Provision ausgezahlt?“

FAQ

Unterstützt Cursor eigene MCP-Server im kostenlosen Tarif? Ja, MCP gibt es in den Tarifen Hobby, Pro und Business.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden