Productconfigurator MCP: verbind Claude, Cursor en VS Code met Simplio3D

Vraag een AI-assistent vandaag nog iets over je productconfigurator en die antwoordt op basis van wat je in de chat plakt: een screenshot, een lijst met opties, een prijs die je hebt uitgeschreven. MCP-connectors maken die stap overbodig. Een connector geeft de assistent een directe verbinding met de juiste rechten naar je Simplio3D-account, zodat hij het daadwerkelijke project leest (de optieblokken, de voorwaardelijke regels, de prijsformule, de onderdeelnamen in het 3D-model) en daarop baseert wat hij antwoordt.

Deze gids legt uit wat een MCP-connector is, wat een verbonden agent wel en niet kan doen in Simplio3D, hoe risicovolle wijzigingen onder jouw controle blijven en hoe je Claude, Cursor of VS Code verbindt.

Wat zijn MCP-connectors?

Het Model Context Protocol (MCP) is een open standaard om AI-assistenten met externe tools en gegevens te verbinden. Het heeft twee kanten. Een MCP-client is de AI-tool die je al gebruikt, zoals Claude, Cursor of VS Code. Een MCP-server is het systeem waarmee de assistent verbinding maakt: deze publiceert een lijst met tools, elk met een beschrijving en een schema, die de assistent kan aanroepen wanneer een vraag daarom vraagt.

Een connector vormt de koppeling tussen beide: het adres van de server plus een referentie die aangeeft wie verbinding maakt en wat diegene mag gebruiken. Claude noemt dit een aangepaste connector; andere clients noemen het een MCP-serververmelding. Voor Simplio3D gaat het altijd om dezelfde twee zaken:

• Het eindpunt: https://app.simplio3d.ai/mcp
• Een referentie: een OAuth-aanmelding die je goedkeurt op een toestemmingsscherm van Simplio3D, of een verbindingstoken dat je aanmaakt via Dashboard → Integraties → AI-verbindingen.

Zodra de verbinding is gemaakt, ziet de assistent de tools van Simplio3D naast zijn eigen tools en bepaalt hij op basis van je vraag wanneer hij ze aanroept.

Wat een verbonden agent kan doen in Simplio3D

De MCP-server van Simplio3D biedt 123 tools: 52 voor lezen, 68 voor schrijven volgens een gecontroleerd-schrijfmodel en 3 voor het uitvoeren van agentworkflows. Samen bestrijken ze projecten, inspectie van 3D-modellen, materialen, optieblokken, voorwaardelijke logica, prijzen, formulieren, offerteaanvragen en winkelkoppelingen. In de praktijk kan een verbonden agent:

• Een echt project uitlezen: de modellen, optieblokken en varianten, materialen, voorwaardelijke regels, prijsblokken en formule, en formuliervelden.
• In het 3D-model kijken: onderdeelnamen en hiërarchie, zodat de agent kan controleren of elke optie nog steeds een bestaand mesh target.
• Een configurator controleren: ontbrekende onderdeeltargets, verwijderde materialen, regels die nooit kunnen worden geactiveerd en varianten zonder prijs.
• Logica uitleggen en een configuratie prijzen: welke regel een optie verbergt en wat een bepaalde set selecties kost, berekend op de server.
• Bouwen en bewerken: projecten, optieblokken, varianten, materialen, voorwaardelijke regels en formuliervelden maken, en bestaande onderdelen opschonen.
• Agentworkflows uitvoeren: een taak met meerdere stappen starten, zoals een projectcontrole of een veilige reparatie, vragen beantwoorden en de voortgang volgen. Workflows pauzeren voor uw goedkeuring en publiceren nooit.
• Leads samenvatten: de ontvangen offerteaanvragen lezen en bekijken wat elke klant heeft geconfigureerd.
• Productvragen beantwoorden op basis van de documentatie: de officiële documentatie van Simplio3D doorzoeken en de pagina citeren, in plaats van vanuit het geheugen te antwoorden.

Elke tool, met de benodigde scope en of deze leest of schrijft, staat vermeld in de MCP-toolreferentie.

Wat het niet kan doen

Sommige acties blijven buiten bereik, ongeacht welke scopes u verleent. Een verbonden agent kan geen project publiceren, geen deellink maken en geen embedinstellingen wijzigen. Hij kan geen bestanden uploaden of een project verwijderen. Hij kan geen Shopify- of WooCommerce-winkel verbinden of ontkoppelen, en ook de inloggegevens van die winkel niet uitlezen. Ook krijgt hij nooit database-toegang, API-sleutels, webhookgeheimen of wachtwoorden voor gedeelde weergaven: tools geven samengestelde samenvattingen terug, geen onbewerkte records.

Scopes: geef elke verbinding alleen wat nodig is

Een verbinding kan alleen de tools zien en aanroepen die binnen de scopes vallen. Begin met alleen-lezen en voeg telkens één schrijfscope toe wanneer de taak dat vereist.

Meerdere kleine verbindingen zijn veiliger dan één verbinding die alles kan. Geef de assistent die prijzen controleert een eigen verbinding met leesscopes plus schrijfrechten voor prijzen, en geef de assistent die projecten bouwt een andere. Als je er één intrekt, onderbreekt dat de andere nooit.

