Je agent verbinden

Verbind je AI-tool met Zippendo, zodat die namens jou met je zendingen, bestellingen en vervoerders kan werken. Voeg de onderstaande URL toe aan de tool als aangepaste MCP-connector. De tool opent de Zippendo-aanmelding in je browser en houdt de verbinding zelf actueel: je hoeft niets te installeren en geen token te plakken.

Connector-URL

https://api.zippendo.com/mcp

De server ondersteunt dynamische clientregistratie, dus een compatibele client heeft alleen de URL nodig: geen client-ID, geen clientgeheim, geen geplakt token. Bij de eerste verbinding vindt de client de aanmelding, registreert zichzelf en opent je browser zodat je kunt aanmelden en toegang kunt goedkeuren. Zie Authenticatie.

Instellen vanuit de Zippendo-app

De app begeleidt je bij dezelfde stappen voor jouw tool:

Open de MCP-kaart

Ga naar Apps & integrations → Catalog, zoek MCP (AI agents) en klik op Connect. Het venster Connect an AI agent opent.

Kies een agent

Kies je AI-tool. Elke MCP-client werkt; de lijst toont de clients met eigen instructies.

Voeg de connector toe

Volg de stappen voor je tool. De Connector URL heeft een knop Copy. Klik na het toevoegen op I’ve added it.

Keur toegang goed

Rond de aanmelding af die je tool heeft geopend en keur de organisatie en rechten goed. Het venster wordt vanzelf bijgewerkt zodra de verbinding tot stand is gekomen. Klik op Done.

Elke verbonden agent verschijnt daarna op de kaart MCP (AI agents), met wanneer hij voor het laatst is gebruikt en hoeveel rechten hij heeft. Klik op Disconnect om de toegang te verwijderen, of op Connect another om er nog een toe te voegen. De stappen voor elke tool staan ook hieronder.

Claude Code

Voeg de server toe met de CLI en verifieer daarna vanuit een sessie.

Voeg de server toe

claude mcp add --transport http zippendo https://api.zippendo.com/mcp

Gebruik --scope user om hem in elk project beschikbaar te maken, of --scope project om hem voor je team vast te leggen in de .mcp.json van de repository (standaard is lokaal: alleen jij, in het huidige project).

Verifieer

Start Claude Code, voer /mcp uit, selecteer zippendo en kies Authenticate. Je browser opent het Zippendo-toestemmingsscherm. Keur goed en je bent verbonden. Voer op elk moment opnieuw /mcp uit om de status te controleren of opnieuw te verifiëren.

Om de server met je team te delen, leg je een .mcp.json voor het project vast:

.mcp.json

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

Beheer de verbinding met claude mcp list, claude mcp get zippendo en claude mcp remove zippendo.

Claude Desktop

Open Connectors

Ga naar Settings → Connectors en klik op Add custom connector.

Voeg de URL toe

Noem hem Zippendo, vul https://api.zippendo.com/mcp in en klik op Add.

Verbind

Klik op Connect om de aanmelding in de browser te openen en keur daarna de organisatie en rechten goed.

Aangepaste connectors zijn beschikbaar bij Free, Pro, Max, Team en Enterprise. Bij Free-abonnementen is één aangepaste connector toegestaan. Bij Team en Enterprise voegt een Owner de connector toe en verbindt elk lid afzonderlijk.

Claude op het web

Hetzelfde account, dezelfde stappen als bij Claude Desktop.

Individueel (Free, Pro, Max): Settings → Connectors → Add custom connector, vul een naam en https://api.zippendo.com/mcp in, klik op Add en daarna op Connect.
Team en Enterprise: een Owner voegt hem eenmalig toe onder Organization settings → Connectors → Add → Custom. Leden openen daarna Settings → Connectors, zoeken de connector en klikken op Connect. Elk lid verbindt met zijn of haar eigen toegang.

Cursor

Voeg hem toe in de instellingen of met een configuratiebestand.

Open de MCP-instellingen

Open Cursor Settings → Tools & MCP → New MCP Server. Dit opent je mcp.json.

Voeg de server toe

mcp.json

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

De globale configuratie staat in ~/.cursor/mcp.json, de configuratie per project in .cursor/mcp.json.

Meld je aan

Naast de server verschijnt een bediening Login. Klik erop om de aanmelding in de browser uit te voeren.

Installeren met één klik: Zippendo toevoegen aan Cursor. Cursor vraagt je om goedkeuring en schrijft de vermelding voor je.

VS Code (GitHub Copilot)

Vereist VS Code 1.102 of nieuwer met GitHub Copilot. Gebruik de tools vanuit Copilot Chat in de modus Agent.

Voeg de server toe

