Połącz swojego agenta

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.

Adres URL konektora

https://api.zippendo.com/mcp

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.

Skonfiguruj z poziomu aplikacji Zippendo

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

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

Wybierz agenta

Wybierz swoje narzędzie AI. Działa każdy klient MCP; lista pokazuje te, dla których są osobne instrukcje.

Dodaj konektor

Wykonaj kroki dla swojego narzędzia. Connector URL ma przycisk Copy. Po dodaniu kliknij I’ve added it.

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.

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.

Dodaj serwer

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

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.

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

.mcp.json

{
  "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

Otwórz Connectors

Przejdź do Settings → Connectors i kliknij Add custom connector.

Dodaj adres URL

Nazwij go Zippendo, wpisz https://api.zippendo.com/mcp i kliknij Add.

Połącz

Kliknij Connect, aby otworzyć logowanie w przeglądarce, a potem zatwierdź organizację i uprawnienia.

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.

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.

Otwórz ustawienia MCP

Otwórz Cursor Settings → Tools & MCP → New MCP Server. Otworzy się Twój plik mcp.json.

Dodaj serwer

mcp.json

{
  "mcpServers": {
    "zippendo": {
      "url": "https://api.zippendo.com/mcp"
    }
  }
}

Konfiguracja globalna znajduje się w ~/.cursor/mcp.json, a projektowa w .cursor/mcp.json.

Zaloguj się

Obok serwera pojawia się element Login. Kliknij go, aby uruchomić logowanie w przeglądarce.

Instalacja jednym kliknięciem: Dodaj Zippendo do Cursor. Cursor poprosi o zatwierdzenie i sam zapisze wpis.

VS Code (GitHub Copilot)

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

Dodaj serwer

Command Palette → MCP: Add Server → HTTP, wklej https://api.zippendo.com/mcp, a potem wybierz Workspace (zapisuje .vscode/mcp.json) lub Global.

Uwierzytelnij się

Nad wpisem serwera w mcp.json pojawia się akcja Auth. Dokończ logowanie w przeglądarce.

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

.vscode/mcp.json

{
  "servers": {
    "zippendo": {
      "type": "http",
      "url": "https://api.zippendo.com/mcp"
    }
  }
}

Windsurf

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "zippendo": {
      "serverUrl": "https://api.zippendo.com/mcp"
    }
  }
}

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.

ChatGPT

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

Włącz Developer Mode

Włącz Settings → Connectors → Advanced → Developer Mode.

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.

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ść.

OpenAI Codex CLI

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

~/.codex/config.toml

[mcp_servers.zippendo]
url = "https://api.zippendo.com/mcp"

CLI

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.

~/.gemini/settings.json

{
  "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:

{
  "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

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.

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.

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.

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.

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.

Start

Quickstarts

Fulfillment flow

Connections

Operations

Organization & account

Połącz swojego agenta

Adres URL konektora

Skonfiguruj z poziomu aplikacji Zippendo

Claude Code

Claude Desktop

Claude w przeglądarce

Cursor

VS Code (GitHub Copilot)

Windsurf

ChatGPT

OpenAI Codex CLI

Gemini CLI

Każdy inny klient MCP

Rozwiązywanie problemów

Adres URL konektora

​Skonfiguruj z poziomu aplikacji Zippendo

​Claude Code

​Claude Desktop

​Claude w przeglądarce

​Cursor

​VS Code (GitHub Copilot)

​Windsurf

​ChatGPT

​OpenAI Codex CLI

​Gemini CLI

​Każdy inny klient MCP

​Rozwiązywanie problemów

Skonfiguruj z poziomu aplikacji Zippendo

Claude Code

Claude Desktop

Claude w przeglądarce

Cursor

VS Code (GitHub Copilot)

Windsurf

ChatGPT

OpenAI Codex CLI

Gemini CLI

Każdy inny klient MCP

Rozwiązywanie problemów