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

# Yhdistä agenttisi

> Vaiheittainen ohje Clauden, Cursorin, VS Coden, Windsurfin, ChatGPT:n ja muiden tekoälyagenttien yhdistämiseen Zippendo MCP -palvelimeen.

Yhdistä tekoälytyökalusi Zippendo-palveluun, jotta se voi työskennellä lähetystesi, tilaustesi ja kuljetusyhtiöidesi kanssa puolestasi. Lisää alla oleva URL työkaluun mukautettuna MCP-yhdistimenä (custom MCP connector). Työkalu avaa Zippendo-palvelun kirjautumisen selaimessasi ja pitää yhteyden ajan tasalla itse: mitään ei tarvitse asentaa eikä mitään tokenia liittää.

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

<Info>
  Palvelin tukee dynaamista asiakasrekisteröintiä (dynamic client registration), joten yhteensopiva asiakasohjelma tarvitsee **vain URL-osoitteen**: ei client ID:tä, ei client secretiä, ei liitettyä tokenia. Ensimmäisellä yhdistämisellä se löytää kirjautumisen, rekisteröityy itse ja avaa selaimesi, jotta voit kirjautua sisään ja hyväksyä pääsyn. Katso [Tunnistautuminen](/docs/fi/mcp/authentication).
</Info>

## Ota käyttöön Zippendo-sovelluksesta

Sovellus käy läpi samat vaiheet työkalullesi:

<Steps>
  <Step title="Avaa MCP-kortti">
    Mene kohtaan **Apps & integrations** → **Catalog**, etsi **MCP (AI agents)** ja klikkaa **Connect**. **Connect an AI agent** -ikkuna aukeaa.
  </Step>

  <Step title="Valitse agentti">
    Valitse tekoälytyökalusi. Mikä tahansa MCP-asiakasohjelma toimii; luettelo näyttää ne, joille on nimetyt ohjeet.
  </Step>

  <Step title="Lisää yhdistin">
    Seuraa työkalusi vaiheita. **Connector URL** -kentässä on **Copy**-painike. Kun olet lisännyt sen, klikkaa **I've added it**.
  </Step>

  <Step title="Hyväksy pääsy">
    Viimeistele kirjautuminen, jonka työkalusi avasi, ja hyväksy organisaatio ja oikeudet. Ikkuna päivittyy itse heti, kun yhteys on muodostettu. Klikkaa **Done**.
  </Step>
</Steps>

Jokainen yhdistetty agentti näkyy sitten **MCP (AI agents)** -kortilla sekä tiedolla siitä, milloin sitä käytettiin viimeksi ja kuinka monta oikeutta sillä on. Klikkaa **Disconnect** poistaaksesi sen pääsyn tai **Connect another** lisätäksesi vielä yhden. Kunkin työkalun vaiheet ovat myös alla.

## Claude Code

Lisää palvelin komentorivillä (CLI) ja tunnistaudu sitten istunnon sisällä.

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

    Käytä `--scope user`, jos haluat sen käyttöön jokaisessa projektissa, tai `--scope project`, jos haluat tallentaa sen repositorion `.mcp.json`-tiedostoon tiimillesi (oletus on local: vain sinä, nykyisessä projektissa).
  </Step>

  <Step title="Tunnistaudu">
    Käynnistä Claude Code, suorita `/mcp`, valitse **zippendo** ja valitse **Authenticate**. Selaimesi avaa Zippendo-palvelun hyväksyntänäkymän. Hyväksy, niin olet yhdistetty. Suorita `/mcp` uudelleen milloin tahansa tarkistaaksesi tilan tai tunnistautuaksesi uudelleen.
  </Step>
</Steps>

Jos haluat jakaa palvelimen tiimisi kanssa, tallenna projektin `.mcp.json`:

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

Hallitse yhteyttä komennoilla `claude mcp list`, `claude mcp get zippendo` ja `claude mcp remove zippendo`.

## Claude Desktop

