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

# Połącz swojego agenta

> Konfiguracja krok po kroku, aby połączyć Claude, Cursor, VS Code, Windsurf, ChatGPT i innych agentów AI z serwerem MCP Zippendo.

Połącz swoje narzędzie AI z Zippendo, aby mogło pracować za Ciebie z przesyłkami, zamówieniami i przewoźnikami. Dodaj poniższy adres URL w narzędziu jako własny konektor MCP. Narzędzie otworzy w przeglądarce logowanie do Zippendo i samo utrzymuje połączenie: nie trzeba niczego instalować ani wklejać tokenu.

<Card title="Adres URL konektora" icon="server" horizontal>
  ```
  https://api.zippendo.com/mcp
  ```
</Card>

<Info>
  Serwer obsługuje dynamiczną rejestrację klienta, więc zgodny klient potrzebuje **tylko adresu URL**: bez identyfikatora klienta, bez sekretu klienta, bez wklejonego tokenu. Przy pierwszym połączeniu znajduje logowanie, rejestruje się i otwiera przeglądarkę, aby można było się zalogować i zatwierdzić dostęp. Zobacz [Uwierzytelnianie](/docs/pl/mcp/authentication).
</Info>

## Skonfiguruj z poziomu aplikacji Zippendo

Aplikacja przeprowadza Cię przez te same kroki dla Twojego narzędzia:

<Steps>
  <Step title="Otwórz kartę MCP">
    Przejdź do **Apps & integrations** → **Catalog**, znajdź **MCP (AI agents)** i kliknij **Connect**. Otworzy się okno **Connect an AI agent** (połącz agenta AI).
  </Step>

  <Step title="Wybierz agenta">
    Wybierz swoje narzędzie AI. Działa każdy klient MCP; lista pokazuje te, dla których są osobne instrukcje.
  </Step>

  <Step title="Dodaj konektor">
    Wykonaj kroki dla swojego narzędzia. **Connector URL** ma przycisk **Copy**. Po dodaniu kliknij **I've added it**.
  </Step>

  <Step title="Zatwierdź dostęp">
    Dokończ logowanie, które otworzyło Twoje narzędzie, i zatwierdź organizację oraz uprawnienia. Okno aktualizuje się samo, gdy tylko połączenie zostanie nawiązane. Kliknij **Done**.
  </Step>
</Steps>

Każdy połączony agent pojawia się wtedy na karcie **MCP (AI agents)** z informacją, kiedy był ostatnio używany i ile ma uprawnień. Kliknij **Disconnect**, aby odebrać mu dostęp, albo **Connect another**, aby dodać kolejnego. Kroki dla każdego narzędzia znajdziesz też poniżej.

## Claude Code

Dodaj serwer przez CLI, a potem uwierzytelnij się z poziomu sesji.

<Steps>
  <Step title="Dodaj serwer">
    ```bash theme={null}
    claude mcp add --transport http zippendo https://api.zippendo.com/mcp
    ```

    Użyj `--scope user`, aby serwer był dostępny w każdym projekcie, albo `--scope project`, aby zatwierdzić go w pliku `.mcp.json` repozytorium dla zespołu (domyślnie jest lokalny: tylko Ty, w bieżącym projekcie).
  </Step>

  <Step title="Uwierzytelnij się">
    Uruchom Claude Code, wpisz `/mcp`, wybierz **zippendo** i wybierz **Authenticate**. Przeglądarka otworzy ekran zgody Zippendo. Zatwierdź, a będziesz połączony. W dowolnej chwili uruchom `/mcp` ponownie, aby sprawdzić status lub uwierzytelnić się jeszcze raz.
  </Step>
</Steps>

Aby udostępnić serwer zespołowi, zatwierdź projektowy plik `.mcp.json`:

```json .mcp.json theme={null}
{
  "mcpServers": {
    "zippendo": {
      "type": "http",
      "url": "https://api.zippendo.com/mcp"
    }
  }
}
```

Połączeniem zarządzasz poleceniami `claude mcp list`, `claude mcp get zippendo` i `claude mcp remove zippendo`.

## Claude Desktop

