Skip til indhold
Tilbage til blog
mcpaiintegrationstutorial

Produktkonfigurator MCP: Forbind Claude, Cursor og VS Code med Simplio3D

Simplio3D·
Produktkonfigurator MCP: Forbind Claude, Cursor og VS Code med Simplio3D

Spørg en AI-assistent om din produktkonfigurator i dag, og den svarer ud fra det, du indsætter i chatten: et skærmbillede, en liste over valgmuligheder, en pris du har skrevet. MCP-connectors fjerner dette trin. En connector giver assistenten en direkte, autoriseret forbindelse til din Simplio3D-konto, så den læser det faktiske projekt (valgblokke, betingede regler, prisformlen, delnavnene i 3D-modellen) og svarer ud fra det.

Denne guide forklarer, hvad en MCP-connector er, hvad en tilsluttet agent kan og ikke kan gøre i Simplio3D, hvordan risikable ændringer forbliver under din kontrol, og hvordan du forbinder Claude, Cursor eller VS Code.

Hvad er MCP-connectors?

Model Context Protocol (MCP) er en åben standard til at forbinde AI-assistenter med eksterne værktøjer og data. Den har to sider. En MCP-klient er det AI-værktøj, du allerede bruger, såsom Claude, Cursor eller VS Code. En MCP-server er det system, assistenten forbinder til: den udgiver en liste over værktøjer, hver med en beskrivelse og et skema, som assistenten kan kalde, når et spørgsmål kræver det.

En connector er forbindelsen mellem de to: serverens adresse samt en legitimationsoplysning, der angiver, hvem der forbinder, og hvad de må tilgå. Claude kalder det en brugerdefineret connector; andre klienter kalder det en MCP-serverpost. For Simplio3D er det altid de samme to ting:

  • Endpointet: https://app.simplio3d.ai/mcp
  • En legitimationsoplysning: en OAuth-logon, som du godkender på en Simplio3D-samtykkeskærm, eller en forbindelsestoken, du opretter under Dashboard → Integrationer → AI-forbindelser.

Når forbindelsen er oprettet, ser assistenten Simplio3D’s værktøjer sammen med sine egne og afgør ud fra det, du spørger om, hvornår de skal bruges.

Diagram: Claude, Cursor og VS Code opretter forbindelse til Simplio3D MCP-serveren på app.simplio3d.ai/mcp. Hvert kald gennemgår fire kontroller (bekræftet konto, aktivt abonnement eller prøveperiode, arbejdsområderolle, forbindelsesomfang), før det når 123 værktøjer (52 læse-, 68 skrive- og 3 workflowværktøjer) og ét arbejdsområdes projekter. Ændringer med høj risiko bliver til et forslag, der afventer under Afventende AI-ændringer, indtil du trykker på Anvend. Derefter tages der et øjebliksbillede.
Alle AI-klienter går gennem det samme endepunkt og de samme fire kontroller. En ændring med høj risiko stopper som et forslag, indtil du anvender den i dashboardet.

Hvad en tilsluttet agent kan gøre i Simplio3D

Simplio3D MCP-serveren stiller 123 værktøjer til rådighed: 52, der læser, 68, der skriver under en kontrolleret skrivemodel, og 3, der kører agentarbejdsgange. Tilsammen dækker de projekter, inspektion af 3D-modeller, materialer, indstillingsblokke, betinget logik, prissætning, formularer, tilbudsanmodninger og butiksforbindelser. I praksis kan en tilsluttet agent:

  • Læse et rigtigt projekt: dets modeller, indstillingsblokke og varianter, materialer, betingede regler, prisblokke og formler samt formularfelter.
  • Se ind i 3D-modellen: delnavne og hierarki, så den kan kontrollere, at hver indstilling fortsat peger på et mesh, der findes.
  • Gennemgå en konfigurator: manglende delmål, slettede materialer, regler, der aldrig kan aktiveres, og varianter uden en pris.
  • Forklare logik og beregne prisen på en konfiguration: hvilken regel der skjuler en indstilling, og hvad et givent sæt valg koster, beregnet på serveren.
  • Opbygge og redigere: oprette projekter, indstillingsblokke, varianter, materialer, betingede regler og formularfelter samt rydde op i det, der allerede findes.
  • Køre agentarbejdsgange: starte en opgave i flere trin, såsom en projektgennemgang eller en sikker reparation, besvare dens spørgsmål og følge dens fremskridt. Arbejdsgange sætter på pause for at få din godkendelse og publicerer aldrig.
  • Opsummere kundeemner: læse de tilbudsanmodninger, du har modtaget, og se, hvad hver kunde har konfigureret.
  • Besvare produktspørgsmål ud fra dokumentationen: søge i den officielle Simplio3D-dokumentation og henvise til siden i stedet for at svare ud fra hukommelsen.

