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

# Koble til agenten din

> Steg-for-steg-oppsett for å koble Claude, Cursor, VS Code, Windsurf, ChatGPT og andre AI-agenter til Zippendo MCP-serveren.

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.

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

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

## Sett det opp fra Zippendo-appen

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

<Steps>
  <Step title="Åpne MCP-kortet">
    Gå til **Apps & integrations** → **Catalog**, finn **MCP (AI agents)** og klikk på **Connect**. Vinduet **Connect an AI agent** åpnes.
  </Step>

  <Step title="Velg agent">
    Velg AI-verktøyet ditt. Alle MCP-klienter fungerer; listen viser de som har egne instruksjoner.
  </Step>

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

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

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.

<Steps>
  <Step title="Legg til serveren">
    ```bash theme={null}
    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).
  </Step>

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

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

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

<Steps>
  <Step title="Åpne Connectors">
    Gå til **Settings → Connectors** og klikk på **Add custom connector**.
  </Step>

  <Step title="Legg til nettadressen">
    Gi den navnet `Zippendo`, skriv inn `https://api.zippendo.com/mcp` og klikk på **Add**.
  </Step>

  <Step title="Koble til">
    Klikk på **Connect** for å åpne innloggingen i nettleseren, og godkjenn deretter organisasjonen og tillatelsene.
  </Step>
</Steps>

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

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

<Steps>
  <Step title="Åpne MCP-innstillingene">
    Åpne **Cursor Settings → Tools & MCP → New MCP Server**. Dette åpner din `mcp.json`.
  </Step>

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

    Den globale konfigurasjonen ligger i `~/.cursor/mcp.json`, konfigurasjonen per prosjekt i `.cursor/mcp.json`.
  </Step>

  <Step title="Logg inn">
    En **Login**-kontroll vises ved siden av serveren. Klikk på den for å kjøre innloggingen i nettleseren.
  </Step>
</Steps>

<Tip>
  Installasjon med ett klikk: [**Legg Zippendo til i Cursor**](cursor://anysphere.cursor-deeplink/mcp/install?name=zippendo\&config=eyJ1cmwiOiJodHRwczovL2FwaS56aXBwZW5kby5jb20vbWNwIn0=).
  Cursor ber deg godkjenne og skriver oppføringen for deg.
</Tip>

## VS Code (GitHub Copilot)

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

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

  <Step title="Autentiser">
    En handling **Auth** vises over serveroppføringen i `mcp.json`. Fullfør innloggingen i nettleseren.
  </Step>
</Steps>

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

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

## Windsurf

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

## ChatGPT

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

<Steps>
  <Step title="Slå på Developer Mode">
    Slå på **Settings → Connectors → Advanced → Developer Mode**.
  </Step>

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

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

## OpenAI Codex CLI

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

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

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

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

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

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

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

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

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

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


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