Zum Inhalt springen
Zurück zum Blog
mcpaiintegrationstutorial

Produktkonfigurator-MCP: Verbinden Sie Claude, Cursor und VS Code mit Simplio3D

Simplio3D·
Produktkonfigurator-MCP: Verbinden Sie Claude, Cursor und VS Code mit Simplio3D

Fragen Sie noch heute einen KI-Assistenten zu Ihrem Produktkonfigurator, und er antwortet anhand dessen, was Sie in den Chat einfügen: eines Screenshots, einer Liste von Optionen oder eines von Ihnen eingegebenen Preises. MCP-Connectoren machen diesen Schritt überflüssig. Ein Connector gibt dem Assistenten einen direkten, berechtigten Zugang zu Ihrem Simplio3D Konto, sodass er das tatsächliche Projekt liest – die Optionsblöcke, bedingten Regeln, Preisformel und Teilenamen im 3D-Modell – und darauf basierend antwortet.

Dieser Leitfaden erklärt, was ein MCP-Connector ist, was ein verbundener Agent in Simplio3D tun kann und was nicht, wie riskante Änderungen unter Ihrer Kontrolle bleiben und wie Sie Claude, Cursor oder VS Code verbinden.

Was sind MCP-Connectoren?

Das Model Context Protocol (MCP) ist ein offener Standard, um KI-Assistenten mit externen Tools und Daten zu verbinden. Es hat zwei Seiten. Ein MCP-Client ist das KI-Tool, das Sie bereits verwenden, etwa Claude, Cursor oder VS Code. Ein MCP-Server ist das System, mit dem sich der Assistent verbindet: Es stellt eine Liste von Tools bereit, jeweils mit Beschreibung und Schema, die der Assistent aufrufen kann, wenn eine Frage dies erfordert.

Ein Connector ist die Verbindung zwischen beiden: die Adresse des Servers sowie eine Berechtigung, die festlegt, wer sich verbindet und worauf zugegriffen werden darf. Claude nennt dies einen benutzerdefinierten Connector; andere Clients bezeichnen es als MCP-Server-Eintrag. Für Simplio3D sind es immer dieselben zwei Dinge:

  • Der Endpunkt: https://app.simplio3d.ai/mcp
  • Eine Berechtigung: eine OAuth-Anmeldung, die Sie auf einem Simplio3D Zustimmungsbildschirm genehmigen, oder ein Verbindungstoken, das Sie unter Dashboard → Integrationen → KI-Verbindungen erstellen.

Nach der Verbindung sieht der Assistent die Tools von Simplio3D neben seinen eigenen und entscheidet anhand Ihrer Anfrage, wann er sie aufruft.

Diagramm: Claude, Cursor und VS Code verbinden sich mit dem Simplio3D MCP-Server unter app.simplio3d.ai/mcp. Jeder Aufruf durchläuft vier Prüfungen (verifiziertes Konto, aktiver Plan oder Testversion, Workspace-Rolle, Verbindungsberechtigungen), bevor er 123 Tools (52 Lese-, 68 Schreib- und 3 Workflow-Tools) sowie die Projekte eines Workspaces erreicht. Änderungen mit hohem Risiko werden zu einem Vorschlag, der unter „Ausstehende KI-Änderungen“ wartet, bis Sie auf „Anwenden“ klicken; anschließend wird ein Snapshot erstellt.
Jeder KI-Client durchläuft denselben Endpunkt und dieselben vier Prüfungen. Eine Änderung mit hohem Risiko wird als Vorschlag angehalten, bis Sie sie im Dashboard anwenden.

Was ein verbundener Agent in Simplio3D tun kann

