Hoppa till innehåll
Tillbaka till bloggen
mcpaiintegrationstutorial

Produktkonfigurator MCP: Anslut Claude, Cursor och VS Code till Simplio3D

Simplio3D·
Produktkonfigurator MCP: Anslut Claude, Cursor och VS Code till Simplio3D

Fråga en AI-assistent om din produktkonfigurator i dag, så svarar den utifrån det du klistrar in i chatten: en skärmbild, en lista med alternativ eller ett pris du har skrivit in. MCP-kopplingar tar bort det steget. En koppling ger assistenten en direkt, behörighetsstyrd anslutning till ditt Simplio3D-konto, så att den läser det faktiska projektet (alternativblocken, de villkorade reglerna, prissättningsformeln och delnamnen i 3D-modellen) och svarar utifrån det.

Den här guiden förklarar vad en MCP-koppling är, vad en ansluten agent kan och inte kan göra i Simplio3D, hur riskfyllda ändringar förblir under din kontroll och hur du ansluter Claude, Cursor eller VS Code.

Vad är MCP-kopplingar?

Model Context Protocol (MCP) är en öppen standard för att ansluta AI-assistenter till externa verktyg och data. Den har två sidor. En MCP-klient är AI-verktyget du redan använder, till exempel Claude, Cursor eller VS Code. En MCP-server är systemet som assistenten ansluter till: den publicerar en lista med verktyg, vart och ett med en beskrivning och ett schema, som assistenten kan anropa när en fråga kräver det.

En koppling är länken mellan de två: serverns adress plus en autentiseringsuppgift som anger vem som ansluter och vad de får använda. Claude kallar det en anpassad koppling; andra klienter kallar det en MCP-serverpost. För Simplio3D är det alltid samma två saker:

  • Slutpunkten: https://app.simplio3d.ai/mcp
  • En autentiseringsuppgift: en OAuth-inloggning som du godkänner på en samtyckesskärm för Simplio3D, eller en anslutningstoken som du skapar under Dashboard → Integrations → AI Connections.

När anslutningen är klar ser assistenten verktygen från Simplio3D tillsammans med sina egna och avgör när de ska anropas utifrån det du frågar.

Diagram: Claude, Cursor och VS Code ansluter till Simplio3D MCP-servern på app.simplio3d.ai/mcp. Varje anrop passerar fyra kontroller (verifierat konto, aktiv plan eller provperiod, arbetsyteroll, anslutningsomfattningar) innan det når 123 verktyg (52 läs-, 68 skriv- och 3 arbetsflödesverktyg) samt en arbetsytas projekt. Ändringar med hög risk blir ett förslag som väntar under Väntande AI-ändringar tills du trycker på Verkställ, och sedan tas en ögonblicksbild.
Varje AI-klient går via samma slutpunkt och samma fyra kontroller. En ändring med hög risk stoppas som ett förslag tills du verkställer den i instrumentpanelen.

Vad en ansluten agent kan göra i Simplio3D

Simplio3D MCP-servern erbjuder 123 verktyg: 52 som läser, 68 som skriver enligt en kontrollerad skrivmodell och 3 som kör agentarbetsflöden. Tillsammans täcker de projekt, granskning av 3D-modeller, material, alternativblock, villkorsstyrd logik, prissättning, formulär, offertförfrågningar och butiksanslutningar. I praktiken kan en ansluten agent:

  • Läsa ett verkligt projekt: dess modeller, alternativblock och varianter, material, villkorsregler, prisblock och formler samt formulärfält.
  • Undersöka 3D-modellen: delnamn och hierarki, så att den kan kontrollera att varje alternativ fortfarande riktar sig mot en mesh som finns.
  • Granska en konfigurator: saknade delmål, borttagna material, regler som aldrig kan utlösas och varianter utan pris.
  • Förklara logik och prissätta en konfiguration: vilken regel som döljer ett alternativ och vad en viss uppsättning val kostar, beräknat på servern.
  • Bygga och redigera: skapa projekt, alternativblock, varianter, material, villkorsregler och formulärfält samt städa upp det som redan finns.
  • Köra agentarbetsflöden: starta ett jobb i flera steg, som en projektgranskning eller en säker reparation, besvara dess frågor och följa förloppet. Arbetsflöden pausas för ditt godkännande och publicerar aldrig.
  • Sammanfatta leads: läsa de offertförfrågningar du har fått och vad varje kund konfigurerade.
  • Besvara produktfrågor med hjälp av dokumentationen: söka i den officiella dokumentationen för Simplio3D och hänvisa till sidan, i stället för att svara utifrån minnet.