Alle værktøjer er angivet med deres nødvendige omfang og med oplysning om, hvorvidt de læser eller skriver, i MCP-værktøjsreferencen.

Hvad den ikke kan gøre

Nogle handlinger er uden for rækkevidde, uanset hvilke omfang du tildeler. En tilsluttet agent kan ikke publicere et projekt, oprette et delingslink eller ændre indstillinger for indlejring. Den kan ikke uploade filer eller slette et projekt. Den kan ikke tilslutte eller frakoble en Shopify- eller WooCommerce-butik eller læse butikkens legitimationsoplysninger. Den får heller aldrig adgang til databasen, API-nøgler, webhook-hemmeligheder eller adgangskoder til delte visninger: værktøjer returnerer kuraterede resuméer, ikke rå poster.

Scopes: Giv hver forbindelse kun det, den har brug for

En forbindelse kan kun se og kalde de værktøjer, som dens scopes dækker. Start med skrivebeskyttet adgang, og tilføj ét skrivescope ad gangen, efterhånden som opgaven kræver det.

Simplio3D MCP-forbindelsesomfang
OmfangHvad det giver adgang tilGiv det, når agenten skal
Arbejdsområde (læse)Dit arbejdsområde, abonnement og oversigt over forbrugFortæl dig, hvilket abonnement du har, og hvor meget af det du bruger
Projekter (læse / skrive)Vis og gennemse projekter; opret, omdøb, dupliker og ændr sikre indstillingerRapportér om dine projekter, eller opret nye
Aktiver (læse)Vis aktiver, og gennemse en models delnavne og hierarkiTal om maskerne i dine modeller
Materialer (læse / skrive)Læs biblioteket; opret og rediger materialer, og tildel dem til varianterOpbyg eller ryd op i dit materialebibliotek
Konfigurator (læse / skrive)Læs og opret indstillingsblokke, varianter og betingede reglerOpbyg eller omstrukturér de muligheder, kunderne ser
Prissætning (læse / skrive)Læs priser og formler; foreslå ændringer i prissætning, SKU'er og formlerArbejd med prissætning. Hver prisændring er et forslag, du godkender.
Formularer (læs / skriv)Læs og opret felter i tilbuds- og betalingsformularerOpret eller tilpas din leadformular
Tilbud (læs)Indsendte tilbudsanmodninger, herunder kundeoplysningerOpsummer indgående leads. Dette er kundedata, så giv adgang med omtanke.
Handel (læs / skriv)Om en butik er forbundet, dens produkter og forslag til at knytte et produkt eller indstille checkout-tilstandKnyt et projekt til et butiksprodukt. Det giver aldrig adgang til butikkens legitimationsoplysninger.
Workflows (læse/skrive)Følg agent-workflows; start dem, besvar deres spørgsmål, sæt dem på pause eller annullér demKør eller overvåg en længerevarende opgave, f.eks. en projektrevision
Dokumentation (læse)Den officielle dokumentation for Simplio3D uden arbejdsområdedataBesvar produktspørgsmål med en kilde

Flere små forbindelser er sikrere end én, der kan gøre alt. Giv assistenten, der gennemgår prissætning, sin egen forbindelse med læsescopes plus skrivescope til prissætning, og giv den, der opbygger projekter, en anden. Når du tilbagekalder den ene, afbryder det derfor aldrig den anden.

Sådan forbliver ændringer under din kontrol

At lade en AI redigere en aktiv konfigurator fungerer kun, hvis en dårlig redigering ikke kan nå dine kunder. Simplio3D håndterer hver skrivning i tre trin: foreslå, bekræft, snapshot.

  • Redigeringer med lav risiko gennemføres uden at vente på dig, såsom at omdøbe en blok eller tilføje en variant.
  • Ændringer med høj risiko resulterer altid kun i et forslag: prissætning, SKU'er, sletninger, masseredigeringer, delte materialer og produktlinks til butikker. Forslaget afventer under Ventende AI-ændringer på siden AI-forbindelser og viser alle de ændringer, det vil foretage. Du trykker på Anvend eller afviser det. Ingen agent kan godkende sit eget forslag, og reglen kan ikke slås fra.
  • Hver anvendt ændring gemmes som et snapshot, så den kan fortrydes, derefter valideres igen og registreres i en revisionslog.

Forslag har kort levetid. Hvis projektet er ændret, siden agenten foreslog noget, afvises det gamle forslag i stedet for at overskrive dine nyere redigeringer; bed agenten om det igen.

