Koble til agenten din

Koble AI-verktøyet ditt til Zippendo slik at det kan jobbe med sendingene, ordrene og transportørene dine for deg. Legg til nettadressen nedenfor i verktøyet som en egendefinert MCP-kobling. Verktøyet åpner Zippendo-innloggingen i nettleseren din og holder tilkoblingen oppdatert av seg selv: ingenting å installere og ingen token å lime inn.

Connector URL

https://api.zippendo.com/mcp

Serveren støtter dynamisk klientregistrering, så en klient som følger standarden, trenger bare nettadressen: ingen klient-ID, ingen klienthemmelighet og ingen innlimt token. Ved første tilkobling finner den innloggingen, registrerer seg selv og åpner nettleseren din slik at du kan logge inn og godkjenne tilgangen. Se Autentisering.

Sett det opp fra Zippendo-appen

Appen leder deg gjennom de samme trinnene for verktøyet ditt:

Åpne MCP-kortet

Gå til Apps & integrations → Catalog, finn MCP (AI agents) og klikk på Connect. Vinduet Connect an AI agent åpnes.

Velg agent

Velg AI-verktøyet ditt. Alle MCP-klienter fungerer; listen viser de som har egne instruksjoner.

Legg til koblingen

Følg trinnene for verktøyet ditt. Connector URL har en knapp Copy. Når du har lagt den til, klikker du på I’ve added it.

Godkjenn tilgang

Fullfør innloggingen verktøyet åpnet, og godkjenn organisasjonen og tillatelsene. Vinduet oppdateres av seg selv så snart tilkoblingen er opprettet. Klikk på Done.

Hver tilkoblede agent vises da på kortet MCP (AI agents) med når den sist ble brukt og hvor mange tillatelser den har. Klikk på Disconnect for å fjerne tilgangen, eller Connect another for å legge til en til. Trinnene for hvert verktøy står også nedenfor.

Claude Code

Legg til serveren med kommandolinjen, og autentiser deretter fra en økt.

Legg til serveren

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

Bruk --scope user for å gjøre den tilgjengelig i alle prosjekter, eller --scope project for å sjekke den inn i repoets .mcp.json for teamet ditt (standard er lokal: bare du, i det gjeldende prosjektet).

Autentiser

Start Claude Code, kjør /mcp, velg zippendo og velg Authenticate. Nettleseren din åpner samtykkeskjermen til Zippendo. Godkjenn, så er du tilkoblet. Kjør /mcp igjen når som helst for å sjekke statusen eller autentisere på nytt.

For å dele serveren med teamet ditt sjekker du inn en prosjektfil .mcp.json:

.mcp.json

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

Administrer tilkoblingen med claude mcp list, claude mcp get zippendo og claude mcp remove zippendo.

Claude Desktop

Åpne Connectors

Gå til Settings → Connectors og klikk på Add custom connector.

Legg til nettadressen

Gi den navnet Zippendo, skriv inn https://api.zippendo.com/mcp og klikk på Add.

Koble til

Klikk på Connect for å åpne innloggingen i nettleseren, og godkjenn deretter organisasjonen og tillatelsene.

Egendefinerte koblinger er tilgjengelige på Free, Pro, Max, Team og Enterprise. Free-planer tillater én egendefinert kobling. På Team og Enterprise legger en Owner til koblingen, og hvert medlem kobler til for seg.

Claude på nettet

Samme konto, samme trinn som i Claude Desktop.

Enkeltperson (Free, Pro, Max): Settings → Connectors → Add custom connector, skriv inn et navn og https://api.zippendo.com/mcp, klikk på Add, deretter på Connect.
Team og Enterprise: en Owner legger den til én gang under Organization settings → Connectors → Add → Custom. Medlemmene åpner deretter Settings → Connectors, finner koblingen og klikker på Connect. Hvert medlem kobler til med sin egen tilgang.

Cursor

Legg den til i innstillingene eller med en konfigurasjonsfil.

Åpne MCP-innstillingene

Åpne Cursor Settings → Tools & MCP → New MCP Server. Dette åpner din mcp.json.

Legg til serveren

mcp.json

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

Den globale konfigurasjonen ligger i ~/.cursor/mcp.json, konfigurasjonen per prosjekt i .cursor/mcp.json.

Logg inn

En Login-kontroll vises ved siden av serveren. Klikk på den for å kjøre innloggingen i nettleseren.

Installasjon med ett klikk: Legg Zippendo til i Cursor. Cursor ber deg godkjenne og skriver oppføringen for deg.

VS Code (GitHub Copilot)

Krever VS Code 1.102 eller nyere med GitHub Copilot. Bruk verktøyene fra Copilot Chat i modusen Agent.