Alla verktyg, med de behörigheter de behöver och om de läser eller skriver, finns listade i referensen för MCP-verktyg.

Vad den inte kan göra

Vissa åtgärder förblir otillgängliga oavsett vilka behörigheter du ger. En ansluten agent kan inte publicera ett projekt, skapa en delningslänk eller ändra inbäddningsinställningar. Den kan inte ladda upp filer eller ta bort ett projekt. Den kan inte ansluta eller koppla från en Shopify- eller WooCommerce-butik, eller läsa den butikens inloggningsuppgifter. Den får heller aldrig databasåtkomst, API-nycklar, webhook-hemligheter eller lösenord för delade vyer: verktygen returnerar sammanställda sammanfattningar, inte råa poster.

Behörigheter: ge varje anslutning bara det den behöver

En anslutning kan bara se och anropa de verktyg som dess behörigheter omfattar. Börja med skrivskyddad åtkomst och lägg till en skrivbehörighet i taget när uppgiften kräver det.

Simplio3D MCP-anslutningsomfång
OmfångVad det tillåterBevilja det när agenten ska
Arbetsyta (läsning)Din arbetsyta, ditt abonnemang och din användningssammanfattningVisar vilket abonnemang du har och hur mycket av det du använder
Projekt (läsa/skriva)Lista och granska projekt; skapa, byt namn på, duplicera och ändra säkra inställningarRapportera om dina projekt eller skapa nya
Resurser (läsa)Lista resurser och granska en modells delnamn och hierarkiPrata om mesharna i dina modeller
Material (läsa / skriva)Läs biblioteket; skapa och redigera material och tilldela dem till varianterBygg upp eller organisera ditt materialbibliotek
Konfigurator (läsa / skriva)Läs och skapa alternativblock, varianter och villkorsreglerBygg eller strukturera om alternativen som kunderna ser
Prissättning (läsa / skriva)Läs priser och formler; föreslå ändringar av prissättning, SKU och formlerArbeta med prissättning. Varje prisuppgift är ett förslag som du godkänner.
Formulär (läsa / skriva)Läs och skapa fält för offert- och kassformulärSkapa eller justera ditt formulär för potentiella kunder
Offerter (läsa)Insända offertförfrågningar, inklusive kunduppgifterSammanfatta inkommande potentiella kunder. Detta är kunddata, så bevilja åtkomst med eftertanke.
Handel (läsa / skriva)Om en butik är ansluten, dess produkter och förslag om att länka en produkt eller ställa in kassalägetKoppla ett projekt till en butiksprodukt. Det ger aldrig åtkomst till butikens autentiseringsuppgifter.
Arbetsflöden (läsa / skriva)Följ agentarbetsflöden; starta dem, besvara deras frågor, pausa eller avbryt demKör eller övervaka ett längre jobb, till exempel en projektgranskning
Dokumentation (läsa)Den officiella dokumentationen för Simplio3D, utan arbetsyteuppgifterBesvara produktfrågor med en källa

Flera små anslutningar är säkrare än en som kan göra allt. Ge assistenten som granskar prissättning en egen anslutning med läsbehörigheter plus skrivbehörighet för prissättning, och ge assistenten som bygger projekt en annan. Om du återkallar den ena avbryts då aldrig den andra.

Så förblir ändringar under din kontroll

Att låta en AI redigera en aktiv konfigurator fungerar bara om en felaktig redigering inte kan nå dina kunder. Simplio3D hanterar varje skrivning i tre steg: föreslå, bekräfta, ögonblicksbild.

  • Ändringar med låg risk genomförs utan att vänta på dig, till exempel att byta namn på ett block eller lägga till en variant.
  • Ändringar med hög risk skapar alltid endast ett förslag: prissättning, SKU:er, borttagningar, massredigeringar, delade material och länkar till butiksprodukter. Förslaget väntar under Pending AI changes på sidan AI Connections och listar varje ändring som skulle göras. Du klickar på Apply eller avfärdar det. Ingen agent kan godkänna sitt eget förslag och regeln kan inte stängas av.
  • Varje tillämpad ändring får en ögonblicksbild, så att den kan ångras, sedan valideras på nytt och registreras i en granskningslogg.

Förslag gäller bara under en begränsad tid. Om projektet har ändrats sedan agenten lade fram ett förslag nekas det gamla förslaget i stället för att skriva över dina nyare ändringar; be agenten igen.