Der MCP-Server Simplio3D stellt 123 Tools bereit: 52 zum Lesen, 68 zum Schreiben im kontrollierten Schreibmodus und 3 zum Ausführen von Agenten-Workflows. Zusammen decken sie Projekte, die Prüfung von 3D-Modellen, Materialien, Optionsblöcke, bedingte Logik, Preise, Formulare, Angebotsanfragen und Shop-Verbindungen ab. In der Praxis kann ein verbundener Agent:

  • Ein echtes Projekt lesen: seine Modelle, Optionsblöcke und Varianten, Materialien, bedingten Regeln, Preisblöcke und -formeln sowie Formularfelder.
  • Das 3D-Modell untersuchen: Teilenamen und Hierarchie prüfen, um sicherzustellen, dass jede Option weiterhin auf ein vorhandenes Mesh verweist.
  • Einen Konfigurator prüfen: fehlende Teilziele, gelöschte Materialien, Regeln, die nie ausgelöst werden können, und Varianten ohne Preis erkennen.
  • Logik erklären und eine Konfiguration bepreisen: feststellen, welche Regel eine Option ausblendet und was eine bestimmte Auswahl kostet – auf dem Server berechnet.
  • Erstellen und bearbeiten: Projekte, Optionsblöcke, Varianten, Materialien, bedingte Regeln und Formularfelder anlegen sowie vorhandene Inhalte aufräumen.
  • Agenten-Workflows ausführen: einen mehrstufigen Auftrag wie eine Projektprüfung oder sichere Reparatur starten, Fragen beantworten und den Fortschritt verfolgen. Workflows pausieren für Ihre Freigabe und veröffentlichen niemals etwas.
  • Leads zusammenfassen: die eingegangenen Angebotsanfragen und die Konfigurationen der einzelnen Kunden lesen.
  • Produktfragen anhand der Dokumentation beantworten: die offiziellen Dokumente von Simplio3D durchsuchen und die Seite zitieren, statt aus dem Gedächtnis zu antworten.

Jedes Tool ist zusammen mit dem benötigten Umfang und der Angabe, ob es liest oder schreibt, in der MCP-Tool-Referenz aufgeführt.

Was es nicht tun kann

Einige Aktionen bleiben unabhängig von den gewährten Berechtigungen unerreichbar. Ein verbundener Agent kann kein Projekt veröffentlichen, keinen Freigabelink erstellen und keine Einbettungseinstellungen ändern. Er kann keine Dateien hochladen oder ein Projekt löschen. Er kann keinen Shopify- oder WooCommerce-Shop verbinden oder trennen und auch nicht die Zugangsdaten dieses Shops lesen. Außerdem erhält er niemals Datenbankzugriff, API-Schlüssel, Webhook-Geheimnisse oder Passwörter für Freigabeansichten: Tools geben kuratierte Zusammenfassungen statt Rohdaten zurück.

Berechtigungsumfänge: Geben Sie jeder Verbindung nur das, was sie benötigt

Eine Verbindung kann nur die Tools sehen und aufrufen, die von ihren Berechtigungsumfängen abgedeckt werden. Beginnen Sie mit reinem Lesezugriff und fügen Sie je nach Aufgabe jeweils einen Schreibumfang hinzu.

Simplio3D MCP-Verbindungsberechtigungen
BerechtigungWas sie erlaubtErteilen Sie sie, wenn der Agent
Workspace (lesen)Ihre Zusammenfassung von Arbeitsbereich, Tarif und NutzungInformieren Sie darüber, welchen Tarif Sie nutzen und wie viel davon Sie verbrauchen
Projekte (lesen / schreiben)Projekte auflisten und prüfen; erstellen, umbenennen, duplizieren und sichere Einstellungen ändernBerichte zu Ihren Projekten erstellen oder neue Projekte einrichten
Assets (lesen)Assets auflisten und die Teilenamen und Hierarchie eines Modells prüfenÜber die Meshes in Ihren Modellen sprechen
Materialien (Lesen / Schreiben)Bibliothek lesen; Materialien erstellen und bearbeiten sowie Varianten zuweisenIhre Materialbibliothek aufbauen oder aufräumen
Konfigurator (Lesen / Schreiben)Optionsblöcke, Varianten und bedingte Regeln lesen und erstellenDie Optionen erstellen oder umstrukturieren, die Käufer sehen
Preisgestaltung (Lesen / Schreiben)Preise und Formeln lesen; Änderungen an Preisen, SKU und Formeln vorschlagenArbeiten Sie an der Preisgestaltung. Jede Preisänderung ist ein Vorschlag, den Sie genehmigen.
Formulare (lesen / schreiben)Angebots- und Checkout-Formularfelder lesen und erstellenIhr Lead-Formular erstellen oder anpassen
Angebote (lesen)Eingereichte Angebotsanfragen einschließlich KundendatenEingehende Leads zusammenfassen. Dabei handelt es sich um Kundendaten – gewähren Sie den Zugriff daher bewusst.
Commerce (lesen / schreiben)Ob ein Shop verbunden ist, seine Produkte sowie Vorschläge zum Verknüpfen eines Produkts oder zum Festlegen des Checkout-ModusEin Projekt mit einem Shop-Produkt verknüpfen. Dabei werden niemals die Zugangsdaten des Shops preisgegeben.
Workflows (Lesen / Schreiben)Agenten-Workflows verfolgen; sie starten, ihre Fragen beantworten, pausieren oder abbrechenEinen länger laufenden Auftrag wie etwa eine Projektprüfung ausführen oder überwachen
Dokumentation (Lesen)Die offizielle Simplio3D-Dokumentation ohne Workspace-DatenProduktfragen mit einer Quelle beantworten

