Hopp til innhold
Tilbake til bloggen
mcpaiintegrationstutorial

Produktkonfigurator-MCP: Koble Claude, Cursor og VS Code til Simplio3D

Simplio3D·
Produktkonfigurator-MCP: Koble Claude, Cursor og VS Code til Simplio3D

Spør en AI-assistent om produktkonfiguratoren din i dag, og den svarer ut fra det du limer inn i chatten: et skjermbilde, en liste med alternativer, en pris du har skrevet inn. MCP-koblinger fjerner dette steget. En kobling gir assistenten en direkte, tilgangsstyrt forbindelse til kontoen din hos Simplio3D, slik at den leser det faktiske prosjektet (alternativblokker, betingede regler, prisformelen, navnene på deler i 3D-modellen) og svarer ut fra dette.

Denne veiledningen forklarer hva en MCP-kobling er, hva en tilkoblet agent kan og ikke kan gjøre i Simplio3D, hvordan risikofylte endringer forblir under din kontroll, og hvordan du kobler til Claude, Cursor eller VS Code.

Hva er MCP-koblinger?

Model Context Protocol (MCP) er en åpen standard for å koble AI-assistenter til eksterne verktøy og data. Den har to sider. En MCP-klient er AI-verktøyet du allerede bruker, for eksempel Claude, Cursor eller VS Code. En MCP-server er systemet assistenten kobler seg til: den publiserer en liste over verktøy, hvert med en beskrivelse og et skjema, som assistenten kan kalle når et spørsmål krever det.

En kobling er lenken mellom de to: serverens adresse, pluss en legitimasjon som angir hvem som kobler seg til og hva de har tilgang til. Claude kaller det en egendefinert kobling; andre klienter kaller det en MCP-serveroppføring. For Simplio3D er det alltid de samme to tingene:

  • Endepunktet: https://app.simplio3d.ai/mcp
  • En legitimasjon: en OAuth-pålogging som du godkjenner på en samtykkeskjerm hos Simplio3D, eller et tilkoblingstoken du oppretter under Dashboard → Integrasjoner → AI-tilkoblinger.

Når forbindelsen er opprettet, ser assistenten verktøyene til Simplio3D sammen med sine egne og avgjør når de skal brukes, basert på det du spør om.

Diagram: Claude, Cursor og VS Code kobler til Simplio3D MCP-serveren på app.simplio3d.ai/mcp. Hvert kall går gjennom fire kontroller (verifisert konto, aktiv plan eller prøveperiode, arbeidsområderolle, tilkoblingsomfang) før det når 123 verktøy (52 lese-, 68 skrive- og 3 arbeidsflytverktøy) og prosjektene i ett arbeidsområde. Endringer med høy risiko blir et forslag som venter under Ventende AI-endringer til du trykker på Bruk, og deretter tas det et øyeblikksbilde.
Alle AI-klienter går gjennom det samme endepunktet og de samme fire kontrollene. En endring med høy risiko stoppes som et forslag til du bruker den i dashbordet.

Dette kan en tilkoblet agent gjøre i Simplio3D

Simplio3D MCP-serveren tilbyr 123 verktøy: 52 som leser, 68 som skriver innenfor en kontrollert skrivemodell, og 3 som kjører agentarbeidsflyter. Til sammen dekker de prosjekter, inspeksjon av 3D-modeller, materialer, alternativblokker, betinget logikk, prising, skjemaer, tilbudsforespørsler og butikktilkoblinger. I praksis kan en tilkoblet agent:

  • Lese et faktisk prosjekt: modellene, alternativblokkene og variantene, materialene, de betingede reglene, prisblokkene og formelen samt skjemafeltene.
  • Se inn i 3D-modellen: delenavn og hierarki, slik at den kan kontrollere at hvert alternativ fortsatt retter seg mot et eksisterende mesh.
  • Revidere en konfigurator: manglende delmål, slettede materialer, regler som aldri kan utløses, og varianter uten pris.
  • Forklare logikk og beregne prisen på en konfigurasjon: hvilken regel som skjuler et alternativ, og hva et bestemt utvalg koster, beregnet på serveren.
  • Bygge og redigere: opprette prosjekter, alternativblokker, varianter, materialer, betingede regler og skjemafelt, samt rydde opp i det som allerede finnes.
  • Kjøre agentarbeidsflyter: starte en jobb med flere trinn, for eksempel en prosjektrevisjon eller en sikker reparasjon, besvare spørsmålene og følge fremdriften. Arbeidsflyter stopper for godkjenning og publiserer aldri.
  • Oppsummere kundeemner: lese tilbudsforespørslene du har mottatt og hva hver kunde har konfigurert.
  • Svare på produktspørsmål basert på dokumentasjonen: søke i den offisielle dokumentasjonen for Simplio3D og vise til siden, i stedet for å svare fra hukommelsen.