Dessutom lyckas ett verktygsanrop bara när fyra kontroller godkänns: kontots e-postadress är verifierad, arbetsytans ägares abonnemang är aktivt, användarens roll tillåter åtgärden och anslutningen har behörigheten. Den mest begränsade gäller. En användare med Viewer-roll kan till exempel aldrig göra eller bekräfta en ändring, oavsett vilka behörigheter anslutningen har.

Så konfigurerar du MCP-anslutningar för Simplio3D

Tokenvägen fungerar i alla klienter. Använder du Claude? OAuth-vägen nedan gör att du slipper token.

  1. Öppna AI-anslutningar

    I Simplio3D går du till Dashboard → Integrations → AI Connections och kopierar MCP-slutpunkten som visas högst upp på sidan.

  2. Skapa en anslutning per verktyg

    Klicka på Create connection och ge anslutningen namn efter verktyget som ska använda den, till exempel ”Claude Desktop” eller ”Cursor”. En anslutning per verktyg gör det tydligt vilken som ska återkallas senare.

  3. Välj arbetsyta

    En anslutning är permanent kopplad till den arbetsyta du väljer här. Om du vill arbeta i två arbetsytor skapar du en anslutning från var och en.

  4. Markera endast de behörigheter som behövs

    Börja med skrivskyddad åtkomst och lägg till skrivbehörigheter en i taget. Ge åtkomst till Quotes endast när agenten ska kunna se kunduppgifter.

  5. Kopiera token och lägg till den i ditt verktyg

    Token börjar med smcp_ och visas bara en gång, aldrig igen. Klistra in den i ditt AI-verktyg tillsammans med slutpunkten, enligt tabellen nedan. Behandla den som ett lösenord: den gäller i 90 dagar och du kan rotera eller återkalla den när som helst.

  6. Kontrollera anslutningen

    Fråga något som bara ditt konto kan besvara: ”Lista mina Simplio3D-projekt och berätta vilka som är publicerade.” Om svaret nämner dina faktiska projekt fungerar anslutningen.

Anslut Claude utan en token. Simplio3D finns med i Claudes katalog över anslutningar. I Claude öppnar du Anpassa → Anslutningar, söker efter Simplio3D och klickar på Anslut, eller väljer Lägg till anpassad anslutning och klistrar in https://app.simplio3d.ai/mcp. Oavsett vilket öppnar Claude Simplio3D’s inloggning och en samtyckesskärm där du väljer arbetsyta och behörigheter, med skrivskyddad åtkomst redan markerad. Anslutningen visas sedan i samma lista över AI-anslutningar, markerad som OAuth-app, och där kan du rotera eller återkalla den precis som vilken annan anslutning som helst.

Varje AI-klients plats för Simplio3D-anslutningen
AI-klientVar den ska läggas tillVad som ska läggas till
Claude (OAuth)Anpassa → Anslutningar: sök efter Simplio3D eller Lägg till anpassad anslutningInget från katalogen; slutpunkts-URL:en för en anpassad anslutning. Ingen token: du godkänner i stället samtyckesskärmen för Simplio3D.
Claude DesktopInställningar → Utvecklare → Redigera konfiguration (claude_desktop_config.json)En ”simplio3d”-server av typen http, med slutpunkts-URL:en och rubriken Authorization: Bearer smcp_…
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 för ett projektEn ”simplio3d”-server med slutpunkts-URL:en och Authorization-rubriken
VS Code (GitHub Copilot).vscode/mcp.jsonEn http-server med endpoint-URL:en som läser tokenen från en lösenordsfråga i stället för att lagra den i filen
ChatGPT och CodexChatGPT → Plugins: sök efter Simplio3D, installera sedan pluginet och anslut Simplio3DIngenting: pluginet innehåller anslutningen. Ingen token behövs: du loggar in på Simplio3D och godkänner åtkomsten

Prompter att prova först

Ange projektets namn och be om underlag: ”vilken regel döljer det?” ger ett mer träffsäkert svar än ”varför är det dolt?”.