Mehrere kleine Verbindungen sind sicherer als eine, die alles kann. Geben Sie dem Assistenten, der Preise prüft, eine eigene Verbindung mit Leseberechtigungen plus Schreibberechtigung für Preise, und dem Assistenten, der Projekte erstellt, eine weitere. Wenn Sie eine Verbindung widerrufen, wird die andere dadurch nie unterbrochen.

Wie Änderungen unter Ihrer Kontrolle bleiben

Eine KI einen Live-Konfigurator bearbeiten zu lassen, funktioniert nur, wenn fehlerhafte Änderungen Ihre Kunden nicht erreichen können. Simplio3D verarbeitet jeden Schreibvorgang in drei Schritten: vorschlagen, bestätigen, Snapshot erstellen.

  • Änderungen mit geringem Risiko werden ohne Wartezeit übernommen, etwa das Umbenennen eines Blocks oder das Hinzufügen einer Variante.
  • Änderungen mit hohem Risiko erzeugen ausschließlich einen Vorschlag: Preise, SKUs, Löschungen, Massenbearbeitungen, gemeinsam genutzte Materialien und Shop-Produktverknüpfungen. Der Vorschlag wartet unter Ausstehende KI-Änderungen auf der Seite KI-Verbindungen und listet jede Änderung auf, die er vornehmen würde. Sie klicken auf Anwenden oder verwerfen ihn. Kein Agent kann seinen eigenen Vorschlag genehmigen, und diese Regel kann nicht deaktiviert werden.
  • Von jeder übernommenen Änderung wird ein Snapshot erstellt, sodass sie rückgängig gemacht, erneut validiert und in einem Prüfprotokoll erfasst werden kann.

Vorschläge sind nur kurz gültig. Wenn sich das Projekt geändert hat, seit der Agent etwas vorgeschlagen hat, wird der alte Vorschlag abgelehnt, anstatt Ihre neueren Änderungen zu überschreiben. Fragen Sie den Agenten einfach erneut.

Darüber hinaus ist ein Tool-Aufruf nur erfolgreich, wenn alle vier Prüfungen bestanden werden: Die E-Mail-Adresse des Kontos ist verifiziert, der Tarif des Workspace-Inhabers ist aktiv, die Rolle des Sitzes erlaubt die Aktion und die Verbindung besitzt den entsprechenden Berechtigungsumfang. Die engste Einschränkung gilt. Ein Viewer-Sitz kann beispielsweise niemals eine Änderung vornehmen oder bestätigen, unabhängig davon, welche Berechtigungsumfänge seine Verbindung hat.

So richtest du MCP-Konnektoren für Simplio3D ein

Die Token-Route funktioniert in jedem Client. Du verwendest Claude? Die untenstehende OAuth-Route macht das Token überflüssig.

  1. OpenAI-Verbindungen

    Gehe in Simplio3D zu Dashboard → Integrationen → KI-Verbindungen und kopiere den oben auf der Seite angezeigten MCP-Endpunkt.

  2. Erstelle für jedes Tool eine eigene Verbindung

    Klicke auf „Verbindung erstellen“ und benenne sie nach dem Tool, das sie verwenden wird, etwa „Claude Desktop“ oder „Cursor“. Eine Verbindung pro Tool macht später eindeutig, welche du widerrufen musst.

  3. Wähle den Workspace

    Eine Verbindung ist dauerhaft an den Workspace gebunden, den du hier auswählst. Um mit zwei Workspaces zu arbeiten, erstelle in jedem eine Verbindung.

  4. Aktivieren Sie nur die benötigten Berechtigungen

    Beginnen Sie mit Leserechten und fügen Sie Schreibrechte einzeln hinzu. Gewähren Sie Zugriff auf Angebote nur, wenn der Agent Kundendaten sehen soll.

  5. Kopieren Sie das Token und fügen Sie es zu Ihrem Tool hinzu

    Das Token beginnt mit smcp_ und wird nur einmal angezeigt, danach nie wieder. Fügen Sie es zusammen mit dem Endpunkt in Ihr KI-Tool ein, wie in der Tabelle unten gezeigt. Behandeln Sie es wie ein Passwort: Es ist 90 Tage gültig und kann jederzeit rotiert oder widerrufen werden.

  6. Überprüfen Sie die Verbindung

    Stellen Sie eine Frage, die nur Ihr Konto beantworten kann: „Liste meine Simplio3D Projekte auf und teile mir mit, welche davon veröffentlicht sind.“ Wenn die Antwort Ihre tatsächlichen Projekte nennt, funktioniert der Connector.