Alle verktøyene, med nødvendig omfang og informasjon om de leser eller skriver, er oppført i referansen for MCP-verktøy.

Dette kan den ikke gjøre

Enkelte handlinger forblir utilgjengelige uansett hvilke omfang du gir. En tilkoblet agent kan ikke publisere et prosjekt, opprette en delingslenke eller endre innbyggingsinnstillinger. Den kan ikke laste opp filer eller slette et prosjekt. Den kan ikke koble til eller fra en Shopify- eller WooCommerce-butikk, eller lese denne butikkens påloggingsopplysninger. Den får heller aldri tilgang til databasen, API-nøkler, webhook-hemmeligheter eller passord for delt visning: verktøyene returnerer utvalgte sammendrag, ikke rå poster.

Omfang: gi hver tilkobling bare det den trenger

En tilkobling kan bare se og bruke verktøyene som omfattes av tillatelsene. Start med skrivebeskyttet tilgang, og legg til ett skriveomfang om gangen etter behov.

Simplio3D MCP-tilkoblingsomfang
OmfangHva det tillaterGi det når agenten skal
Arbeidsområde (les)Sammendrag av arbeidsområdet, abonnementet og bruken dinForteller deg hvilket abonnement du har og hvor mye av det du bruker
Prosjekter (lese / skrive)List opp og undersøk prosjekter; opprett, gi nytt navn, dupliser og endre sikre innstillingerRapporter om prosjektene dine, eller opprett nye
Ressurser (lese)List opp ressurser og undersøk en modells delnavn og hierarkiSnakk om nettene i modellene dine
Materialer (lese / skrive)Les biblioteket, opprett og rediger materialer, og tildel dem til varianterBygg eller rydd opp i materialbiblioteket ditt
Konfigurator (lese / skrive)Les og opprett alternativblokker, varianter og betingede reglerBygg eller omstrukturer alternativene kundene ser
Prissetting (lese / skrive)Les priser og formler; foreslå endringer i prissetting, SKU og formlerArbeid med prissetting. Hver endring i prissettingen er et forslag du godkjenner.
Skjemaer (les / skriv)Les og opprett felt i tilbuds- og utsjekkingsskjemaerOpprett eller juster leadskjemaet ditt
Tilbud (les)Innsendte tilbudsforespørsler, inkludert kundeopplysningerOppsummer innkommende leads. Dette er kundedata, så gi tilgang med omtanke.
Handel (les / skriv)Om en butikk er koblet til, produktene dens og forslag til å koble et produkt eller angi utsjekkingsmodusKoble et prosjekt til et butikkprodukt. Det gir aldri tilgang til butikkens påloggingsopplysninger.
Arbeidsflyter (les / skriv)Følg agentarbeidsflyter, start dem, svar på spørsmålene deres, sett dem på pause eller avbryt demKjør eller overvåk en lengre jobb, for eksempel en prosjektrevisjon
Dokumentasjon (les)Den offisielle dokumentasjonen for Simplio3D, uten arbeidsområdedataSvar på produktspørsmål med en kilde

Flere små tilkoblinger er tryggere enn én som kan gjøre alt. Gi assistenten som gjennomgår priser, sin egen tilkobling med lesetillatelser og skrivetilgang til priser, og gi en annen tilkobling til den som bygger prosjekter. Da vil tilbakekalling av én aldri avbryte den andre.

Slik forblir endringer under din kontroll

Å la en AI redigere en aktiv konfigurator fungerer bare hvis en feilaktig redigering ikke kan nå kundene dine. Simplio3D håndterer hver skrivehandling i tre steg: foreslå, bekreft, ta øyeblikksbilde.

  • Endringer med lav risiko gjennomføres uten å vente på deg, for eksempel å gi nytt navn til en blokk eller legge til en variant.
  • Endringer med høy risiko resulterer alltid bare i et forslag: priser, SKU-er, slettinger, masseendringer, delte materialer og produktkoblinger til butikker. Forslaget venter under Ventende AI-endringer på siden for AI-tilkoblinger og viser alle endringene det vil gjøre. Du trykker Bruk eller avviser det. Ingen agent kan godkjenne sitt eget forslag, og regelen kan ikke slås av.
  • Hver endring som tas i bruk, får et øyeblikksbilde, slik at den kan angres, deretter valideres på nytt og registreres i en revisjonslogg.

Forslag har kort levetid. Hvis prosjektet har endret seg siden agenten foreslo noe, avvises det gamle forslaget i stedet for å overskrive nyere endringer; be agenten på nytt.

