MCP konfiguratora produktów: połącz Claude, Cursor i VS Code z Simplio3D

Zapytaj dziś asystenta AI o swój konfigurator produktu, a odpowie na podstawie tego, co wkleisz do czatu: zrzutu ekranu, listy opcji, wpisanej ceny. Złącza MCP eliminują ten krok. Złącze zapewnia asystentowi bezpośredni dostęp z odpowiednimi uprawnieniami do Twojego konta Simplio3D, dzięki czemu odczytuje rzeczywisty projekt (bloki opcji, reguły warunkowe, formułę cenową, nazwy części w modelu 3D) i na tej podstawie udziela odpowiedzi.

Ten przewodnik wyjaśnia, czym jest złącze MCP, co połączony agent może, a czego nie może zrobić w Simplio3D, jak ryzykowne zmiany pozostają pod Twoją kontrolą oraz jak połączyć Claude, Cursor lub VS Code.

Czym są złącza MCP?

Model Context Protocol (MCP) to otwarty standard łączenia asystentów AI z zewnętrznymi narzędziami i danymi. Składa się z dwóch stron. Klient MCP to narzędzie AI, którego już używasz, na przykład Claude, Cursor lub VS Code. Serwer MCP to system, z którym łączy się asystent: udostępnia listę narzędzi, każde z opisem i schematem, które asystent może wywołać, gdy wymaga tego pytanie.

Złącze jest łączem między nimi: adresem serwera oraz poświadczeniem określającym, kto się łączy i do czego ma dostęp. Claude nazywa je niestandardowym złączem; inne klienty określają je jako wpis serwera MCP. W przypadku Simplio3D zawsze chodzi o te same dwie rzeczy:

• Endpoint: https://app.simplio3d.ai/mcp
• Poświadczenie: logowanie OAuth zatwierdzane na ekranie zgody Simplio3D lub token połączenia utworzony w Panel → Integracje → Połączenia AI.

Po połączeniu asystent widzi narzędzia Simplio3D obok własnych i na podstawie Twoich pytań decyduje, kiedy ich użyć.

Co może zrobić połączony agent w Simplio3D

Serwer MCP Simplio3D udostępnia 123 narzędzia: 52 do odczytu, 68 do zapisu w modelu kontrolowanego zapisu oraz 3 do uruchamiania przepływów pracy agenta. Łącznie obejmują one projekty, inspekcję modeli 3D, materiały, bloki opcji, logikę warunkową, ceny, formularze, zapytania ofertowe i połączenia ze sklepami. W praktyce połączony agent może:

• Odczytać rzeczywisty projekt: jego modele, bloki opcji i warianty, materiały, reguły warunkowe, bloki cenowe i formułę oraz pola formularza.
• Zajrzeć do modelu 3D: nazwy i hierarchię części, aby sprawdzić, czy każda opcja nadal wskazuje istniejącą siatkę.
• Przeprowadzić audyt konfiguratora: wykryć brakujące cele części, usunięte materiały, reguły, które nigdy nie zostaną uruchomione, oraz warianty bez ceny.
• Wyjaśnić logikę i wycenić konfigurację: wskazać, która reguła ukrywa opcję, oraz obliczyć na serwerze koszt danego zestawu wyborów.
• Tworzyć i edytować: tworzyć projekty, bloki opcji, warianty, materiały, reguły warunkowe i pola formularza oraz porządkować istniejące elementy.
• Uruchamiać przepływy pracy agenta: rozpocząć wieloetapowe zadanie, takie jak audyt projektu lub bezpieczna naprawa, odpowiadać na jego pytania i śledzić postępy. Przepływy pracy wstrzymują się do czasu Twojej akceptacji i nigdy nie publikują zmian.
• Podsumowywać leady: odczytać otrzymane zapytania ofertowe i sprawdzić, co skonfigurował każdy klient.
• Odpowiadać na pytania dotyczące produktu na podstawie dokumentacji: przeszukiwać oficjalną dokumentację Simplio3D i cytować odpowiednią stronę zamiast odpowiadać z pamięci.

Każde narzędzie, wraz z wymaganym zakresem uprawnień i informacją, czy służy do odczytu, czy zapisu, znajduje się w referencji narzędzi MCP.

Czego nie może zrobić

Niektóre działania pozostają niedostępne niezależnie od przyznanych zakresów uprawnień. Połączony agent nie może opublikować projektu, utworzyć linku do udostępniania ani zmienić ustawień osadzania. Nie może przesyłać plików ani usuwać projektu. Nie może połączyć ani odłączyć sklepu Shopify lub WooCommerce, ani odczytać danych uwierzytelniających tego sklepu. Nigdy nie otrzymuje też dostępu do bazy danych, kluczy API, sekretów webhooków ani haseł do widoków udostępnionych: narzędzia zwracają wybrane podsumowania, a nie surowe rekordy.

Zakresy: każdemu połączeniu przyznaj tylko niezbędne uprawnienia

Połączenie może wyświetlać i wywoływać wyłącznie narzędzia objęte jego zakresami. Zacznij od dostępu tylko do odczytu, a następnie dodawaj po jednym zakresie zapisu, zgodnie z wymaganiami zadania.

Kilka niewielkich połączeń jest bezpieczniejszych niż jedno, które może zrobić wszystko. Przydziel asystentowi analizującemu ceny osobne połączenie z zakresami odczytu oraz zapisu cen, a asystentowi tworzącemu projekty — inne. Cofnięcie jednego połączenia nigdy nie przerwie działania drugiego.

