> ## 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.

# Uwierzytelnianie

> Jak serwer MCP Zippendo loguje Twojego agenta AI przez OAuth 2.1 i jak wybierasz organizację oraz uprawnienia, które dostaje.

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:

<Steps>
  <Step title="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ę.
  </Step>

  <Step title="Logujesz się do Zippendo">
    Jeśli nie jesteś jeszcze zalogowany, trafiasz na stronę logowania Zippendo. Zaloguj się tak, jak zwykle.
  </Step>

  <Step title="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ć.
  </Step>

  <Step title="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.
  </Step>
</Steps>

<Note>
  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.
</Note>

## 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](/docs/pl/mcp/tools).

<Info>
  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.
</Info>

## Tokeny i odświeżanie

Twój klient zarządza tokenami OAuth za Ciebie:

| Token | Czas ważności | Uwagi |
| - | - | - |
| Token dostępu | 1 godzina | Wysyłany w każdym żądaniu. |
| Token odświeżania | 30 dni | Wymieniany przy każdym użyciu. Ponowne użycie starego tokenu odświeżania jest traktowane jak kradzież i **kończy całe połączenie**. |

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.

<Note>
  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.
</Note>

## Dla programistów: endpointy discovery

API jest własnym serwerem autoryzacji OAuth 2.1. Standardowe endpointy discovery są publiczne:

| Endpoint | Cel |
| - | - |
| `GET /.well-known/oauth-protected-resource` | RFC 9728: wskazuje klientom serwer autoryzacji. |
| `GET /.well-known/oauth-authorization-server` | RFC 8414: metadane serwera autoryzacji. |
| `POST /oauth/register` | RFC 7591: dynamiczna rejestracja klienta (publiczni klienci PKCE). |
| `GET /oauth/authorize` | Rozpoczyna autoryzację (PKCE S256). |
| `POST /oauth/token` | Wymienia kod i rotuje tokeny odświeżania. |

Zgodny z MCP klient obsługuje to wszystko za Ciebie: podajesz mu tylko adres URL.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.