Claude ohne Token verbinden. Simplio3D ist im Connector-Verzeichnis von Claude aufgeführt. Öffnen Sie in Claude Anpassen → Connectors, suchen Sie nach Simplio3D und klicken Sie auf Verbinden, oder wählen Sie Benutzerdefinierten Connector hinzufügen und fügen Sie https://app.simplio3d.ai/mcp ein. In beiden Fällen öffnet Claude die Anmeldung von Simplio3D sowie einen Zustimmungsbildschirm, auf dem Sie den Workspace und die Berechtigungsumfänge auswählen; der schreibgeschützte Zugriff ist bereits für Sie aktiviert. Die Verbindung erscheint anschließend in derselben Liste der KI-Verbindungen, als OAuth-App gekennzeichnet. Dort können Sie sie wie jede andere Verbindung rotieren oder widerrufen.

Wo jeder KI-Client den Simplio3D Connector einträgt
KI-ClientWo Sie ihn hinzufügenWas Sie hinzufügen
Claude (OAuth)Anpassen → Connectors: Nach Simplio3D suchen oder „Benutzerdefinierten Connector hinzufügen“ auswählenKein Eintrag aus dem Verzeichnis; die Endpunkt-URL für einen benutzerdefinierten Connector. Kein Token: Stattdessen genehmigen Sie den Simplio3D Zustimmungsbildschirm.
Claude DesktopEinstellungen → Entwickler → Konfiguration bearbeiten (claude_desktop_config.json)Ein „simplio3d“-Server vom Typ http mit der Endpunkt-URL und einem Header „Authorization: Bearer smcp_…“
Claude CodeIhr Terminalclaude mcp add --transport http simplio3d https://app.simplio3d.ai/mcp --header "Authorization: Bearer smcp_…"
Cursor~/.cursor/mcp.json oder .cursor/mcp.json für ein ProjektEin „simplio3d“-Server mit der Endpunkt-URL und dem Authorization-Header
VS Code (GitHub Copilot).vscode/mcp.jsonEin HTTP-Server mit der Endpunkt-URL, der das Token über eine Passwortabfrage einliest, anstatt es in der Datei zu speichern
ChatGPT und CodexChatGPT → Plugins: Nach Simplio3D suchen, dann Plugin installieren und Simplio3D verbindenNichts: Das Plugin enthält den Connector. Kein Token: Sie melden sich bei Simplio3D an und genehmigen den Zugriff

Prompts, die Sie zuerst ausprobieren sollten

Nennen Sie das Projekt und bitten Sie um Belege: „Welche Regel blendet es aus?“ führt zu einer präziseren Antwort als „Warum ist es ausgeblendet?“.

Beispiel-Prompts für einen Simplio3D MCP-Connector
FragenWas der Agent prüftWas Sie zurückerhalten
„Prüfe meinen Oak Dining Table-Konfigurator und liste alles auf, was nicht funktioniert.“Findet das Projekt und validiert es anschließend, einschließlich der Teilenamen im 3D-ModellErgebnisse nach Schweregrad: fehlende Zielteile, gelöschte Materialien, Regeln, die niemals ausgelöst werden können, Varianten ohne Preis
„Warum ist die Oberfläche Nussbaum ausgeblendet, wenn ich die kleine Platte auswähle?“Die Optionsblöcke und bedingten Regeln, anschließend werden sie ausgewertetDie Regel, die sie ausblendet, sowie die Bedingung, die zutraf
„Hat jede Variante in diesem Konfigurator einen Preis?“Die Preisblöcke, anschließend ein ValidierungsdurchlaufDie Varianten ohne Preis nach Name, jeweils mit dem zugehörigen Preisblock
„Welche Optionen zielen auf Teile ab, die im Modell nicht mehr vorhanden sind?“Die Ziele, die Sie anhand der realen Geometrie erstellt habenDie aufgelisteten veralteten Ziele
„Was würde Eiche in der großen Größe kosten?“Die Optionsblöcke, gefolgt von einer serverseitigen PreisberechnungGrundpreis, jede Anpassung, Steuer und der Gesamtbetrag in der Projektwährung
„Fassen Sie die Angebotsanfragen zusammen, die wir diese Woche erhalten haben.“Die Angebotsanfragen und jede KonfigurationKontaktdaten, die Konfiguration jedes Kunden und der Preis zum jeweiligen Zeitpunkt

