Skip to main content
Sam decydujesz dokładnie, co podłączony agent AI może robić w Zippendo: w której organizacji pracuje i jakie ma uprawnienia. Adres URL konektora (https://api.zippendo.com/mcp) jest chroniony przez OAuth 2.1. Nigdy nie wklejasz tokenu: klient znajduje logowanie na podstawie adresu URL, otwiera przeglądarkę, a Ty logujesz się do Zippendo i zatwierdzasz dostęp. Ta strona wyjaśnia, co się dzieje i nad czym masz kontrolę.

​
Kroki połączenia

Gdy dodajesz adres URL do klienta i łączysz się po raz pierwszy:
1

Klient znajduje logowanie

Serwer odpowiada na pierwsze żądanie bez danych uwierzytelniających wskazówką do swoich danych OAuth. Klient rejestruje się automatycznie (nie musisz tworzyć client ID) i otwiera przeglądarkę.
2

Logujesz się do Zippendo

Jeśli nie jesteś jeszcze zalogowany, trafiasz na stronę logowania Zippendo. Zaloguj się tak, jak zwykle.
3

Zatwierdzasz dostęp na ekranie zgody

Ekran Authorize access pokazuje nazwę klienta, Organization do połączenia i Permissions, o które prosi. Wybierz organizację, zaznacz uprawnienia, które chcesz nadać, i kliknij Authorize. Kliknij Deny, aby odmówić.
4

Jesteś połączony

Przeglądarka oddaje kontrolę klientowi, który zapisuje swoje tokeny i sam je odświeża. Nie musisz logować się ponownie, dopóki nie odłączysz agenta albo jego dostęp nie wygaśnie.
Członek zespołu ograniczony do jednej marki nie może podłączyć agenta. Ekran zgody odrzuca takie żądanie. Poproś osobę z dostępem do całej organizacji, aby go podłączyła.

​
Wybór organizacji

Każde połączenie należy do jednej organizacji. Na ekranie zgody wybierasz, w której organizacji agent może pracować, a każde wywołanie narzędzia pozostaje w tej organizacji. Aby pracować w innej organizacji, połącz się ponownie i wybierz inną organizację na ekranie zgody. W klientach, które pozwalają na więcej niż jeden wpis serwera, możesz też dodać drugi konektor z tym samym adresem URL i zatwierdzić go dla drugiej organizacji.

​
Ograniczanie uprawnień

Na ekranie zgody możesz nadać mniej uprawnień, niż prosi klient, ale nigdy więcej. Musisz zachować co najmniej jedno. Jeśli klient nie prosi o nic konkretnego, ekran oferuje dostęp do odczytu i zapisu wszystkiego. Nadaj tylko to, czego agent potrzebuje:
  • Ma tylko odpowiadać na pytania? Nadaj wyłącznie uprawnienia Read.
  • Ma tworzyć i nadawać przesyłki? Dodaj dostęp do zapisu przesyłek (write:shipments).
Narzędzia widoczne dla agenta są filtrowane według uprawnień, które zatwierdzisz. Pełną mapę znajdziesz w Narzędzia i zakresy.
Agent działa jako Ty, tylko w organizacji i z uprawnieniami, które zatwierdziłeś, i nigdy z uprawnieniami pracowników Zippendo. Każde wywołanie narzędzia przechodzi to samo logowanie, te same kontrole uprawnień, limity planu i walidację co zwykłe żądanie API.

​
Tokeny i odświeżanie

Twój klient zarządza tokenami OAuth za Ciebie: Nie obsługujesz ich samodzielnie: klient je zapisuje i odświeża.

​
Odłączanie

Aby zakończyć dostęp agenta, przejdź do Apps & integrations w aplikacji Zippendo. Karta MCP (AI agents) wymienia podłączonych przez Ciebie agentów, z informacją, kiedy ostatnio byli używani i ile mają uprawnień. Kliknij Disconnect obok agenta. Jego dostęp kończy się natychmiast, razem z tokenami, które już posiada. Konektor możesz też usunąć w swoim kliencie (na przykład claude mcp remove zippendo albo usuń go z ustawień MCP lub Connectors klienta). To powstrzymuje klienta przed jego używaniem, ale tokeny po stronie Zippendo unieważnia tylko Disconnect w Zippendo.
Karta pokazuje tylko agentów, których sam podłączyłeś. Każdy członek zespołu łączy i odłącza własnych agentów.

​
Dla programistów: endpointy discovery

API jest własnym serwerem autoryzacji OAuth 2.1. Standardowe endpointy discovery są publiczne: Zgodny z MCP klient obsługuje to wszystko za Ciebie: podajesz mu tylko adres URL.