# Dokumentacja agentów AI i MCP | MerchandAise

- slug: developers-ai-agents-mcp
- locale: pl
- localeResolved: pl
- canonical: https://www.merchandaise.com/pl/developers/ai-agents-mcp

Poznaj dokumentację MCP MerchandAise, odkrywanie serwera i narzędzia agentów AI do projektowania produktów oraz wycen, z uprawnieniami przestrzeni i zatwierdzeniami użytkownika.

## Zrozum możliwości asystenta
W obsługiwanych sesjach użytkownik może opisać pomysł, obejrzeć produkt w interaktywnym 3D i poprosić o zmiany. Asystent korzysta z tych samych danych produktu i stanu projektu co proces MerchandAise; aktualne narzędzia określają, co może odczytać lub zmienić.
Karta serwera i metadane narzędzi zewnętrznych są publiczne do odkrywania. Każde wywołanie nadal podlega zadeklarowanym granicom bezpieczeństwa i przestrzeni, a zatwierdzenia kupującego, projektu do produkcji i produkcji pozostają widoczne oraz przypisane do odpowiedzialnej osoby.

## Odkryj serwer. Następnie poproś o właściwy dostęp.
- **Agenci AI i MCP:** Połącz asystenta AI przez Model Context Protocol. Odkrywaj obsługiwane narzędzia i zachowuj wybory projektowe użytkownika, jego uprawnienia oraz wymagane potwierdzenia. Human guide: Czytaj przewodnik wdrożenia MCP (/pl/developers/ai-agents-mcp#implementation-checklist). Machine-readable contract: Publiczna karta serwera MCP w JSON (/.well-known/mcp/server-card). Dostęp: Publiczny. Publiczny dokument odkrywania dla klientów maszynowych. Lista zewnętrznych narzędzi w /api/v1/mcp/tools ujawnia aktualne metadane narzędzi; każde wywołanie nadal podlega zadeklarowanym granicom bezpieczeństwa, przestrzeni i potwierdzeń. Canonical page: /pl/developers/ai-agents-mcp. Canonical section: /pl/developers/ai-agents-mcp#mcp-tools.
- **Dokumentacja API i OpenAPI:** Znajdź dokumentację API narzędzi asystentów i sesji projektowych, a następnie wybierz specyfikację dla społeczności, dostawców lub firm odpowiadającą Twojemu procesowi. Human guide: Poznaj dokumentację API (/pl/developers/api-integrations). Machine-readable contract: OpenAPI narzędzi asystenta w JSON (/api/docs/openapi.json). Dostęp: Publiczny. Publiczna dokumentacja API asystentów i narzędzi. Dostęp produkcyjny i operacje wpływające na zamówienia nadal wymagają właściwych uprawnień. Canonical page: /pl/developers/ai-agents-mcp. Canonical section: /pl/developers/ai-agents-mcp#api-docs.

## Od odkrycia serwera do pierwszego procesu
- **Step 1: Odkrywaj bezpiecznie:** Skorzystaj z publicznej karty serwera MCP i listy narzędzi, aby rozpoznać MerchandAise oraz aktualny zestaw narzędzi zewnętrznych. Samo odkrycie nie daje szerokich uprawnień do wycen, zmian stanu ani zamawiania.
- **Step 2: Nadaj tylko niezbędne uprawnienia:** Autoryzuj wyłącznie narzędzia, przestrzeń i środowisko potrzebne asystentowi. Oddziel poznawanie produktów przez odczyt od działań zmieniających projekt, wycenę, zatwierdzenie lub zamówienie.
- **Step 3: Potwierdź przed działaniem z konsekwencjami:** Zachowaj wyraźne potwierdzenie człowieka dla działań wrażliwych. Przetestuj nieaktualny stan, odmowę działania i odzyskanie poprawnego stanu przed włączeniem ruchu produkcyjnego.

## Co agent musi zachować
- **Jeden wersjonowany stan produktu:** Asystent pracuje na tym samym stanie projektu, zamiaru zakupu, wyceny potwierdzonej przez dostawcę, zatwierdzenia i zamówienia co pozostałe interfejsy MerchandAise.
- **Prywatność danych handlowych i dostawców:** Gdy MerchandAise obsługuje transakcję kupującego, Hutter Products GmbH jest sprzedawcą będącym stroną umowy i Merchant of Record pod marką MerchandAise. Prywatna tożsamość, kontakty i dane wewnętrzne dostawców nie są ujawniane agentowi.
- **Zatwierdzenia pozostają po stronie człowieka:** Widok 3D nie jest dowodem fizycznym. Potwierdzona wycena opisuje dostępne opcje próbek dla klienta, koszty, ograniczenia i terminy. Przed produkcją seryjną zatwierdź dokładny projekt cyfrowy, zakończ obowiązkowe kontrole techniczne i zatwierdź wymagane lub wybrane próbki. Wymagania już przyjętych zamówień pozostają wiążące.

## Zanim agent trafi do produkcji
Odkrywalny serwer MCP to dopiero początek. Gotowość produkcyjna oznacza ograniczoną rolę asystenta, przypisaną odpowiedzialność za każde działanie z konsekwencjami i bezpieczny stan użytkownika po błędzie.
- **Dopasuj dostęp do konsekwencji:** Zanim udostępnisz narzędzie asystentowi, sklasyfikuj je jako odczyt, doradztwo, zmianę stanu, dostęp do wrażliwych danych dostawcy lub wpływ na zamówienie.
- **Wskaż osobę odpowiedzialną za każde potwierdzenie:** Określ, kto zatwierdza zmiany produktu, wyceny, projekty cyfrowe, próbki produkcyjne i zamówienia oraz co robi asystent, gdy ta osoba jest niedostępna.
- **Obserwuj, odmawiaj i odzyskuj działanie:** Sprawdź nieprawidłowe dane, nieaktualny stan, brak uprawnień, odmowy, ponowienia, telemetrię i ścieżki wycofania przed skierowaniem ruchu do procesu.

## Pytania i odpowiedzi
- **Czym jest MCP i czy to publiczna aplikacja ChatGPT?:** MCP to Model Context Protocol — sposób odkrywania i używania narzędzi przez asystenta. Ta dokumentacja opisuje możliwości integracji MerchandAise. Publiczna karta serwera nie potwierdza dostępności aplikacji w sklepie ChatGPT. Dostęp w przestrzeni ChatGPT zależy od konta, konfiguracji aplikacji i obsługiwanego środowiska.
- **Co agent AI może robić z MerchandAise?:** Autoryzowany asystent może korzystać z narzędzi zatwierdzonych dla jego przestrzeni i środowiska, takich jak odkrywanie produktów, pomoc przy projekcie lub wycenie i inne wyraźnie włączone operacje. Narzędzia i ich uprawnienia są ustalane podczas oceny integracji.
- **Czy agent AI może automatycznie składać zamówienia?:** Nie przez samo odkrycie serwera lub odczyt listy narzędzi. Każdy proces wpływający na zamówienie musi zachować uwierzytelnianie, potwierdzenie kupującego i przestrzeni, aktualną wersję ceny, zatwierdzenie projektu cyfrowego, wykonalność potwierdzoną przez dostawcę, obowiązkowe kontrole techniczne oraz dokładny wybór próbek i wymagania zatwierdzeń uzgodnione dla zamówienia. Nie wolno po cichu znosić wymagań już przyjętego zamówienia.
- **Czy integracja MCP MerchandAise jest publiczna?:** Karta serwera MCP i aktualne metadane narzędzi zewnętrznych są publiczne do odkrywania maszynowego. Poszczególne wywołania narzędzi podlegają zadeklarowanemu modelowi bezpieczeństwa; chronione operacje przestrzeni, dostawców, firm, wycen i zamówień zachowują wymagane uprawnienia oraz potwierdzenia.

## Masz pomysł na proces z agentem AI?
Powiedz, komu służy asystent, na co powinien mieć pozwolenie i gdzie człowiek musi zachować kontrolę. Ustalimy właściwe granice MCP, API i zatwierdzeń.
- **Omów proces z agentem AI:** /pl/contact?intent=agent-mcp-review
- **Poznaj specyfikacje API:** /pl/developers/api-integrations