Derudover lykkes et værktøjskald kun, når alle fire kontroller består: kontoens e-mailadresse er bekræftet, arbejdsområdets ejers abonnement er aktivt, sædets rolle tillader handlingen, og forbindelsen har scopet. Den mest begrænsende regel gælder. Et Viewer-sæde kan for eksempel aldrig foretage eller bekræfte en ændring, uanset hvilke scopes forbindelsen har.

Sådan opsætter du MCP-connectors til Simplio3D

Tokenruten fungerer i alle klienter. Bruger du Claude? OAuth-ruten nedenfor springer tokenet over.

  1. Åbn AI-forbindelser

    Gå til Dashboard → Integrations → AI Connections i Simplio3D, og kopiér MCP-endpointet, der vises øverst på siden.

  2. Opret én forbindelse pr. værktøj

    Klik på Create connection, og giv forbindelsen navn efter det værktøj, der skal bruge den, f.eks. “Claude Desktop” eller “Cursor”. Én forbindelse pr. værktøj gør det tydeligt, hvilken du senere skal tilbagekalde.

  3. Vælg arbejdsområdet

    En forbindelse er permanent knyttet til det arbejdsområde, du vælger her. Hvis du vil arbejde på tværs af to arbejdsområder, skal du oprette en forbindelse fra hvert af dem.

  4. Markér kun de scopes, den har brug for

    Start med skrivebeskyttet adgang, og tilføj skrivescopes ét ad gangen. Giv kun adgang til Quotes, når agenten skal kunne se kundeoplysninger.

  5. Kopiér tokenet, og tilføj det til dit værktøj

    Tokenet starter med smcp_ og vises kun én gang, aldrig igen. Indsæt det i dit AI-værktøj sammen med endpointet som vist i tabellen nedenfor. Behandl det som en adgangskode: Det er gyldigt i 90 dage, og du kan rotere eller tilbagekalde det når som helst.

  6. Kontrollér forbindelsen

    Spørg om noget, som kun din konto kan besvare: “Vis mine Simplio3D-projekter, og fortæl mig, hvilke der er publiceret.” Hvis svaret nævner dine rigtige projekter, fungerer connectoren.

Tilslut Claude uden en token. Simplio3D er angivet i Claudes connector-katalog. I Claude skal du åbne Tilpas → Connectors, søge efter Simplio3D og klikke på Tilslut, eller vælge Tilføj brugerdefineret connector og indsætte https://app.simplio3d.ai/mcp. Uanset hvad åbner Claude Simplio3D’s login og en samtykkeskærm, hvor du vælger arbejdsområdet og omfangene, med skrivebeskyttet adgang afkrydset for dig. Forbindelsen vises derefter på den samme liste over AI-forbindelser, markeret OAuth-app, og du kan rotere eller tilbagekalde den der ligesom enhver anden.

Hvor hver AI-klient tilføjer Simplio3D-connectoren
AI-klientHvor den tilføjesHvad der skal tilføjes
Claude (OAuth)Tilpas → Connectors: Søg efter Simplio3D, eller Tilføj brugerdefineret connectorIntet fra biblioteket; slutpunkts-URL'en til en brugerdefineret connector. Intet token: Du godkender i stedet samtykkeskærmen for Simplio3D.
Claude DesktopIndstillinger → Udvikler → Rediger konfiguration (claude_desktop_config.json)En “simplio3d”-server af typen http med endpoint-URL'en og en Authorization: Bearer smcp_…-header
Claude CodeDin terminalclaude mcp add --transport http simplio3d https://app.simplio3d.ai/mcp --header "Authorization: Bearer smcp_…"
Cursor~/.cursor/mcp.json eller .cursor/mcp.json for ét projektEn “simplio3d”-server med endpoint-URL'en og Authorization-headeren
VS Code (GitHub Copilot).vscode/mcp.jsonEn HTTP-server med endpoint-URL'en, som læser tokenet fra en adgangskodeprompt i stedet for at gemme det i filen
ChatGPT og CodexChatGPT → Plugins: Søg efter Simplio3D, installér derefter plugin'et, og forbind Simplio3DIntet: plugin'et indeholder connectoren. Intet token: Du logger ind på Simplio3D og godkender adgangen

Prompter, du kan prøve først

Angiv projektets navn, og bed om dokumentation: ”hvilken regel skjuler den?” giver et mere præcist svar end ”hvorfor er den skjult?”.