<Steps>
  <Step title="Avaa Connectors">
    Mene kohtaan **Settings → Connectors** ja klikkaa **Add custom connector**.
  </Step>

  <Step title="Lisää URL">
    Nimeä se `Zippendo`, kirjoita `https://api.zippendo.com/mcp` ja klikkaa **Add**.
  </Step>

  <Step title="Yhdistä">
    Klikkaa **Connect** avataksesi selainkirjautumisen ja hyväksy sitten organisaatio ja oikeudet.
  </Step>
</Steps>

<Note>
  Mukautetut yhdistimet ovat saatavilla palvelupaketeissa Free, Pro, Max, Team ja Enterprise. Free-palvelupaketit sallivat yhden mukautetun yhdistimen. Palvelupaketeissa Team ja Enterprise Owner lisää yhdistimen ja jokainen jäsen yhdistää erikseen.
</Note>

## Claude verkossa

Sama tili, samat vaiheet kuin Claude Desktopissa.

* **Yksittäinen käyttäjä (Free, Pro, Max):** **Settings → Connectors → Add custom connector**, kirjoita nimi ja `https://api.zippendo.com/mcp`, klikkaa **Add** ja sitten **Connect**.
* **Team ja Enterprise:** **Owner** lisää sen kerran kohdassa **Organization settings → Connectors → Add → Custom**. Jäsenet avaavat sitten **Settings → Connectors**, etsivät yhdistimen ja klikkaavat **Connect**. Jokainen jäsen yhdistää omilla oikeuksillaan.

## Cursor

Lisää se asetuksissa tai asetustiedostolla.

<Steps>
  <Step title="Avaa MCP-asetukset">
    Avaa **Cursor Settings → Tools & MCP → New MCP Server**. Tämä avaa `mcp.json`-tiedostosi.
  </Step>

  <Step title="Lisää palvelin">
    ```json mcp.json theme={null}
    {
      "mcpServers": {
        "zippendo": {
          "url": "https://api.zippendo.com/mcp"
        }
      }
    }
    ```

    Yleinen asetustiedosto sijaitsee polussa `~/.cursor/mcp.json` ja projektikohtainen polussa `.cursor/mcp.json`.
  </Step>

  <Step title="Kirjaudu sisään">
    Palvelimen viereen ilmestyy **Login**-toiminto. Klikkaa sitä suorittaaksesi selainkirjautumisen.
  </Step>
</Steps>