Legg til serveren

Command Palette → MCP: Add Server → HTTP, lim inn https://api.zippendo.com/mcp, og velg deretter Workspace (skriver .vscode/mcp.json) eller Global.

Autentiser

En handling Auth vises over serveroppføringen i mcp.json. Fullfør innloggingen i nettleseren.

VS Code-konfigurasjonen bruker nøkkelen servers på øverste nivå (ikke mcpServers):

.vscode/mcp.json

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

Windsurf

Rediger ~/.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 bruker serverUrl (ikke url) for Streamable HTTP-servere. OAuth støttes, men hvis innloggingen i nettleseren ikke åpnes, oppdater Windsurf til nyeste versjon.

ChatGPT

Egendefinerte MCP-koblinger legges til gjennom Developer Mode, bare i nettversjonen (ingen konfigurasjonsfil).

Slå på Developer Mode

Slå på Settings → Connectors → Advanced → Developer Mode.

Legg til koblingen

Tilbake i Connectors legger du til en egendefinert kobling med nettadressen https://api.zippendo.com/mcp. ChatGPT ber deg logge inn første gang du kobler til.

Developer Mode er i beta på Plus, Pro, Business, Enterprise og Edu. Full verktøybruk (skrivehandlinger som å opprette en sending) er begrenset til Business, Enterprise og Edu. Plus og Pro er i praksis skrivebeskyttet. Skrivehandlinger krever en bekreftelse hver gang. ChatGPT kan endre menynavn og tilgjengelighet.

OpenAI Codex CLI

Bruk en nyere Codex CLI (eldre versjoner støttet bare lokale servere). Legg til serveren i konfigurasjonsfilen eller med kommandolinjen.

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

Hvis Codex-versjonen din ikke har --url eller codex mcp login, oppdater til nyeste Codex CLI.

Gemini CLI

Rediger ~/.gemini/settings.json. Streamable HTTP-servere bruker feltet httpUrl.

~/.gemini/settings.json

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

Gemini CLI finner OAuth-innloggingen selv. I en økt kjører du /mcp auth (eller /mcp for å se hvilke servere som trenger det) for å åpne innloggingen i nettleseren.

Alle andre MCP-klienter

De fleste klienter godtar standardoppsettet for eksterne servere, med bare nettadressen:

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

Hvis klienten din følger MCP-autorisasjonsstandarden, finner den innloggingen og kjører OAuth for deg. Godkjenn deretter organisasjonen og tillatelsene på Zippendo-innloggingssiden den åpner.

Feilsøking

Innloggingen i nettleseren åpnes aldri

Sjekk at klienten din støtter ekstern MCP over OAuth og at du har nyeste versjon. Noen klienter har først nylig fått eksterne koblinger.

Agenten ser ikke et verktøy den trenger

Verktøy filtreres etter tillatelsene du godkjente. Koble til på nytt og gi den manglende tillatelsen på samtykkeskjermen (for eksempel write:shipments for å opprette sendinger). Se Verktøy og scopes.

Det fungerer i feil organisasjon

Hver tilkobling tilhører én organisasjon. Koble fra, koble til på nytt, og velg riktig organisasjon på samtykkeskjermen. Se Autentisering.

Innloggingen avviser kontoen din

Hvis teammedlemskontoen din er begrenset til én merkevare, kan du ikke koble til en agent. Be en organisasjonseier gi deg tilgang til hele organisasjonen, eller koble til agenten selv.

En konfigurasjon med bare en url avvises

Noen klienter trenger at transporttypen står eksplisitt. Legg til "type": "http" ved siden av url (Claude Code, VS Code), eller bruk klientens HTTP-valg når du legger til serveren.

Start

Quickstarts

Fulfillment flow

Connections

Operations

Organization & account

Koble til agenten din

Connector URL

Sett det opp fra Zippendo-appen

Claude Code

Claude Desktop

Claude på nettet

Cursor

VS Code (GitHub Copilot)

Windsurf

ChatGPT

OpenAI Codex CLI

Gemini CLI

Alle andre MCP-klienter

Feilsøking

Connector URL

​Sett det opp fra Zippendo-appen

​Claude Code

​Claude Desktop

​Claude på nettet

​Cursor

​VS Code (GitHub Copilot)

​Windsurf

​ChatGPT

​OpenAI Codex CLI

​Gemini CLI

​Alle andre MCP-klienter

​Feilsøking

Sett det opp fra Zippendo-appen

Claude Code

Claude Desktop

Claude på nettet

Cursor

VS Code (GitHub Copilot)

Windsurf

ChatGPT

OpenAI Codex CLI

Gemini CLI

Alle andre MCP-klienter

Feilsøking