Printful MCP mit Microsoft Copilot 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 + Microsoft Copilot

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 Microsoft Copilot 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.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die Printful-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

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

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

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

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