Wichtige Einschränkungen, bevor Sie sich darauf verlassen

  • Agenten lesen gespeicherte Daten. Der Editor speichert wenige Sekunden nach jeder Änderung automatisch, sodass eine gerade vorgenommene Bearbeitung möglicherweise noch nicht sichtbar ist. Speichern Sie und fragen Sie dann erneut.
  • Serverseitige Preise und Logik haben Einschränkungen. Die Preisberechnung und Regelauswertung decken die häufigsten Fälle ab, jedoch nicht jedes Verhalten des veröffentlichten Konfigurators, etwa die Preisgestaltung pro Einheit bei Zahleneingaben. Jedes Ergebnis listet auf, was nicht ausgewertet wurde; die Vorschau und die veröffentlichte Freigabeansicht sind weiterhin maßgeblich.
  • Ratenbegrenzungen. Jede Verbindung kann alle fünf Minuten 300 Anfragen stellen. Ein Workspace akzeptiert alle zehn Minuten 30 angewendete KI-Änderungen, die von allen verbundenen Agenten und dem integrierten Assistenten gemeinsam genutzt werden.
  • Große Antworten werden gekürzt und entsprechend gekennzeichnet. Ein Ergebnis von mehr als etwa 60 KB wird zusammengefasst und als gekürzt markiert, damit der Agent keinen Teil einer Liste mit der vollständigen Liste verwechselt.
  • Was der Agent liest, wird an Ihren KI-Anbieter übermittelt. Angebotsanfragen enthalten Kundennamen und Kontaktdaten. Erteilen Sie daher den Bereich „Angebote“ bewusst.
  • Token laufen nach 90 Tagen ab. Ersetzen Sie einen Token sofort, wenn er in einen Chat, ein Support-Ticket oder eine Bildschirmfreigabe eingefügt wurde. Durch das Ersetzen wird der alte Token sofort deaktiviert.

Eine Tool-Ebene hinter jeder KI-Oberfläche

Der MCP-Server ist kein separat aufgesetztes Produkt. Der integrierte KI-Assistent von Simplio3D, der authentifizierte REST-Tool-Endpunkt für Ihre eigenen Automatisierungen und externe MCP-Clients greifen alle auf dieselbe Tool-Registry zu – mit derselben Authentifizierung, denselben Berechtigungen und demselben Audit-Protokoll. Eine Funktion verhält sich unabhängig vom Aufrufort gleich, und ein Bereich oder eine Rolle, die sie an einer Stelle blockiert, blockiert sie überall.

Darin unterscheidet sich MCP auch von REST API und SDK. SDK ist ein typisierter Client für Ihren eigenen Code, der mit einem API-Schlüssel authentifiziert wird; dieser Schlüssel wird am MCP-Endpunkt niemals akzeptiert. MCP ist für KI-Agenten vorgesehen, die über eine Verbindung authentifiziert werden, deren Zugriff Sie für jedes Tool einzeln festlegen.

Fragen zu MCP-Connectors

Alle: Starter, Pro und Enterprise sowie die 30-tägige Pro-Testversion, mit der jedes Konto startet. MCP-Connectors sind seit September 2026 in Starter enthalten. In Starter folgt ein verbundener Agent denselben Planregeln wie das Dashboard und kann daher keine Modular-Projekte erstellen oder ein Projekt duplizieren.

Sie möchten zuerst den Konfigurator erstellen?

Wie ein Projekt vom 3D-Modell zu Optionen, bedingter Logik und Preisen gelangt, noch bevor ein Agent es überhaupt liest.

Soll der Agent Ihre Preise prüfen?

Die Preisblöcke und der Formeleditor, die ein verbundener Agent ausliest und für Berechnungen nutzt.

Möchten Sie, dass KI auch den Konfigurator erstellt?

Erstellen Sie mit KI anhand einer Produktbeschreibung Optionen, Regeln, Preise und Formulare direkt in Simplio3D.

Sie verwenden ChatGPT?

Das Simplio3D-Plugin im Plugins-Verzeichnis von ChatGPT stellt diese Verbindung für Sie her – mit einer geführten Anmeldung statt eines Tokens.

Aus dem Blog

Leitfäden, Tutorials und Neuigkeiten vom Simplio3D-Team.

3D-Commerce entwickeln, bereitstellen und skalieren.

Nutzen Sie einen 3D-Produktkonfigurator, um den Verkauf zu steigern und direkt über Ihre Website Angebote zu erstellen.

Ähnliche Artikel