Printful über MCP mit ChatGPT verbinden

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

Printful + ChatGPT

Lass deine KI mit Printful arbeiten: den Print-on-Demand-Katalog durchsuchen, Produktionspreise und Versandtarife prüfen, Bestellkosten schätzen, Bestellentwürfe anlegen und bis zur Zustellung verfolgen und deine Store-Produkte nachschlagen, auch aus Shopify, Etsy und WooCommerce. Mit einem privaten Printful-Token.

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:

PRINTFUL_API_TOKEN

Schritt 1 — Zugangsdaten holen

1. Melde dich unter developers.printful.com mit deinem Printful-Login an und öffne Your tokens (developers.printful.com/tokens).
2. Erstelle einen privaten Token und wähle die Zugriffsebene. Ein Store-Token erreicht einen einzigen Store, den du jetzt auswählst, und die Store-Tools brauchen keine store_id. Ein Account-Token erreicht alle Stores des Kontos; die KI gibt den Store-Tools dann eine store_id aus printful_list_stores mit (sie wird als Header X-PF-Store-Id gesendet).
3. Wähle die Scopes: orders, um Bestellungen zu lesen und zu schreiben (oder orders/read für ein Nur-lesen-Setup), und sync_products/read für die Store-Produkte. printful_list_stores braucht außerdem den Stores-Scope (stores_list), wo das Formular ihn anbietet. Katalog, Preise und Versandtarife brauchen keinen Scope.
4. Setze ein Ablaufdatum, erstelle den Token und kopiere ihn sofort: Printful zeigt ihn nur ein einziges Mal an. Trage ihn allein, ohne Bearer davor, in PRINTFUL_API_TOKEN ein und installiere dann den Connector.
5. Starte mit printful_get_token_scopes, um zu sehen, was der Token darf, und dann mit printful_list_stores für deine Stores und ihre IDs.

Ablauf des Tokens: Ein privater Token gilt bis zu dem Ablaufdatum, das du gewählt hast, und lässt sich nicht erneuern. Erstelle vor diesem Datum einen neuen und trage ihn in PRINTFUL_API_TOKEN ein. Einen Schritt Authorize with Provider gibt es nicht.

Ohne Store geht es nicht: Versandtarife, Kostenschätzungen und Bestellungen gehören immer zu einem Store. Ein Konto ohne Store antwortet mit This endpoint requires store_id. Lege dann zuerst im Printful-Dashboard einen an (Stores → Add store → Manual order platform / API).

Entwürfe sind kostenlos, erst die Bestätigung kostet Geld: printful_create_draft_order legt einen Entwurf an, den Printful weder in die Produktion gibt noch berechnet. Du kannst ihn im Dashboard unter Orders prüfen und bearbeiten. Vorher zeigt printful_calculate_shipping_rates die Versandoptionen und printful_estimate_order_costs die vollen Kosten (Artikel, Drucke, Versand, Steuern, MwSt.), ohne etwas anzulegen. Eine Position ist entweder eine Katalogvariante mit Druckdatei-URLs, die Printful herunterladen kann, oder die Variante eines Produkts, das in deinem Store schon eingerichtet ist und seine eigenen Dateien mitbringt. Gib einer Bestellung deine eigene external_id, dann findet jedes Bestell-Tool sie als @ plus diese ID, zum Beispiel @SHOP-1001. Bestellungen aus einem verknüpften Shopify-, Etsy- oder WooCommerce-Store kommen von selbst bei Printful an, die KI legt sie also nicht noch einmal an.

Bei der Installation ausgeschaltet: printful_confirm_order, das einen Entwurf zur Ausführung übergibt. Printful belastet dann das Zahlungsmittel des Stores und startet die Produktion, und die Bestellung lässt sich nur noch stornieren, solange sie im Status pending ist. Schalte es nur ein, wenn die KI Bestellungen in die Produktion geben soll; sonst bestätigst du Entwürfe selbst im Dashboard. Ist es eingeschaltet, zeigt die KI vorher Bestellung, Positionen, Adresse und Gesamtbetrag und wartet auf dein Ja.

Zwei Arten von Store-Produkten: Für Manual-order-/API-Stores nutzt die KI printful_list_store_products und printful_get_store_product; für Stores, die mit Shopify, WooCommerce, Etsy oder anderen Plattformen verknüpft sind, printful_list_sync_products und printful_get_sync_product. Diese zeigen, welche Plattform-Varianten mit einem Printful-Produkt synchronisiert sind. Welche Art ein Store ist, steht im Feld type von printful_list_stores.

Berechtigungen und Nur lesen: Der Token erreicht nur seine Scopes und, auf Store-Ebene, nur seinen Store. Für ein Nur-lesen-Setup erstellst du den Token mit orders/read statt orders, deaktivierst printful_create_draft_order auf der Connector-Seite und lässt printful_confirm_order ausgeschaltet.

Rate-Limits: Printful erlaubt 120 Anfragen pro Minute und Store. Darüber antwortet Printful mit 429 und einem Header Retry-After und verarbeitet die Anfrage nicht: Warte eine Minute und versuche es erneut.

Häufige Fehler: 401 bedeutet, dass der Token falsch, abgelaufen oder gelöscht ist: Erstelle unter Your tokens einen neuen. 403 bedeutet, dass dem Token der Scope für den Aufruf fehlt oder ein Account-Token ohne store_id benutzt wurde. 400 nennt das ungültige Feld, zum Beispiel einen fehlenden state_code (Pflicht für die USA, Kanada und Australien), eine unbekannte Variante oder eine Datei-URL, die Printful nicht herunterladen kann. 404 bedeutet eine unbekannte ID: Die echten IDs liefern die Listen-Tools.

Der Connector storniert, ändert und löscht keine Bestellungen, legt keine Store-Produkte an und bearbeitet sie nicht, lädt keine Dateien in die Dateibibliothek hoch und verwaltet keine Webhooks.

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

ChatGPT verbindet MCP-Server als eigene Apps im Entwicklermodus (Developer mode). Den gibt es in den kostenpflichtigen Tarifen, nicht im kostenlosen. In Business- und Enterprise-Workspaces muss ihn eventuell erst ein Admin freigeben.

1. Öffne in ChatGPT Settings → Security and login und aktiviere Developer mode.
2. Geh zu chatgpt.com/plugins und klicke auf +.
3. Gib einen Namen und eine kurze Beschreibung ein, z. B. Name: Printful.
4. Trag unter Connection die MCP-Server-URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID ein und erstelle die Verbindung.
5. Wenn ChatGPT danach fragt, meldest du dich bei AnythingMCP an (OAuth) und erlaubst den Zugriff.

Verfügbare Tools

Beispiel-Prompts

• „Was kostet die Produktion eines schwarzen Unisex-T-Shirts in Größe M mit Frontdruck, und welche Versandoptionen gibt es nach München?“
• „Welche meiner Bestellungen sind angehalten oder fehlgeschlagen, und wie lauten die Tracking-Links der bereits versendeten Bestellungen?“
• „Leg einen Bestellentwurf für Anna Schmidt, Hauptstraße 5, 10115 Berlin an: 2 Stück unseres Logo Hoodie in Größe L mit Standardversand, und zeig mir die Gesamtkosten, bevor irgendetwas bestätigt wird.“
• „Welche Produkte in meinem Shopify-Store sind noch mit keinem Printful-Produkt synchronisiert?“

FAQ

Funktioniert der kostenlose ChatGPT-Tarif mit eigenen MCP-Connectors? Nein. Eigene MCP-Verbindungen brauchen den Entwicklermodus, und den gibt es nur in kostenpflichtigen Tarifen.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden