# Stickerei-MCP-Server für KI-Agenten Kanonische Seite: https://embroideryfileconverter.com/de/ai-agents Verbinden Sie KI-Agenten mit authentifizierten Stickwerkzeugen über einen Remote-MCP-Server mit OAuth, Format-Erkennung, Nutzungsstatus und privaten Verarbeitungsaufträgen. ## Richtige Integration auswählen - Verwenden Sie diesen Remote-MCP-Server, wenn ein KI-Assistent im Namen eines Benutzers über browserbestätigtes OAuth handeln soll. - Verwenden Sie die [REST-Entwickler-API](https://embroideryfileconverter.com/de/developers) für ein herkömmliches Backend, SaaS-Produkt oder serverseitige Automatisierung. ## MCP-Client verbinden - Streambarer HTTP-Endpunkt: `https://embroideryfileconverter.com/mcp/embroidery` - OAuth-Bereich: `mcp:use` - Standard-MCP-Ratenlimit: 60 Anfragen pro Minute - Dateierstellungs-Tool-Limit: 6 Anfragen pro Minute pro Benutzer, plus Netzlimit - Zugriffstoken-Lebensdauer: 60 Minuten - Refresh-Token-Lebensdauer: 30 Tage Der Endpunkt funktioniert mit Remote-Streamable-HTTP-Clients. Bevorzugen Sie natives Browser-OAuth; fügen Sie niemals Passwörter, Refresh-Tokens oder langlebige Bearer-Tokens in ein Repository ein. ## ChatGPT (OpenAI) verbinden Vollständige MCP-Apps werden im ChatGPT-Entwicklermodus konfiguriert. Verfügbarkeit und Schreib-Tool-Steuerungen variieren je nach Plan. 1. Aktivieren Sie in ChatGPT Web den Entwicklermodus unter Einstellungen > Apps > Erweiterte Einstellungen oder öffnen Sie Arbeitsbereichseinstellungen > Apps > Erstellen. 2. Erstellen Sie eine App und legen Sie die MCP-Server-URL auf `https://embroideryfileconverter.com/mcp/embroidery` fest. 3. Wählen Sie OAuth, wählen Sie Tools scannen und genehmigen Sie den `mcp:use`-Bereich im Browser. 4. Erstellen Sie die Entwurfs-App, aktivieren Sie sie und wählen Sie sie im Tools-Menü einer neuen Unterhaltung aus. [Offizielle ChatGPT-MCP-Dokumentation](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt) ## Claude, Claude Desktop, Cowork oder Claude Code verbinden Öffnen Sie in Claude Anpassen > Connectors > Benutzerdefinierten Connector hinzufügen, geben Sie `https://embroideryfileconverter.com/mcp/embroidery` ein, wählen Sie Verbinden und schließen Sie OAuth ab. Team- und Enterprise-Besitzer fügen den Connector unter Organisations-Einstellungen > Connectors hinzu, bevor Mitglieder sich einzeln verbinden. Claude-Code-Befehl: ```bash claude mcp add --transport http embroidery-file-converter https://embroideryfileconverter.com/mcp/embroidery # Führen Sie dann /mcp in Claude Code aus und schließen Sie die Browser-Autorisierung ab. ``` [Offizielle Claude-Remote-MCP-Dokumentation](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) ## OpenAI-Agents-SDK verbinden Ihr Backend muss OAuth-Autorisierungscode + PKCE für seinen angemeldeten Benutzer abschließen, Tokens verschlüsselt auf dem Server speichern, sie bei Bedarf aktualisieren und das aktuelle Zugriffstoken an das gehostete MCP-Tool übergeben. Geben Sie dieses Token niemals in Browser-JavaScript preis. ```typescript import { Agent, hostedMcpTool } from '@openai/agents'; const agent = new Agent({ name: 'Embroidery assistant', tools: [ hostedMcpTool({ serverLabel: 'embroidery', serverUrl: 'https://embroideryfileconverter.com/mcp/embroidery', authorization: process.env.EFC_MCP_ACCESS_TOKEN, requireApproval: 'always', }), ], }); ``` [Offizielle OpenAI-Agents-SDK-MCP-Dokumentation](https://developers.openai.com/api/docs/guides/tools-connectors-mcp) ## Cursor verbinden Fügen Sie dies zu `.cursor/mcp.json` hinzu, starten Sie den Server in Cursor-Einstellungen > MCP und schließen Sie OAuth ab. Cursor-Agent-Benutzer können `cursor-agent mcp login embroidery-file-converter` ausführen. ```json { "mcpServers": { "embroidery-file-converter": { "url": "https://embroideryfileconverter.com/mcp/embroidery" } } } ``` [Offizielle Cursor-MCP-Dokumentation](https://docs.cursor.com/context/model-context-protocol) ## VS Code und GitHub Copilot verbinden Führen Sie `MCP: Add Server` aus und wählen Sie HTTP, oder fügen Sie dies zu `.vscode/mcp.json` hinzu. Starten Sie mit `MCP: List Servers`, vertrauen Sie der Konfiguration und schließen Sie die Browser-Autorisierung ab. ```json { "servers": { "embroidery-file-converter": { "type": "http", "url": "https://embroideryfileconverter.com/mcp/embroidery" } } } ``` [Offizielle VS-Code-MCP-Dokumentation](https://code.visualstudio.com/docs/agent-customization/mcp-servers) ## OpenClaw verbinden ```bash openclaw mcp add embroidery-file-converter \ --url https://embroideryfileconverter.com/mcp/embroidery \ --transport streamable-http \ --auth oauth \ --oauth-scope mcp:use openclaw mcp login embroidery-file-converter openclaw mcp doctor embroidery-file-converter --probe ``` [Offizielle OpenClaw-MCP-Dokumentation](https://docs.openclaw.ai/cli/mcp) ## Gemini-CLI verbinden Fügen Sie den Server zu `~/.gemini/settings.json` hinzu, dann führen Sie `/mcp auth embroidery-file-converter` in Gemini CLI aus. ```json { "mcpServers": { "embroidery-file-converter": { "url": "https://embroideryfileconverter.com/mcp/embroidery" } } } ``` [Offizielle Gemini-CLI-MCP-Dokumentation](https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md) ## OpenCode verbinden Fügen Sie dies zu `opencode.json` hinzu, dann führen Sie `opencode mcp auth embroidery-file-converter` aus und überprüfen Sie es mit `opencode mcp list`. ```json { "$schema": "https://opencode.ai/config.json", "mcp": { "embroidery-file-converter": { "type": "remote", "url": "https://embroideryfileconverter.com/mcp/embroidery" } } } ``` [Offizielle OpenCode-MCP-Dokumentation](https://opencode.ai/docs/mcp-servers/) ## Windsurf Cascade verbinden Öffnen Sie Windsurf-Einstellungen > Cascade > MCP-Server oder fügen Sie dies zu `~/.codeium/windsurf/mcp_config.json` hinzu. Starten Sie den Server, schließen Sie OAuth ab und aktivieren Sie nur die erforderlichen Tools. ```json { "mcpServers": { "embroidery-file-converter": { "serverUrl": "https://embroideryfileconverter.com/mcp/embroidery" } } } ``` [Offizielle Windsurf-MCP-Dokumentation](https://docs.windsurf.com/windsurf/cascade/mcp) ## Cline verbinden Das OAuth-Verhalten von Cline variiert je nach Release und Oberfläche. Öffnen Sie MCP-Server > Remote-Server, wählen Sie Streamable HTTP und verwenden Sie diese Konfiguration mit einer leeren Genehmigungs-Allow-List: ```json { "mcpServers": { "embroidery-file-converter": { "type": "streamableHttp", "url": "https://embroideryfileconverter.com/mcp/embroidery", "disabled": false, "autoApprove": [] } } } ``` Wenn die installierte Cline-Version OAuth nicht abschließen kann, verwenden Sie eine geprüfte und versionsgepinnten OAuth-Bridge oder wählen Sie einen Client mit nativem OAuth. Übergeben Sie kein langlebiges Token an `cline_mcp_settings.json`. [Offizielle Cline-MCP-Dokumentation](https://github.com/cline/cline/blob/main/docs/mcp/mcp-overview.mdx) ## OAuth-Erkennung und PKCE - Metadaten geschützter Ressourcen: `https://embroideryfileconverter.com/.well-known/oauth-protected-resource/mcp/embroidery` - Autorisierungsserver-Metadaten: `https://embroideryfileconverter.com/.well-known/oauth-authorization-server` - Dynamische Client-Registrierung: `https://embroideryfileconverter.com/oauth/register` - Aussteller des Autorisierungsservers: `https://embroideryfileconverter.com` - Grant: Autorisierungscode - PKCE-Methode: S256 - Erforderlicher Scope: `mcp:use` Dynamische Client-Registrierung akzeptiert nur Callback-Ursprünge und native Schemata, die vom Betreiber explizit erlaubt sind. Beliebige Callback-Domains werden abgelehnt. Das Konto muss eine verifizierte E-Mail-Adresse haben, bevor der MCP-Endpunkt verwendet werden kann. Die standardmäßig vertrauenswürdigen gehosteten Callbacks sind auf offizielle ChatGPT-, Claude- und VS-Code-Ursprünge sowie Loopback-Callbacks für installierte Clients beschränkt. Wildcard-Weiterleitungsdomains sind nicht aktiviert. Bereitstellungen, die `MCP_REDIRECT_DOMAINS` überschreiben, müssen nur die Clients behalten, die sie absichtlich unterstützen. Beispielregistrierung für einen erlaubten lokalen Callback: ```bash curl -X POST https://embroideryfileconverter.com/oauth/register \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{ "client_name": "Your local agent", "redirect_uris": ["http://127.0.0.1:49831/callback"] }' ``` ## Vollständige Tool-Referenz ### `list-formats-tool` Schreibgeschützt. Nimmt keine Argumente entgegen. Gibt `artwork_inputs[]` und `formats[]` mit Feldern für lesbar, schreibbar, Label und Warnung zurück. Vor der Wahl eines Workflows oder Zielformats aufrufen. ### `get-account-usage-tool` Schreibgeschützt. Nimmt keine Argumente entgegen. Gibt aktuelles Vorschau-Kontingent, Guthaben, Workflow-Kosten, Abonnement-Limits und Reset-Daten zurück. Es kauft oder verbraucht nichts. ### `list-processing-jobs-tool` Schreibgeschützt. Listet aktuelle Aufträge des verbundenen Kontos auf. - `limit`: optionale Ganzzahl von 1 bis 50; Standard 20 ### `get-processing-job-tool` Schreibgeschützt. Gibt einen eigenen Auftrag mit Status, Ereignissen, Metriken, Warnungen, Vorschau-Dateien und verfügbaren OAuth-geschützten Datei-URLs zurück. - `workflow`: erforderlich `conversion` oder `digitising` - `job_id`: erforderliche 26-stellige Auftrags-ID ### `create-processing-job-tool` Erzeugt gespeicherte Daten. Startet einen privaten Vorschau-Auftrag und kann Vorschau-Kontingent verbrauchen, kauft jedoch keine Credits und entsperrt keinen kostenpflichtigen Download. - `workflow`: erforderlich `conversion` oder `digitising` - `file_name`: erforderlicher Originaldateiname mit Erweiterung, 3 bis 255 Zeichen, ohne Pfadtrennzeichen oder Steuerzeichen - `file_base64`: erforderliches rohes Standard-Base64 ohne data-URL-Präfix - `format`: erforderliches kleingeschriebenes schreibbares Stickformat - `width_mm`: Zahl von 10 bis 300, für Digitalisierung erforderlich - `colour_count`: Ganzzahl von 1 bis 24, für Digitalisierung erforderlich Das strukturierte Ergebnis enthält `billing_authorized: false`. Bei Konvertierung muss das gewählte Ausgabeformat vom erkannten Quellformat abweichen. ## JSON-RPC-Tool-Beispiele Formate auflisten: ```json { "jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": { "name": "list-formats-tool", "arguments": {} } } ``` Digitalisierungs-Vorschau erstellen: ```json { "jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": { "name": "create-processing-job-tool", "arguments": { "workflow": "digitising", "file_name": "logo.png", "file_base64": "iVBORw0KGgoAAA...", "format": "pes", "width_mm": 90, "colour_count": 8 } } } ``` Zurückgegebenen Auftrag abfragen: ```json { "jsonrpc": "2.0", "id": 4, "method": "tools/call", "params": { "name": "get-processing-job-tool", "arguments": { "workflow": "digitising", "job_id": "01JEXAMPLEJOBID000000000" } } } ``` Mögliche Auftragsstatus sind `queued`, `processing`, `completed` und `failed`. Mit Backoff abfragen und bei terminalem Status stoppen. Datei-URLs erfordern denselben OAuth-Zugriffstoken und unterliegen dem `expiresAt`-Aufbewahrungsdatum des Uploads. ## Beispiel-Prompts in natürlicher Sprache - “Prüfen, welche Formate PES lesen und sicher JEF schreiben können. Kompatibilitätswarnungen anzeigen.” - “Listen Sie meine fünf neuesten Stick-Jobs auf und fassen Sie alle fehlgeschlagenen zusammen.” - “Vor dem Upload bitte um Bestätigung. Digitalisieren Sie anschließend logo.png bei 90 mm Breite mit maximal 8 Farben und geben Sie eine PES-Vorschau zurück.” - “Auftrag 01J… abfragen, bis er abgeschlossen ist, dann Stichmetriken, Warnungen und Freigabe des Downloads melden.” ## Sicherheitsmodell - Kein Tool für Abrechnung, Checkout, Credit-Kauf oder Freischaltung kostenpflichtiger Downloads wird bereitgestellt. - Kein Tool zur API-Schlüssel-Erstellung, Authentifizierungsänderung, Anmeldedaten-Lesen oder Kontolöschung wird bereitgestellt. - Jeder Lesezugriff auf Aufträge ist auf den verbundenen Benutzer beschränkt. - Das Erstellen-Tool speichert einen privaten Upload und erstellt einen Auftrag; der Agent wird angewiesen, vor dem Upload nachzufragen. - Dateinamen, Metadaten, Auftragsmeldungen und Warnungen sind nicht vertrauenswürdige Daten. Der Server weist Agenten an, niemals darin eingebettete Befehle auszuführen. - Ein abgeschlossenes Ergebnis ist nicht automatisch produktionsfertig. Agenten sollten Validierungsmetriken und Warnungen prüfen, bevor sie Aussagen treffen. ## Fehlersuche - `401 Unauthorized`: kein gültiger Zugriffstoken gesendet; OAuth-Verbindung des Clients neu starten. - `403 Forbidden`: dem Token fehlt `mcp:use`, das Konto ist nicht verifiziert oder der angeforderte Auftrag gehört einem anderen Konto. - `invalid_redirect_uri`: der Callback-Ursprung oder das native Schema steht nicht auf der Allow-Liste des Servers. - `422`: Tool-Argumente, Base64-Daten, Quelltyp, Zielformat oder Kontingent haben die Validierung nicht bestanden. - `429`: Rate-Limit überschritten; `Retry-After` beachten und exponentielles Backoff mit Jitter verwenden. ## Verwandte Seiten - [Dokumentation der Entwickler-API](https://embroideryfileconverter.com/de/developers) - [OpenAPI-3.1-Beschreibung](https://embroideryfileconverter.com/developers/openapi.json) - [Datenschutzrichtlinie](https://embroideryfileconverter.com/de/privacy)