> ## Documentation Index > Fetch the complete documentation index at: https://www.zippendo.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Narzędzia i zakresy > Narzędzia oferowane przez serwer MCP Zippendo, uprawnienia, które je odblokowują, i przykładowe polecenia. Narzędzia to działania, które Twój agent AI może wykonywać za Ciebie w Zippendo, na przykład tworzenie przesyłki lub odczyt zamówienia. Serwer MCP udostępnia jedno narzędzie dla każdego działania w API, a Twój agent widzi tylko te narzędzia, na które pozwalają [zatwierdzone przez Ciebie uprawnienia](/docs/pl/mcp/authentication). ## Jak narzędzia odpowiadają uprawnieniom Każde narzędzie wymaga uprawnienia (zakresu, ang. scope), które pasuje do zasobu i działania: * Odczyt danych wymaga zakresu `read:`. Na przykład wyświetlenie listy przesyłek wymaga `read:shipments`. * Zmiana danych wymaga odpowiedniego zakresu `write:`. Na przykład utworzenie przesyłki wymaga `write:shipments`. Zakresy się na siebie nakładają, więc możesz przyznawać uprawnienia szeroko lub wąsko: * **`write:all`** obejmuje `read:all` oraz każdy zakres `write:` z poniższej tabeli. * **`read:all`** obejmuje każdy zakres `read:` z poniższej tabeli. * **`write:`** obejmuje **`read:`** (`write:shipments` obejmuje `read:shipments`). Agent z samym `read:shipments` widzi narzędzia do **odczytu** przesyłek (lista, szczegóły, śledzenie przesyłek, dokumenty), ale żadnych narzędzi do tworzenia, wysyłania ani usuwania przesyłek. ## Lista zakresów | Zasób | Zakres odczytu | Zakres zapisu | Odczyt pozwala agentowi… | Zapis pozwala dodatkowo… | | - | - | - | - | - | | Przesyłki | `read:shipments` | `write:shipments` | Wyświetlać przesyłki, widzieć szczegóły i śledzenie przesyłek, pobierać etykiety i dokumenty | Tworzyć, zmieniać, wysyłać, dzielić i usuwać przesyłki; przenosić paczki; tworzyć przesyłki zwrotne; ponownie pobierać etykietę | | Zamówienia | `read:orders` | `write:orders` | Wyświetlać zamówienia i widzieć ich szczegóły | Tworzyć, zmieniać i usuwać zamówienia | | Przewoźnicy | `read:carriers` | `write:carriers` | Wyświetlać połączonych przewoźników i ich produkty | Łączyć, aktualizować i usuwać przewoźników; wyszukiwać punkty odbioru | | Kanały sprzedaży | `read:order_channels` | `write:order_channels` | Wyświetlać kanały sprzedaży i status ich webhooków | Tworzyć, zmieniać i usuwać kanały; synchronizować je i testować; rejestrować ich webhooki; zarządzać tokenami kasy i kluczami podpisu | | Adresy | `read:addresses` | `write:addresses` | Wyświetlać adresy nadawcy, odbioru i zwrotów | Tworzyć, aktualizować i usuwać adresy | | Reguły wysyłki | `read:shipping_rules` | `write:shipping_rules` | Wyświetlać reguły wysyłki | Tworzyć, zmieniać i usuwać reguły wysyłki | | Automatyzacje | `read:automations` | `write:automations` | Wyświetlać automatyzacje, ich uruchomienia i dostępne kroki | Tworzyć, zmieniać, usuwać i uruchamiać automatyzacje | | Drukarki | `read:printers` | `write:printers` | Wyświetlać drukarki | Rejestrować, zatwierdzać, wyłączać, zmieniać i usuwać drukarki | | Webhooki | `read:webhooks` | `write:webhooks` | Wyświetlać webhooki i ich dostarczenia | Tworzyć, zmieniać, testować i usuwać webhooki | | Integracje | `read:integrations` | `write:integrations` | Wyświetlać dostępne integracje, Twoje połączenia i ich dostarczenia | Łączyć, zmieniać, testować i usuwać integracje | | Role | `read:roles` | `write:roles` | Wyświetlać role | Tworzyć, zmieniać i usuwać role | | Członkowie zespołu | `read:users` | `write:users` | (brak narzędzi odczytu) | Dodawać członka zespołu do organizacji | | **Everything** | `read:all` | `write:all` | Wszystkie powyższe narzędzia odczytu | Wszystkie powyższe narzędzia | Ekran zgody może też wymieniać inne uprawnienia, takie jak organizacje, członkowie zespołu (`org_members`), portale zwrotów i tokeny API. Obecnie nie odblokowują one żadnych narzędzi MCP. Przyznaj możliwie najwęższy zestaw, który wystarcza do zadania. `read:all` plus `write:shipments` to dobre ustawienie domyślne dla asystenta, który raportuje wszystko, ale działa tylko na przesyłkach. ## Przykładowe polecenia Po połączeniu rozmawiaj z agentem zwykłym językiem. Wybierze właściwe narzędzia i zapyta Zippendo: * "Ile przesyłek nadal oczekuje i u jakich przewoźników?" * "Utwórz przesyłkę dla zamówienia #10421 z PostNord i podaj mi numer przesyłki." * "Podziel przesyłkę dla zamówienia #10388 na dwie paczki i wyślij obie." * "Które zamówienia z ostatnich 24 godzin nie mają jeszcze przesyłki?" * "Śledź przesyłkę `shp_8f3kd9` i powiedz mi, czy jest opóźniona." * "Dodaj regułę wysyłki, która wysyła zamówienia powyżej 10 kg przez GLS." ## Narzędzia do dokumentacji i SDK Oprócz narzędzi działań serwer MCP pozwala agentowi **czytać dokumentację Zippendo**, dzięki czemu może pomóc Ci *zbudować* integrację w Twoim języku programowania. Te narzędzia **nie wymagają zakresu** i ma je każdy połączony agent. | Narzędzie | Co robi | | - | - | | `search_documentation` | Przeszukuje całą dokumentację: przewodniki, pełną dokumentację API i strony SDK. Pomiń zapytanie, aby przeglądać cały indeks. | | `fetch_documentation` | Czyta dowolną stronę jako markdown (strony dokumentacji API zawierają opis OpenAPI punktu końcowego). Podaj `openapi`, aby dostać pełną surową specyfikację. | | `get_sdk_reference` | Dokumentacja SDK dla każdego języka (TypeScript, Python, PHP, Go, Ruby): sygnatury metod i działające przykłady. | Agent dostaje polecenie, by **preferować SDK dla Twojego języka** i używać surowej specyfikacji OpenAPI tylko wtedy, gdy dla danego języka nie ma SDK. Treść pochodzi na żywo z [zippendo.com/docs](https://www.zippendo.com/docs) i repozytoriów SDK, więc jest zawsze aktualna. Wypróbuj polecenia takie jak: * "Użyj SDK Zippendo dla Pythona i napisz skrypt, który tworzy przesyłkę dla zamówienia i wypisuje numer przesyłki." * "Jak uwierzytelnić się w API Zippendo w Go? Pokaż mi konfigurację SDK." * "Używam PHP. Napisz obsługę webhooka, która weryfikuje podpis i reaguje na `shipment.dispatched`." ## Model bezpieczeństwa Wywołania narzędzi działają jako Ty, tylko z uprawnieniami, które zatwierdziłeś. Połączenie należy do jednej organizacji. Nie może czytać ani zmieniać danych innej organizacji. Agent nigdy nie może wykonywać działań zarezerwowanych dla pracowników Zippendo. Każde wywołanie przechodzi te same kontrole logowania, limitów planu i walidacji co aplikacja. Usuwanie przesyłek, zamówień, przewoźników, adresów, reguł wysyłki lub ról, wysyłanie przesyłki oraz tworzenie i unieważnianie tokenów kasy i kluczy podpisu wymagają wyraźnego potwierdzenia w wywołaniu narzędzia, więc agent powinien Cię wcześniej zapytać. Niektóre wrażliwe działania, takie jak rozliczenia i zarządzanie tokenami API, w ogóle nie są dostępne w narzędziach i żaden agent nie może z nich korzystać, niezależnie od uprawnień. ## Te same narzędzia napędzają Zippy Serwer MCP dzieli swoje narzędzia z **Zippy**, asystentem w aplikacji Zippendo. Różni się tylko miejsce: Zippy działa w aplikacji, a MCP pozwala Twojemu własnemu narzędziu AI korzystać z tych samych działań. Oba stosują te same uprawnienia, limity organizacji i walidację. Gotowy na konfigurację? Skorzystaj z przewodnika dla swojego narzędzia. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.