I tillegg lykkes et verktøykall bare når alle fire kontrollene er bestått: kontoens e-postadresse er bekreftet, arbeidsområdeeierens abonnement er aktivt, setets rolle tillater handlingen, og tilkoblingen har riktig omfang. Den mest begrensede tillatelsen gjelder. Et Viewer-sete kan for eksempel aldri utføre eller bekrefte en endring, uansett hvilke omfang tilkoblingen har.

Slik setter du opp MCP-koblinger for Simplio3D

Tokenruten fungerer i alle klienter. Bruker du Claude? OAuth-ruten nedenfor lar deg slippe tokenet.

  1. Åpne AI-tilkoblinger

    I Simplio3D går du til Kontrollpanel → Integrasjoner → AI-tilkoblinger og kopierer MCP-endepunktet som vises øverst på siden.

  2. Opprett én tilkobling per verktøy

    Klikk på Opprett tilkobling og gi den navn etter verktøyet som skal bruke den, for eksempel «Claude Desktop» eller «Cursor». Én tilkobling per verktøy gjør det tydelig hvilken du skal tilbakekalle senere.

  3. Velg arbeidsområdet

    En tilkobling er permanent knyttet til arbeidsområdet du velger her. For å jobbe på tvers av to arbeidsområder må du opprette en tilkobling fra hvert av dem.

  4. Kryss av kun for tilgangsområdene det trenger

    Start med skrivebeskyttet tilgang, og legg til skrivetilganger én om gangen. Gi tilgang til Tilbud kun når agenten skal se kundeopplysninger.

  5. Kopier tokenet og legg det til i verktøyet ditt

    Tokenet starter med smcp_ og vises én gang, aldri igjen. Lim det inn i AI-verktøyet ditt sammen med endepunktet, slik det vises i tabellen nedenfor. Behandle det som et passord: det varer i 90 dager, og du kan rotere eller tilbakekalle det når som helst.

  6. Kontroller tilkoblingen

    Spør om noe bare kontoen din kan svare på: «List opp mine Simplio3D-prosjekter og fortell meg hvilke som er publisert.» Hvis svaret nevner de faktiske prosjektene dine, fungerer koblingen.

Koble til Claude uten token. Simplio3D er oppført i Claudes katalog over koblinger. I Claude åpner du Tilpass → Koblinger, søker etter Simplio3D og klikker på Koble til, eller velger Legg til egendefinert kobling og limer inn https://app.simplio3d.ai/mcp. Uansett åpner Claude innloggingssiden til Simplio3D og et samtykkeskjermbilde der du velger arbeidsområde og omfang, med skrivebeskyttet tilgang allerede valgt. Tilkoblingen vises deretter i den samme listen over AI-tilkoblinger, merket OAuth-app, og du kan rotere eller tilbakekalle den der på samme måte som alle andre.

Hvor hver AI-klient legger til Simplio3D-koblingen
KI-klientHvor du legger den tilHva du skal legge til
Claude (OAuth)Tilpass → Koblinger: søk etter Simplio3D, eller Legg til egendefinert koblingIngenting fra katalogen; endepunkt-URL-en for en egendefinert kobling. Ingen token: du godkjenner i stedet samtykkeskjermen for Simplio3D.
Claude DesktopInnstillinger → Utvikler → Rediger konfigurasjon (claude_desktop_config.json)En «simplio3d»-server av typen http, med endepunkt-URL-en og en Authorization: Bearer smcp_…-header
Claude CodeTerminalen dinclaude mcp add --transport http simplio3d https://app.simplio3d.ai/mcp --header "Authorization: Bearer smcp_…"
Cursor~/.cursor/mcp.json, eller .cursor/mcp.json for ett prosjektEn «simplio3d»-server med endepunkt-URL-en og Authorization-headeren
VS Code (GitHub Copilot).vscode/mcp.jsonEn http-server med endepunktets URL, som leser tokenet fra en passordforespørsel i stedet for å lagre det i filen
ChatGPT og CodexChatGPT → Plugins: Søk etter Simplio3D, og installer deretter plugin-en og koble til Simplio3DIngenting: plugin-en inkluderer koblingen. Ingen token: Du logger på Simplio3D og godkjenner tilgangen

Ledetekster du kan prøve først

Oppgi navnet på prosjektet, og be om dokumentasjon: «hvilken regel skjuler det?» gir et mer presist svar enn «hvorfor er det skjult?».