Exempel på frågor för en Simplio3D MCP-koppling
FrågaVad agenten kontrollerarVad du får tillbaka
”Granska min konfigurator för Oak Dining Table och lista allt som är trasigt.”Hittar projektet och validerar det sedan, inklusive delnamnen i 3D-modellenResultat efter allvarlighetsgrad: saknade måldelar, borttagna material, regler som aldrig kan aktiveras, varianter utan pris
”Varför är valnötsfinishen dold när jag väljer den lilla toppen?”Alternativblocken och de villkorliga reglerna, och utvärderar sedan demRegeln som döljer den och villkoret som matchade
”Har varje variant i denna konfigurator ett pris?”Prisblocken, följt av en valideringskontrollDe prissatta varianterna efter namn, med det prisblock som var och en tillhör
”Vilka alternativ riktar sig mot delar som inte längre finns i modellen?”Målen du skapade utifrån den faktiska geometrinDe inaktuella målen, listade
”Vad skulle ek i den stora storleken kosta?”Alternativblocken, följt av en prisberäkning på serversidanGrundpris, varje justering, skatt och totalsumman i projektets valuta
”Sammanfatta de offertförfrågningar vi har fått den här veckan.”Offertförfrågningarna och varje konfigurationKontaktuppgifter, vad varje kund konfigurerade och priset vid tidpunkten

Begränsningar som är bra att känna till innan du förlitar dig på den

  • Agenter läser sparade data. Redigeraren sparar automatiskt några sekunder efter varje ändring, så en ändring som gjordes nyss kanske ännu inte syns. Spara och fråga sedan igen.
  • Priser och logik på serversidan har vissa begränsningar. Prisberäkningen och regelutvärderingen täcker de vanligaste fallen, men inte alla beteenden i den publicerade konfiguratorn, till exempel prissättning per enhet för Number Input. Varje resultat listar vad som inte utvärderades, och förhandsvisningen samt den publicerade delningsvyn är alltid avgörande.
  • Hastighetsbegränsningar. Varje anslutning kan göra 300 förfrågningar var femte minut. En arbetsyta tillåter 30 tillämpade AI-ändringar var tionde minut, delat mellan alla anslutna agenter och den inbyggda assistenten.
  • Stora svar beskärs och detta anges tydligt. Ett resultat på mer än cirka 60 KB sammanfattas och markeras som trunkerat, så att agenten inte kan missta en del av en lista för hela listan.
  • Det agenten läser skickas till din AI-leverantör. Offertförfrågningar innehåller kundnamn och kontaktuppgifter, så bevilja behörigheten Quotes med eftertanke.
  • Token upphör att gälla efter 90 dagar. Rotera en token omedelbart om den har klistrats in i en chatt, ett supportärende eller en skärmdelning. Rotation stoppar den gamla token direkt.

Ett gemensamt verktygslager bakom varje AI-gränssnitt

MCP-servern är inte en separat produkt som har lagts ovanpå. Simplio3D’s inbyggda AI-assistent, den autentiserade verktygsändpunkten REST för dina egna automatiseringar och externa MCP-klienter använder alla samma verktygsregister, bakom samma autentisering, behörigheter och granskningslogg. En funktion fungerar på samma sätt oavsett varifrån du anropar den, och en behörighet eller roll som blockerar den på ett ställe blockerar den överallt.

Det är också så MCP skiljer sig från REST API och SDK. SDK är en typad klient för din egen kod, autentiserad med en API-nyckel, och den nyckeln accepteras aldrig vid MCP-ändpunkten. MCP är avsett för AI-agenter och autentiseras med en anslutning där du begränsar behörigheten per verktyg.

Frågor om MCP-kopplingar

Alla: Starter, Pro och Enterprise samt den 30 dagar långa Pro-provperioden som varje konto börjar med. MCP-anslutningar har ingått i Starter sedan september 2026. På Starter följer en ansluten agent samma planregler som instrumentpanelen och kan därför inte skapa Modular-projekt eller duplicera ett projekt.

Ska du bygga konfiguratorn först?

Så går ett projekt från en 3D-modell till valmöjligheter, villkorslogik och prissättning, innan en agent ens läser det.

Vill du att agenten kontrollerar dina priser?

Prisblocken och formelredigeraren som en ansluten agent läser och beräknar utifrån.

Vill du att AI även ska skapa konfiguratorn?

Generera med AI alternativ, regler, pris och formulär utifrån en produktbeskrivning, direkt i Simplio3D.

Använder du ChatGPT?

Pluginet Simplio3D i ChatGPTs Plugins-katalog upprättar anslutningen åt dig, med guidad inloggning i stället för en token.

Från bloggen

Guider, handledningar och nyheter från Simplio3D-teamet.

Bygg, distribuera och skala 3D-handel.

Äg en 3D-produktkonfigurator för att driva försäljning och generera förslag direkt från din webbplats.

Relaterade artiklar