Hoe wijzigingen onder jouw controle blijven

Een AI een live configurator laten bewerken werkt alleen als een verkeerde bewerking je klanten niet kan bereiken. Simplio3D verwerkt elke schrijfactie in drie stappen: voorstellen, bevestigen, momentopname.

• Wijzigingen met laag risico worden direct uitgevoerd, zoals het hernoemen van een blok of het toevoegen van een variant.
• Wijzigingen met hoog risico leveren altijd alleen een voorstel op: prijzen, SKU's, verwijderingen, bulkbewerkingen, gedeelde materialen en koppelingen met winkelproducten. Het voorstel wacht onder Openstaande AI-wijzigingen op de pagina AI-verbindingen en vermeldt elke wijziging die het zou uitvoeren. Je klikt op Toepassen of wijst het af. Geen enkele agent kan zijn eigen voorstel goedkeuren en deze regel kan niet worden uitgeschakeld.
• Van elke toegepaste wijziging wordt een momentopname gemaakt, zodat deze ongedaan kan worden gemaakt, vervolgens opnieuw gevalideerd en in een auditlog geregistreerd.

Voorstellen zijn slechts tijdelijk geldig. Als het project is gewijzigd sinds de agent iets voorstelde, wordt het oude voorstel geweigerd in plaats van je nieuwere bewerkingen te overschrijven; vraag het de agent opnieuw.

Daarnaast slaagt een toolaanroep alleen wanneer alle vier de controles positief zijn: het e-mailadres van het account is geverifieerd, het abonnement van de werkruimte-eigenaar is actief, de rol van de gebruiker staat de actie toe en de verbinding beschikt over de scope. De meest beperkende voorwaarde geldt. Een Viewer-rol kan bijvoorbeeld nooit een wijziging uitvoeren of bevestigen, ongeacht welke scopes de verbinding heeft.

Claude verbinden zonder token. Simplio3D staat vermeld in de connector-directory van Claude. Open in Claude Aanpassen → Connectors, zoek naar Simplio3D en klik op Verbinden, of kies Aangepaste connector toevoegen en plak https://app.simplio3d.ai/mcp. In beide gevallen opent Claude het aanmeldscherm van Simplio3D en een toestemmingsscherm waarin u de werkruimte en scopes kiest; alleen-lezen-toegang is al voor u aangevinkt. De verbinding verschijnt vervolgens in dezelfde lijst met AI Connections, gemarkeerd als OAuth app, en u kunt deze daar net als elke andere verbinding roteren of intrekken.

Prompts om eerst te proberen

Noem het project en vraag om bewijs: “welke regel verbergt dit?” levert een scherper antwoord op dan “waarom is dit verborgen?”.

Beperkingen die u moet kennen voordat u erop vertrouwt

• Agents lezen opgeslagen gegevens. De editor slaat automatisch enkele seconden na elke wijziging op, dus een wijziging van zojuist is mogelijk nog niet zichtbaar. Sla op en vraag het daarna opnieuw.
• Prijzen en logica aan de serverzijde kennen beperkingen. De prijsberekening en de regelbeoordeling dekken de meest voorkomende gevallen, niet elk gedrag van de gepubliceerde configurator, zoals prijsbepaling per eenheid voor Number Input. Elk resultaat vermeldt wat niet is beoordeeld, en Preview en de gepubliceerde deelweergave blijven doorslaggevend.
• Snelheidslimieten. Elke verbinding kan elke vijf minuten 300 verzoeken doen. Een werkruimte accepteert elke tien minuten 30 toegepaste AI-wijzigingen, gedeeld door alle verbonden agents en de ingebouwde assistent.
• Grote antwoorden worden ingekort en vermelden dat. Een resultaat van meer dan ongeveer 60 KB wordt samengevat en gemarkeerd als afgekapt, zodat de agent een deel van een lijst niet voor de volledige lijst kan aanzien.
• Wat de agent leest, gaat naar uw AI-provider. Offerteaanvragen bevatten namen en contactgegevens van klanten, dus verleen de Quotes-scope bewust.
• Tokens verlopen na 90 dagen. Roteer er onmiddellijk een als deze in een chat, supportticket of schermdeling is geplakt. Door te roteren wordt het oude token direct ongeldig.

Eén toollaag achter elk AI-oppervlak

De MCP-server is geen apart product dat er achteraf aan is toegevoegd. De ingebouwde AI-assistent van Simplio3D, het geauthenticeerde REST-toolendpoint voor uw eigen automatiseringen en externe MCP-clients gebruiken allemaal hetzelfde toolregister, achter dezelfde authenticatie, machtigingen en auditlog. Een functionaliteit werkt hetzelfde, ongeacht van waaruit u deze aanroept, en een scope of rol die deze op één plek blokkeert, blokkeert deze overal.

Dat is ook hoe MCP verschilt van de REST API en SDK. De SDK is een getypeerde client voor uw eigen code, geauthenticeerd met een API-sleutel, en die sleutel wordt nooit geaccepteerd op het MCP-endpoint. MCP is bedoeld voor AI-agents, geauthenticeerd met een verbinding waarvan u de scope per tool bepaalt.