<Steps>
  <Step title="Otwórz Connectors">
    Przejdź do **Settings → Connectors** i kliknij **Add custom connector**.
  </Step>

  <Step title="Dodaj adres URL">
    Nazwij go `Zippendo`, wpisz `https://api.zippendo.com/mcp` i kliknij **Add**.
  </Step>

  <Step title="Połącz">
    Kliknij **Connect**, aby otworzyć logowanie w przeglądarce, a potem zatwierdź organizację i uprawnienia.
  </Step>
</Steps>

<Note>
  Własne konektory są dostępne w planach Free, Pro, Max, Team i Enterprise. Plan Free dopuszcza jeden własny konektor. W planach Team i Enterprise konektor dodaje Owner, a każdy członek łączy się indywidualnie.
</Note>

## Claude w przeglądarce

To samo konto, te same kroki co w Claude Desktop.

* **Indywidualnie (Free, Pro, Max):** **Settings → Connectors → Add custom connector**, wpisz nazwę i `https://api.zippendo.com/mcp`, kliknij **Add**, a potem **Connect**.
* **Team i Enterprise:** **Owner** dodaje go raz w **Organization settings → Connectors → Add → Custom**. Członkowie otwierają potem **Settings → Connectors**, znajdują konektor i klikają **Connect**. Każdy członek łączy się z własnym dostępem.

## Cursor

Dodaj go w ustawieniach lub w pliku konfiguracyjnym.

<Steps>
  <Step title="Otwórz ustawienia MCP">
    Otwórz **Cursor Settings → Tools & MCP → New MCP Server**. Otworzy się Twój plik `mcp.json`.
  </Step>

  <Step title="Dodaj serwer">
    ```json mcp.json theme={null}
    {
      "mcpServers": {
        "zippendo": {
          "url": "https://api.zippendo.com/mcp"
        }
      }
    }
    ```

    Konfiguracja globalna znajduje się w `~/.cursor/mcp.json`, a projektowa w `.cursor/mcp.json`.
  </Step>

  <Step title="Zaloguj się">
    Obok serwera pojawia się element **Login**. Kliknij go, aby uruchomić logowanie w przeglądarce.
  </Step>
</Steps>