Jak zmiany pozostają pod Twoją kontrolą

Umożliwienie AI edytowania aktywnego konfiguratora działa tylko wtedy, gdy błędna edycja nie może dotrzeć do Twoich klientów. Simplio3D obsługuje każdy zapis w trzech krokach: zaproponuj, potwierdź, utwórz migawkę.

• Edycje o niskim ryzyku są wprowadzane bez oczekiwania na Ciebie, na przykład zmiana nazwy bloku lub dodanie wariantu.
• Zmiany wysokiego ryzyka zawsze tworzą wyłącznie propozycję: dotyczą one cen, SKU, usunięć, edycji zbiorczych, współdzielonych materiałów i linków do produktów w sklepie. Propozycja oczekuje w sekcji Oczekujące zmiany AI na stronie Połączenia AI i zawiera listę wszystkich zmian, które wprowadzi. Wybierasz Zastosuj lub odrzucasz ją. Żaden agent nie może zatwierdzić własnej propozycji, a tej reguły nie można wyłączyć.
• Każda zastosowana zmiana jest zapisywana jako migawka, dzięki czemu można ją cofnąć, ponownie zweryfikować i zarejestrować w dzienniku audytu.

Propozycje są ważne przez krótki czas. Jeśli projekt zmienił się od czasu, gdy agent coś zaproponował, stara propozycja zostanie odrzucona zamiast nadpisywać nowsze edycje; poproś agenta ponownie.

Ponadto wywołanie narzędzia powiedzie się tylko wtedy, gdy przejdzie wszystkie cztery kontrole: adres e-mail konta jest zweryfikowany, plan właściciela obszaru roboczego jest aktywny, rola stanowiska zezwala na działanie, a połączenie ma odpowiedni zakres. Obowiązuje najbardziej restrykcyjne ograniczenie. Na przykład stanowisko Viewer nigdy nie może wprowadzać ani potwierdzać zmian, niezależnie od zakresów jego połączenia.

Łączenie Claude bez tokena. Simplio3D jest dostępny w katalogu konektorów Claude. W Claude otwórz Dostosuj → Konektory, wyszukaj Simplio3D i kliknij Połącz albo wybierz Dodaj własny konektor i wklej https://app.simplio3d.ai/mcp. W obu przypadkach Claude otworzy stronę logowania Simplio3D oraz ekran zgody, na którym wybierzesz obszar roboczy i zakresy uprawnień, z domyślnie zaznaczonym dostępem tylko do odczytu. Połączenie pojawi się następnie na tej samej liście Połączeń AI, oznaczone jako aplikacja OAuth; możesz tam je odnowić lub cofnąć, tak jak każde inne.

Prompty, które warto wypróbować na początek

Podaj nazwę projektu i poproś o dowody: pytanie „która reguła to ukrywa?” przyniesie trafniejszą odpowiedź niż „dlaczego jest ukryte?”.

Ograniczenia, które warto znać, zanim zaczniesz na nim polegać

• Agenci odczytują zapisane dane. Edytor zapisuje automatycznie kilka sekund po każdej zmianie, dlatego edycja wprowadzona przed chwilą może nie być jeszcze widoczna. Zapisz, a następnie zapytaj ponownie.
• Ceny i logika po stronie serwera mają pewne ograniczenia. Obliczanie cen i ocena reguł obejmują typowe przypadki, ale nie każde zachowanie opublikowanego konfiguratora, takie jak wycena za jednostkę dla pola Number Input. Każdy wynik wskazuje, czego nie oceniono, a podgląd i opublikowany widok udostępniania pozostają ostatecznym źródłem informacji.
• Limity żądań. Każde połączenie może wykonać 300 żądań w ciągu pięciu minut. Obszar roboczy akceptuje 30 zastosowanych zmian AI co dziesięć minut, współdzielonych przez wszystkich połączonych agentów i wbudowanego asystenta.
• Duże odpowiedzi są skracane i odpowiednio oznaczane. Wynik przekraczający około 60 KB jest podsumowywany i oznaczany jako skrócony, dzięki czemu agent nie pomyli części listy z całą listą.
• To, co odczytuje agent, trafia do Twojego dostawcy AI. Zapytania ofertowe zawierają imiona i nazwiska klientów oraz dane kontaktowe, dlatego celowo przyznawaj zakres Quotes.
• Tokeny wygasają po 90 dniach. Natychmiast zmień token, jeśli został wklejony do czatu, zgłoszenia do pomocy technicznej lub udostępnionego ekranu. Zmiana tokenu od razu unieważnia poprzedni.

Jedna warstwa narzędziowa dla każdego interfejsu AI

Serwer MCP nie jest osobnym, doczepionym produktem. Wbudowany asystent AI Simplio3D’a, uwierzytelniony punkt końcowy narzędzi REST dla własnych automatyzacji oraz zewnętrzni klienci MCP korzystają z tego samego rejestru narzędzi, tego samego uwierzytelniania, uprawnień i dziennika audytu. Dana funkcja działa tak samo niezależnie od miejsca, z którego ją wywołujesz, a zakres lub rola blokująca ją w jednym miejscu blokuje ją wszędzie.

Właśnie tym MCP różni się również od REST API i SDK. SDK to typowany klient dla własnego kodu, uwierzytelniany kluczem API, a ten klucz nigdy nie jest akceptowany przez punkt końcowy MCP. MCP jest przeznaczone dla agentów AI, uwierzytelnianych za pomocą połączenia, którego zakres określasz dla każdego narzędzia.