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

# Anslut din agent

> Steg-för-steg-installation för att ansluta Claude, Cursor, VS Code, Windsurf, ChatGPT och andra AI-agenter till Zippendos MCP-server.

Anslut ditt AI-verktyg till Zippendo så att det kan arbeta med dina försändelser, ordrar och transportörer åt dig. Lägg till webbadressen nedan i verktyget som en egen MCP-connector. Verktyget öppnar inloggningen till Zippendo i din webbläsare och håller anslutningen vid liv av sig självt: inget att installera och ingen API-token att klistra in.

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

<Info>
  Servern stöder dynamisk klientregistrering, så en kompatibel klient behöver **bara webbadressen**: inget klient-ID, ingen klienthemlighet och ingen inklistrad API-token. Vid första anslutningen hittar den inloggningen, registrerar sig själv och öppnar din webbläsare så att du kan logga in och godkänna åtkomsten. Se [Autentisering](/docs/sv/mcp/authentication).
</Info>

## Ställ in det från Zippendo-appen

Appen guidar dig genom samma steg för ditt verktyg:

<Steps>
  <Step title="Öppna kortet MCP">
    Gå till **Apps & integrations** → **Catalog**, hitta **MCP (AI agents)** och klicka på **Connect**. Fönstret **Connect an AI agent** öppnas.
  </Step>

  <Step title="Välj agent">
    Välj ditt AI-verktyg. Vilken MCP-klient som helst fungerar; listan visar de som har namngivna instruktioner.
  </Step>

  <Step title="Lägg till connectorn">
    Följ stegen för ditt verktyg. **Connector URL** har en knapp **Copy**. När du har lagt till den klickar du på **I've added it**.
  </Step>

  <Step title="Godkänn åtkomst">
    Slutför inloggningen som ditt verktyg öppnade och godkänn organisationen och behörigheterna. Fönstret uppdateras av sig självt så fort anslutningen är gjord. Klicka på **Done**.
  </Step>
</Steps>

Varje ansluten agent visas sedan på kortet **MCP (AI agents)** med när den senast användes och hur många behörigheter den har. Klicka på **Disconnect** för att ta bort dess åtkomst, eller på **Connect another** för att lägga till en till. Stegen för varje verktyg finns också nedan.

## Claude Code

Lägg till servern med CLI och autentisera sedan inifrån en session.

<Steps>
  <Step title="Lägg till servern">
    ```bash theme={null}
    claude mcp add --transport http zippendo https://api.zippendo.com/mcp
    ```

    Använd `--scope user` för att göra den tillgänglig i varje projekt, eller `--scope project` för att checka in den i repots `.mcp.json` åt ditt team (standard är lokalt: bara du, i det aktuella projektet).
  </Step>

  <Step title="Autentisera">
    Starta Claude Code, kör `/mcp`, välj **zippendo** och välj **Authenticate**. Din webbläsare öppnar Zippendos godkännandesida. Godkänn, så är du ansluten. Kör `/mcp` igen när som helst för att kontrollera status eller autentisera igen.
  </Step>
</Steps>

För att dela servern med ditt team checkar du in en `.mcp.json` för projektet:

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

Hantera anslutningen med `claude mcp list`, `claude mcp get zippendo` och `claude mcp remove zippendo`.

## Claude Desktop

<Steps>
  <Step title="Öppna Connectors">
    Gå till **Settings → Connectors** och klicka på **Add custom connector**.
  </Step>

  <Step title="Lägg till webbadressen">
    Ge den namnet `Zippendo`, ange `https://api.zippendo.com/mcp` och klicka på **Add**.
  </Step>

  <Step title="Anslut">
    Klicka på **Connect** för att öppna inloggningen i webbläsaren och godkänn sedan organisationen och behörigheterna.
  </Step>
</Steps>

<Note>
  Egna connectors finns på Free, Pro, Max, Team och Enterprise. Free-planer tillåter en egen connector. På Team och Enterprise lägger en Owner till connectorn och varje medlem ansluter individuellt.
</Note>

## Claude på webben

Samma konto, samma steg som i Claude Desktop.

* **Individuellt (Free, Pro, Max):** **Settings → Connectors → Add custom connector**, ange ett namn och `https://api.zippendo.com/mcp`, klicka på **Add** och sedan på **Connect**.
* **Team och Enterprise:** en **Owner** lägger till den en gång under **Organization settings → Connectors → Add → Custom**. Medlemmar öppnar sedan **Settings → Connectors**, hittar connectorn och klickar på **Connect**. Varje medlem ansluter med sin egen åtkomst.

## Cursor

Lägg till den i inställningarna eller med en konfigurationsfil.

<Steps>
  <Step title="Öppna MCP-inställningarna">
    Öppna **Cursor Settings → Tools & MCP → New MCP Server**. Då öppnas din `mcp.json`.
  </Step>

  <Step title="Lägg till servern">
    ```json mcp.json theme={null}
    {
      "mcpServers": {
        "zippendo": {
          "url": "https://api.zippendo.com/mcp"
        }
      }
    }
    ```

    Den globala konfigurationen finns i `~/.cursor/mcp.json` och projektkonfigurationen i `.cursor/mcp.json`.
  </Step>

  <Step title="Logga in">
    En **Login**-kontroll visas bredvid servern. Klicka på den för att köra inloggningen i webbläsaren.
  </Step>