Eksempelprompter til en Simplio3D MCP-forbindelse
SpørgHvad agenten kontrollererHvad du får tilbage
“Gennemgå min Oak Dining Table-konfigurator, og angiv alt, der ikke fungerer.”Finder projektet og validerer det derefter, herunder delnavnene i 3D-modellenFund efter alvorlighedsgrad: manglende delmål, slettede materialer, regler, der aldrig kan udløses, og varianter uden pris
"Hvorfor er valnøddefinishen skjult, når jeg vælger den lille bordplade?"Den gennemgår indstillingsblokke og betingede regler og evaluerer dem derefterReglen, der skjuler den, og betingelsen, der blev opfyldt
"Har alle varianter i denne konfigurator en pris?"Prisblokke efterfulgt af en valideringskontrolDe varianter uden pris angivet ved navn samt den prisblok, de hver især tilhører
"Hvilke indstillinger er målrettet dele, der ikke længere findes i modellen?"De mål, du har oprettet ud fra den faktiske geometriDe forældede mål på listen
“Hvad vil eg i den store størrelse koste?”Valgblokke efterfulgt af en prisberegning på serversidenGrundpris, hver justering, moms og totalbeløbet i projektets valuta
“Opsummer de tilbudsforespørgsler, vi har modtaget i denne uge.”Tilbudsforespørgslerne og hver konfigurationKontaktoplysninger, hvad hver kunde konfigurerede, og prisen på det pågældende tidspunkt

Begrænsninger, der er værd at kende, før du stoler på det

  • Agenter læser gemte data. Editoren gemmer automatisk få sekunder efter hver ændring, så en redigering foretaget for et øjeblik siden muligvis endnu ikke er synlig. Gem, og spørg derefter igen.
  • Priser og logik på serversiden har forbehold. Prisberegningen og regelevurderingen dækker de almindelige tilfælde, men ikke enhver adfærd i den offentliggjorte konfigurator, såsom prissætning pr. enhed for Number Input. Hvert resultat angiver, hvad det ikke har evalueret, og Preview samt den offentliggjorte delingsvisning er fortsat afgørende.
  • Hastighedsgrænser. Hver forbindelse kan foretage 300 anmodninger hvert femte minut. Et workspace accepterer 30 anvendte AI-ændringer hvert tiende minut, delt mellem alle tilsluttede agenter og den indbyggede assistent.
  • Store svar afkortes og angiver det. Et resultat på over cirka 60 KB opsummeres og markeres som afkortet, så agenten ikke kan forveksle en del af en liste med hele listen.
  • Det, agenten læser, sendes til din AI-udbyder. Tilbudsanmodninger indeholder kundenavne og kontaktoplysninger, så tildel Quotes-omfanget med omtanke.
  • Tokens udløber efter 90 dage. Rotér straks et token, hvis det er blevet indsat i en chat, en supporthenvendelse eller en skærmdeling. Rotation stopper det gamle token med det samme.

Ét værktøjslag bag enhver AI-flade

MCP-serveren er ikke et separat produkt, der er monteret bagefter. Simplio3D’s indbyggede AI-assistent, det autentificerede REST-værktøjsendepunkt til dine egne automatiseringer og eksterne MCP-klienter kalder alle det samme værktøjsregister, bag den samme autentificering, de samme tilladelser og den samme auditlog. En funktion opfører sig på samme måde, uanset hvorfra du kalder den, og et omfang eller en rolle, der blokerer den ét sted, blokerer den overalt.

Det er også sådan, MCP adskiller sig fra REST API og SDK. SDK er en typebestemt klient til din egen kode, autentificeret med en API-nøgle, og den nøgle accepteres aldrig på MCP-endepunktet. MCP er til AI-agenter, autentificeret med en forbindelse, som du afgrænser pr. værktøj.

Spørgsmål om MCP-forbindelser

Alle: Starter, Pro og Enterprise samt den 30-dages Pro-prøveperiode, som alle konti starter med. MCP-connectors har været inkluderet i Starter siden september 2026. På Starter følger en tilsluttet agent de samme abonnementsregler som dashboardet og kan derfor ikke oprette modulære projekter eller duplikere et projekt.

Bygger du konfiguratoren først?

Sådan går et projekt fra en 3D-model til valgmuligheder, betinget logik og prisfastsættelse, før en agent overhovedet læser det.

Vil du have agenten til at kontrollere dine priser?

Prisblokkene og formelredigeringsværktøjet, som en tilsluttet agent læser og beregner ud fra.

Vil du også have AI til at udarbejde konfiguratoren?

Generér med AI muligheder, regler, pris og formular ud fra en produktbeskrivelse direkte i Simplio3D.

Bruger du ChatGPT?

Plugin'et Simplio3D i ChatGPTs Plugins-bibliotek opretter denne forbindelse for dig med en guidet loginproces i stedet for et token.

Fra bloggen

Guides, vejledninger og nyheder fra Simplio3D-teamet.

Byg, implementer og skaler 3D-handel.

Ejer en 3D-produktkonfigurator for at øge salget og generere tilbud direkte fra dit websted

Relaterede artikler