<Tip>
  Asennus yhdellä klikkauksella: [**Lisää Zippendo Cursor-ohjelmaan**](cursor://anysphere.cursor-deeplink/mcp/install?name=zippendo\&config=eyJ1cmwiOiJodHRwczovL2FwaS56aXBwZW5kby5jb20vbWNwIn0=).
  Cursor pyytää sinua hyväksymään ja kirjoittaa merkinnän puolestasi.
</Tip>

## VS Code (GitHub Copilot)

Tarvitsee VS Coden version 1.102 tai uudemman sekä GitHub Copilotin. Käytä työkaluja Copilot Chatista **Agent**-tilassa.

<Steps>
  <Step title="Lisää palvelin">
    Command Palette → **MCP: Add Server** → **HTTP**, liitä `https://api.zippendo.com/mcp` ja valitse sitten **Workspace** (kirjoittaa `.vscode/mcp.json`) tai **Global**.
  </Step>

  <Step title="Tunnistaudu">
    **Auth**-toiminto ilmestyy palvelinmerkinnän yläpuolelle tiedostossa `mcp.json`. Suorita selainkirjautuminen loppuun.
  </Step>
</Steps>

VS Coden asetus käyttää ylätason avainta `servers` (ei `mcpServers`):

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

## Windsurf

Muokkaa tiedostoa `~/.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 käyttää Streamable HTTP -palvelimille avainta `serverUrl` (ei `url`). OAuth on tuettu, mutta jos selainkirjautuminen ei aukea, päivitä Windsurf uusimpaan versioon.
</Warning>

## ChatGPT

Mukautetut MCP-yhdistimet lisätään **Developer Mode** -tilassa, vain verkkoversiossa (ei asetustiedostoa).

<Steps>
  <Step title="Ota Developer Mode käyttöön">
    Kytke päälle **Settings → Connectors → Advanced → Developer Mode**.
  </Step>

  <Step title="Lisää yhdistin">
    Takaisin kohdassa **Connectors**, lisää mukautettu yhdistin URL-osoitteella `https://api.zippendo.com/mcp`. ChatGPT pyytää sinua kirjautumaan sisään ensimmäisellä yhdistämiskerralla.
  </Step>
</Steps>

<Warning>
  Developer Mode on **beta**-vaiheessa palvelupaketeissa Plus, Pro, Business, Enterprise ja Edu. Täysi työkalukutsujen tuki (kirjoitustoiminnot, kuten lähetyksen luonti) on rajattu palvelupaketteihin **Business, Enterprise ja Edu**. Plus ja Pro ovat käytännössä vain luku -tilassa. Kirjoitustoiminnot vaativat vahvistuksen joka kerta. ChatGPT voi muuttaa valikkojensa nimiä ja saatavuutta.
</Warning>

## OpenAI Codex CLI

Käytä uutta Codex CLI -versiota (vanhemmat versiot tukivat vain paikallisia palvelimia). Lisää palvelin asetustiedostossa tai komentorivillä.

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

Jos Codex-versiossasi ei ole `--url`-valitsinta tai komentoa `codex mcp login`, päivitä uusimpaan Codex CLI -versioon.

## Gemini CLI

Muokkaa tiedostoa `~/.gemini/settings.json`. Streamable HTTP -palvelimet käyttävät kenttää `httpUrl`.

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

Gemini CLI löytää OAuth-kirjautumisen itse. Suorita istunnossa `/mcp auth` (tai `/mcp` nähdäksesi, mitkä palvelimet sitä tarvitsevat) avataksesi selainkirjautumisen.

## Mikä tahansa muu MCP-asiakasohjelma

Useimmat asiakasohjelmat hyväksyvät tavallisen etäasetuksen pelkällä URL-osoitteella:

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

Jos asiakasohjelmasi noudattaa MCP:n valtuutusmäärittelyä (authorization spec), se löytää kirjautumisen ja suorittaa OAuthin puolestasi. Hyväksy sitten organisaatio ja oikeudet Zippendo-palvelun kirjautumissivulla, jonka se avaa.

## Vianmääritys

<AccordionGroup>
  <Accordion title="Selainkirjautuminen ei koskaan aukea">
    Tarkista, että asiakasohjelmasi tukee **remote MCP over OAuth** -toimintoa ja että käytät sen uusinta versiota. Jotkin asiakasohjelmat lisäsivät etäyhdistimet vasta viimeaikaisissa julkaisuissa.
  </Accordion>

  <Accordion title="Agentti ei näe tarvitsemaansa työkalua">
    Työkalut suodatetaan hyväksymiesi oikeuksien mukaan. Yhdistä uudelleen ja myönnä puuttuva oikeus hyväksyntänäkymässä (esimerkiksi `write:shipments` lähetysten luomiseen). Katso [Työkalut ja oikeudet](/docs/fi/mcp/tools).
  </Accordion>

  <Accordion title="Se toimii väärässä organisaatiossa">
    Jokainen yhteys kuuluu yhdelle organisaatiolle. Katkaise yhteys, yhdistä uudelleen ja valitse oikea organisaatio hyväksyntänäkymässä. Katso [Tunnistautuminen](/docs/fi/mcp/authentication).
  </Accordion>

  <Accordion title="Kirjautuminen hylkää tilisi">
    Jos tiimin jäsenen tilisi on rajattu yhteen brändiin, et voi yhdistää agenttia. Pyydä organisaation omistajaa antamaan sinulle pääsy koko organisaatioon tai yhdistämään agentti itse.
  </Accordion>

  <Accordion title="Asetus, jossa on vain url, hylätään">
    Jotkin asiakasohjelmat vaativat kuljetustyypin (transport type) kirjoitettuna näkyviin. Lisää `"type": "http"` kentän `url` viereen (Claude Code, VS Code) tai käytä kyseisen asiakasohjelman HTTP-vaihtoehtoa palvelinta lisätessäsi.
  </Accordion>
</AccordionGroup>


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