</Steps>

<Tip>
  Installation med ett klick: [**Add Zippendo to Cursor**](cursor://anysphere.cursor-deeplink/mcp/install?name=zippendo\&config=eyJ1cmwiOiJodHRwczovL2FwaS56aXBwZW5kby5jb20vbWNwIn0=).
  Cursor ber dig godkänna och skriver in posten åt dig.
</Tip>

## VS Code (GitHub Copilot)

Kräver VS Code 1.102 eller senare med GitHub Copilot. Använd verktygen från Copilot Chat i läget **Agent**.

<Steps>
  <Step title="Lägg till servern">
    Command Palette → **MCP: Add Server** → **HTTP**, klistra in `https://api.zippendo.com/mcp` och välj sedan **Workspace** (skriver `.vscode/mcp.json`) eller **Global**.
  </Step>

  <Step title="Autentisera">
    En åtgärd **Auth** visas ovanför serverposten i `mcp.json`. Slutför inloggningen i webbläsaren.
  </Step>
</Steps>

VS Code-konfigurationen använder en nyckel `servers` på toppnivå (inte `mcpServers`):

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

## Windsurf

Redigera `~/.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 använder `serverUrl` (inte `url`) för Streamable HTTP-servrar. OAuth stöds, men om inloggningen i webbläsaren inte öppnas uppdaterar du Windsurf till den senaste versionen.
</Warning>

## ChatGPT

Egna MCP-connectors läggs till via **Developer Mode**, bara i webbversionen (ingen konfigurationsfil).

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

  <Step title="Lägg till connectorn">
    Tillbaka i **Connectors** lägger du till en egen connector med webbadressen `https://api.zippendo.com/mcp`. ChatGPT ber dig logga in första gången du ansluter.
  </Step>
</Steps>

<Warning>
  Developer Mode är i **beta** på Plus, Pro, Business, Enterprise och Edu. Fullständiga verktygsanrop (skrivåtgärder som att skapa en försändelse) är begränsade till **Business, Enterprise och Edu**. Plus och Pro är i praktiken skrivskyddade. Skrivåtgärder kräver en bekräftelse varje gång. ChatGPT kan ändra namnen på sina menyer och sin tillgänglighet.
</Warning>

## OpenAI Codex CLI

Använd en ny Codex CLI (äldre versioner stödde bara lokala servrar). Lägg till servern i konfigurationsfilen eller med 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
```

Om din Codex-version saknar `--url` eller `codex mcp login` uppdaterar du till den senaste Codex CLI.

## Gemini CLI

Redigera `~/.gemini/settings.json`. Streamable HTTP-servrar använder fältet `httpUrl`.

```json ~/.gemini/settings.json theme={null}
{
  "mcpServers": {
    "zippendo": {
      "httpUrl": "https://api.zippendo.com/mcp"
    }
  }
}
```

Gemini CLI hittar OAuth-inloggningen av sig självt. Kör `/mcp auth` i en session (eller `/mcp` för att se vilka servrar som behöver det) för att öppna inloggningen i webbläsaren.

## Vilken annan MCP-klient som helst

De flesta klienter accepterar den vanliga fjärrkonfigurationen, med bara webbadressen:

```json theme={null}
{
  "mcpServers": {
    "zippendo": {
      "url": "https://api.zippendo.com/mcp"
    }
  }
}
```

Om din klient följer MCP-specifikationen för auktorisering hittar den inloggningen och kör OAuth åt dig. Godkänn sedan organisationen och behörigheterna på Zippendos inloggningssida som den öppnar.

## Felsökning

<AccordionGroup>
  <Accordion title="Inloggningen i webbläsaren öppnas aldrig">
    Kontrollera att din klient stöder **remote MCP over OAuth** och att du har dess senaste version. Vissa klienter har bara nyligen fått stöd för fjärranslutna connectors.
  </Accordion>

  <Accordion title="Agenten ser inte ett verktyg den behöver">
    Verktygen filtreras efter de behörigheter du godkände. Anslut igen och ge den saknade behörigheten på godkännandesidan (till exempel `write:shipments` för att skapa försändelser). Se [Verktyg och scopes](/docs/sv/mcp/tools).
  </Accordion>

  <Accordion title="Det fungerar i fel organisation">
    Varje anslutning tillhör en organisation. Koppla från, anslut igen och välj rätt organisation på godkännandesidan. Se [Autentisering](/docs/sv/mcp/authentication).
  </Accordion>

  <Accordion title="Inloggningen avvisar ditt konto">
    Om ditt teammedlemskonto är begränsat till ett varumärke kan du inte ansluta en agent. Be en organisationsägare ge dig åtkomst till hela organisationen, eller ansluta agenten själv.
  </Accordion>

  <Accordion title="En konfiguration med bara en url avvisas">
    Vissa klienter behöver att transporttypen anges uttryckligen. Lägg till `"type": "http"` bredvid `url` (Claude Code, VS Code), eller använd klientens HTTP-alternativ när du lägger till servern.
  </Accordion>
</AccordionGroup>


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