Command Palette → MCP: Add Server → HTTP, plak https://api.zippendo.com/mcp en kies daarna Workspace (schrijft .vscode/mcp.json) of Global.

Verifieer

Boven de serververmelding in mcp.json verschijnt een actie Auth. Rond de aanmelding in de browser af.

De VS Code-configuratie gebruikt een sleutel servers op het hoogste niveau (niet mcpServers):

.vscode/mcp.json

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

Windsurf

Bewerk ~/.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 gebruikt serverUrl (niet url) voor Streamable HTTP-servers. OAuth wordt ondersteund, maar opent de aanmelding in de browser niet, werk Windsurf dan bij naar de nieuwste versie.

ChatGPT

Aangepaste MCP-connectors voeg je toe via Developer Mode, alleen in de webversie (geen configuratiebestand).

Zet Developer Mode aan

Zet Settings → Connectors → Advanced → Developer Mode aan.

Voeg de connector toe

Voeg terug in Connectors een aangepaste connector toe met de URL https://api.zippendo.com/mcp. ChatGPT vraagt je de eerste keer dat je verbindt om je aan te melden.

Developer Mode is in beta bij Plus, Pro, Business, Enterprise en Edu. Volledige toolaanroepen (schrijfacties zoals het aanmaken van een zending) zijn beperkt tot Business, Enterprise en Edu. Plus en Pro zijn feitelijk alleen-lezen. Schrijfacties vragen elke keer om bevestiging. ChatGPT kan de namen van menu’s en de beschikbaarheid wijzigen.

OpenAI Codex CLI

Gebruik een recente Codex CLI (oudere versies ondersteunden alleen lokale servers). Voeg de server toe in het configuratiebestand of met de 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

Heeft jouw Codex-versie geen --url of codex mcp login, werk dan bij naar de nieuwste Codex CLI.

Gemini CLI

Bewerk ~/.gemini/settings.json. Streamable HTTP-servers gebruiken het veld httpUrl.

~/.gemini/settings.json

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

Gemini CLI vindt de OAuth-aanmelding zelf. Voer in een sessie /mcp auth uit (of /mcp om te zien welke servers het nodig hebben) om de aanmelding in de browser te openen.

Elke andere MCP-client

De meeste clients accepteren de standaardinstelling voor externe servers, met alleen de URL:

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

Volgt je client de MCP-autorisatiespecificatie, dan vindt hij de aanmelding en voert hij OAuth voor je uit. Keur daarna de organisatie en rechten goed op de Zippendo-aanmeldpagina die hij opent.

Problemen oplossen

De aanmelding in de browser opent nooit

Controleer of je client externe MCP via OAuth ondersteunt en of je de nieuwste versie hebt. Sommige clients hebben externe connectors pas in recente versies toegevoegd.

De agent ziet een benodigde tool niet

Tools worden gefilterd op de rechten die je hebt goedgekeurd. Verbind opnieuw en verleen het ontbrekende recht op het toestemmingsscherm (bijvoorbeeld write:shipments om zendingen aan te maken). Zie Tools en scopes.

Het werkt in de verkeerde organisatie

Elke verbinding hoort bij één organisatie. Verbreek de verbinding, verbind opnieuw en kies op het toestemmingsscherm de juiste organisatie. Zie Authenticatie.

De aanmelding weigert je account

Als je teamlidaccount tot één merk is beperkt, kun je geen agent verbinden. Vraag een organisatie-eigenaar om je toegang te geven tot de hele organisatie, of om de agent zelf te verbinden.

Een configuratie met alleen een url wordt geweigerd

Sommige clients willen dat het transporttype expliciet wordt vermeld. Voeg "type": "http" toe naast de url (Claude Code, VS Code), of gebruik de HTTP-optie van die client wanneer je de server toevoegt.

Start

Quickstarts

Fulfillment flow

Connections

Operations

Organization & account

Je agent verbinden

Connector-URL

Instellen vanuit de Zippendo-app

Claude Code

Claude Desktop

Claude op het web

Cursor

VS Code (GitHub Copilot)

Windsurf

ChatGPT

OpenAI Codex CLI

Gemini CLI

Elke andere MCP-client

Problemen oplossen

Connector-URL

​Instellen vanuit de Zippendo-app

​Claude Code

​Claude Desktop

​Claude op het web

​Cursor

​VS Code (GitHub Copilot)

​Windsurf

​ChatGPT

​OpenAI Codex CLI

​Gemini CLI

​Elke andere MCP-client

​Problemen oplossen

Instellen vanuit de Zippendo-app

Claude Code

Claude Desktop

Claude op het web

Cursor

VS Code (GitHub Copilot)

Windsurf

ChatGPT

OpenAI Codex CLI

Gemini CLI

Elke andere MCP-client

Problemen oplossen