<Tip>
  Instalacja jednym kliknięciem: [**Dodaj Zippendo do Cursor**](cursor://anysphere.cursor-deeplink/mcp/install?name=zippendo\&config=eyJ1cmwiOiJodHRwczovL2FwaS56aXBwZW5kby5jb20vbWNwIn0=).
  Cursor poprosi o zatwierdzenie i sam zapisze wpis.
</Tip>

## VS Code (GitHub Copilot)

Wymaga VS Code 1.102 lub nowszego z GitHub Copilot. Używaj narzędzi z Copilot Chat w trybie **Agent**.

<Steps>
  <Step title="Dodaj serwer">
    Command Palette → **MCP: Add Server** → **HTTP**, wklej `https://api.zippendo.com/mcp`, a potem wybierz **Workspace** (zapisuje `.vscode/mcp.json`) lub **Global**.
  </Step>

  <Step title="Uwierzytelnij się">
    Nad wpisem serwera w `mcp.json` pojawia się akcja **Auth**. Dokończ logowanie w przeglądarce.
  </Step>
</Steps>

Konfiguracja VS Code używa klucza najwyższego poziomu `servers` (a nie `mcpServers`):

```json .vscode/mcp.json theme={null}
{
  "servers": {
    "zippendo": {
      "type": "http",
      "url": "https://api.zippendo.com/mcp"
    }
  }
}
```

## Windsurf

Edytuj `~/.codeium/windsurf/mcp_config.json` (Cascade → MCP servers → edit raw config).

```json ~/.codeium/windsurf/mcp_config.json theme={null}
{
  "mcpServers": {
    "zippendo": {
      "serverUrl": "https://api.zippendo.com/mcp"
    }
  }
}
```

<Warning>
  Windsurf używa `serverUrl` (a nie `url`) dla serwerów Streamable HTTP. OAuth jest obsługiwany, ale jeśli logowanie w przeglądarce się nie otwiera, zaktualizuj Windsurf do najnowszej wersji.
</Warning>

## ChatGPT

Własne konektory MCP dodaje się przez **Developer Mode**, tylko w wersji przeglądarkowej (bez pliku konfiguracyjnego).

<Steps>
  <Step title="Włącz Developer Mode">
    Włącz **Settings → Connectors → Advanced → Developer Mode**.
  </Step>

  <Step title="Dodaj konektor">
    Wróć do **Connectors** i dodaj własny konektor z adresem URL `https://api.zippendo.com/mcp`. ChatGPT poprosi o zalogowanie przy pierwszym połączeniu.
  </Step>
</Steps>

<Warning>
  Developer Mode jest w wersji **beta** w planach Plus, Pro, Business, Enterprise i Edu. Pełne wywoływanie narzędzi (akcje zapisu, takie jak utworzenie przesyłki) jest ograniczone do **Business, Enterprise i Edu**. Plus i Pro są w praktyce tylko do odczytu. Akcje zapisu wymagają każdorazowego potwierdzenia. ChatGPT może zmieniać nazwy menu i dostępność.
</Warning>

## OpenAI Codex CLI

Użyj aktualnego Codex CLI (starsze wersje obsługiwały tylko serwery lokalne). Dodaj serwer w pliku konfiguracyjnym lub przez CLI.

```toml ~/.codex/config.toml theme={null}
[mcp_servers.zippendo]
url = "https://api.zippendo.com/mcp"
```

```bash CLI theme={null}
codex mcp add zippendo --url https://api.zippendo.com/mcp
codex mcp login zippendo   # opens the browser sign-in
```

Jeśli Twoja wersja Codex nie ma `--url` ani `codex mcp login`, zaktualizuj Codex CLI do najnowszej wersji.

## Gemini CLI

Edytuj `~/.gemini/settings.json`. Serwery Streamable HTTP używają pola `httpUrl`.

```json ~/.gemini/settings.json theme={null}
{
  "mcpServers": {
    "zippendo": {
      "httpUrl": "https://api.zippendo.com/mcp"
    }
  }
}
```

Gemini CLI sam znajduje logowanie OAuth. W sesji uruchom `/mcp auth` (lub `/mcp`, aby zobaczyć, które serwery tego wymagają), aby otworzyć logowanie w przeglądarce.

## Każdy inny klient MCP

Większość klientów akceptuje standardową konfigurację zdalną, wystarczy sam adres URL:

```json theme={null}
{
  "mcpServers": {
    "zippendo": {
      "url": "https://api.zippendo.com/mcp"
    }
  }
}
```

Jeśli Twój klient stosuje specyfikację autoryzacji MCP, sam znajdzie logowanie i przeprowadzi OAuth. Potem zatwierdź organizację i uprawnienia na stronie logowania Zippendo, którą otworzy.

## Rozwiązywanie problemów

<AccordionGroup>
  <Accordion title="Logowanie w przeglądarce w ogóle się nie otwiera">
    Sprawdź, czy Twój klient obsługuje **zdalny MCP przez OAuth** i czy masz jego najnowszą wersję. Niektórzy klienci dodali zdalne konektory dopiero w ostatnich wydaniach.
  </Accordion>

  <Accordion title="Agent nie widzi potrzebnego narzędzia">
    Narzędzia są filtrowane według zatwierdzonych uprawnień. Połącz się ponownie i przyznaj brakujące uprawnienie na ekranie zgody (na przykład `write:shipments`, aby tworzyć przesyłki). Zobacz [Narzędzia i zakresy](/docs/pl/mcp/tools).
  </Accordion>

  <Accordion title="Działa w niewłaściwej organizacji">
    Każde połączenie należy do jednej organizacji. Rozłącz, połącz ponownie i wybierz właściwą organizację na ekranie zgody. Zobacz [Uwierzytelnianie](/docs/pl/mcp/authentication).
  </Accordion>

  <Accordion title="Logowanie odrzuca Twoje konto">
    Jeśli Twoje konto członka zespołu jest ograniczone do jednej marki, nie możesz połączyć agenta. Poproś właściciela organizacji o dostęp do całej organizacji albo o samodzielne połączenie agenta.
  </Accordion>

  <Accordion title="Konfiguracja tylko z url jest odrzucana">
    Niektórzy klienci wymagają jawnego podania typu transportu. Dodaj `"type": "http"` obok `url` (Claude Code, VS Code) albo użyj opcji HTTP tego klienta przy dodawaniu serwera.
  </Accordion>
</AccordionGroup>


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