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

# Je agent verbinden

> Stapsgewijze instelling om Claude, Cursor, VS Code, Windsurf, ChatGPT en andere AI-agents te verbinden met de Zippendo MCP-server.

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.

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

<Info>
  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](/docs/nl/mcp/authentication).
</Info>

## Instellen vanuit de Zippendo-app

De app begeleidt je bij dezelfde stappen voor jouw tool:

<Steps>
  <Step title="Open de MCP-kaart">
    Ga naar **Apps & integrations** → **Catalog**, zoek **MCP (AI agents)** en klik op **Connect**. Het venster **Connect an AI agent** opent.
  </Step>

  <Step title="Kies een agent">
    Kies je AI-tool. Elke MCP-client werkt; de lijst toont de clients met eigen instructies.
  </Step>

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

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

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.

<Steps>
  <Step title="Voeg de server toe">
    ```bash theme={null}
    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).
  </Step>

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

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

```json .mcp.json theme={null}
{
  "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

<Steps>
  <Step title="Open Connectors">
    Ga naar **Settings → Connectors** en klik op **Add custom connector**.
  </Step>

  <Step title="Voeg de URL toe">
    Noem hem `Zippendo`, vul `https://api.zippendo.com/mcp` in en klik op **Add**.
  </Step>

  <Step title="Verbind">
    Klik op **Connect** om de aanmelding in de browser te openen en keur daarna de organisatie en rechten goed.
  </Step>
</Steps>

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

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

<Steps>
  <Step title="Open de MCP-instellingen">
    Open **Cursor Settings → Tools & MCP → New MCP Server**. Dit opent je `mcp.json`.
  </Step>

  <Step title="Voeg de server toe">
    ```json mcp.json theme={null}
    {
      "mcpServers": {
        "zippendo": {
          "url": "https://api.zippendo.com/mcp"
        }
      }
    }
    ```

    De globale configuratie staat in `~/.cursor/mcp.json`, de configuratie per project in `.cursor/mcp.json`.
  </Step>

  <Step title="Meld je aan">
    Naast de server verschijnt een bediening **Login**. Klik erop om de aanmelding in de browser uit te voeren.
  </Step>
</Steps>

<Tip>
  Installeren met één klik: [**Zippendo toevoegen aan Cursor**](cursor://anysphere.cursor-deeplink/mcp/install?name=zippendo\&config=eyJ1cmwiOiJodHRwczovL2FwaS56aXBwZW5kby5jb20vbWNwIn0=).
  Cursor vraagt je om goedkeuring en schrijft de vermelding voor je.
</Tip>

## VS Code (GitHub Copilot)

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

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

  <Step title="Verifieer">
    Boven de serververmelding in `mcp.json` verschijnt een actie **Auth**. Rond de aanmelding in de browser af.
  </Step>
</Steps>

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

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

## Windsurf

Bewerk `~/.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 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.
</Warning>

## ChatGPT

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

<Steps>
  <Step title="Zet Developer Mode aan">
    Zet **Settings → Connectors → Advanced → Developer Mode** aan.
  </Step>

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

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

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

```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
```

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

```json ~/.gemini/settings.json theme={null}
{
  "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:

```json theme={null}
{
  "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

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="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](/docs/nl/mcp/tools).
  </Accordion>

  <Accordion title="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](/docs/nl/mcp/authentication).
  </Accordion>

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

  <Accordion title="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.
  </Accordion>
</AccordionGroup>


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