Eksempelmeldinger for en Simplio3D MCP-kobling
SpørDette kontrollerer agentenDette får du tilbake
«Revider Oak Dining Table-konfiguratoren min og list opp alt som er ødelagt.»Finner prosjektet og validerer det deretter, inkludert delnavnene i 3D-modellenFunn etter alvorlighetsgrad: manglende måldeler, slettede materialer, regler som aldri kan utløses, varianter uten pris
«Hvorfor er overflaten Valnøtt skjult når jeg velger den lille toppen?»Alternativblokkene og de betingede reglene, deretter evalueres deRegelen som skjuler den, og betingelsen som ble oppfylt
«Har alle varianter i denne konfiguratoren en pris?»Prisblokkene, deretter en valideringskontrollVariantene uten pris etter navn, med prisblokken de tilhører
«Hvilke alternativer retter seg mot deler som ikke lenger finnes i modellen?»Målene du opprettet basert på den faktiske geometrienDe utdaterte målene, listet opp
«Hva vil eik i stor størrelse koste?»Alternativblokkene, etterfulgt av en prisberegning på serversidenGrunnpris, hver justering, avgift og totalbeløp i prosjektets valuta
«Oppsummer pristilbudsforspørslene vi mottok denne uken.»Pristilbudsforspørslene og hver konfigurasjonKontaktopplysninger, hva hver kunde konfigurerte og prisen på det aktuelle tidspunktet

Begrensninger det er verdt å kjenne til før du stoler på den

  • Agenter leser lagrede data. Redigeringsverktøyet lagrer automatisk noen sekunder etter hver endring, så en redigering som ble gjort for et øyeblikk siden, er kanskje ikke synlig ennå. Lagre, og spør deretter på nytt.
  • Priser og logikk på serversiden har forbehold. Prisberegningen og regelvurderingen dekker de vanlige tilfellene, men ikke all atferd i den publiserte konfiguratoren, for eksempel prising per enhet for Number Input. Hvert resultat viser hva det ikke vurderte, og forhåndsvisningen og den publiserte delingsvisningen er fortsatt fasiten.
  • Hastighetsbegrensninger. Hver tilkobling kan gjøre 300 forespørsler hvert femte minutt. Et arbeidsområde godtar 30 anvendte AI-endringer hvert tiende minutt, delt mellom alle tilkoblede agenter og den innebygde assistenten.
  • Store svar avkortes, og dette opplyses. Et resultat på over omtrent 60 KB oppsummeres og merkes som avkortet, slik at agenten ikke kan forveksle deler av en liste med hele listen.
  • Det agenten leser, sendes til AI-leverandøren din. Forespørsler om tilbud inneholder kundenavn og kontaktopplysninger, så gi Quotes-omfanget med omhu.
  • Tokener utløper etter 90 dager. Bytt ut en umiddelbart hvis den har blitt limt inn i en chat, supportsak eller skjermdeling. Utskifting stopper den gamle tokenen med én gang.

Ett verktøylag bak alle AI-flater

MCP-serveren er ikke et separat produkt som er lagt på i etterkant. Simplio3D’s innebygde AI-assistent, det autentiserte REST-verktøyendepunktet for dine egne automatiseringer og eksterne MCP-klienter bruker alle det samme verktøyregisteret, bak den samme autentiseringen, de samme tillatelsene og revisjonsloggen. En funksjon oppfører seg på samme måte uansett hvorfra du kaller den, og et omfang eller en rolle som blokkerer den ett sted, blokkerer den overalt.

Dette er også hvordan MCP skiller seg fra REST API og SDK. SDK er en typet klient for din egen kode, autentisert med en API-nøkkel, og den nøkkelen aksepteres aldri på MCP-endepunktet. MCP er for AI-agenter, autentisert med en tilkobling som du avgrenser per verktøy.

Spørsmål om MCP-koblinger

Alle: Starter, Pro og Enterprise, samt den 30-dagers Pro-prøveperioden som hver konto starter med. MCP-koblinger har vært inkludert i Starter siden september 2026. På Starter følger en tilkoblet agent de samme planreglene som dashbordet, så den kan ikke opprette modulære prosjekter eller duplisere et prosjekt.

Bygger du konfiguratoren først?

Hvordan et prosjekt går fra en 3D-modell til alternativer, betinget logikk og prissetting, før en agent i det hele tatt leser det.

Vil du at agenten skal kontrollere prisene dine?

Prisblokkene og formelredigereren som en tilkoblet agent leser og beregner ut fra.

Vil du at AI også skal utforme konfiguratoren?

Generer alternativer, regler, pris og skjema med AI ut fra en produktbeskrivelse i Simplio3D.

Bruker du ChatGPT?

Plugin-en Simplio3D i ChatGPTs plugin-katalog oppretter denne tilkoblingen for deg, med veiledet pålogging i stedet for et token.

Fra bloggen

Guider, veiledninger og nyheter fra Simplio3D-teamet.

Bygg, distribuer og skaler 3D-handel.

Eie en 3D produktkonfigurator for å øke salget og generere tilbud direkte fra nettstedet ditt.

Relaterte artikler