Yhdistä agenttisi

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

Yhdistimen URL

https://api.zippendo.com/mcp

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.

Ota käyttöön Zippendo-sovelluksesta

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

Avaa MCP-kortti

Mene kohtaan Apps & integrations → Catalog, etsi MCP (AI agents) ja klikkaa Connect. Connect an AI agent -ikkuna aukeaa.

Valitse agentti

Valitse tekoälytyökalusi. Mikä tahansa MCP-asiakasohjelma toimii; luettelo näyttää ne, joille on nimetyt ohjeet.

Lisää yhdistin

Seuraa työkalusi vaiheita. Connector URL -kentässä on Copy-painike. Kun olet lisännyt sen, klikkaa I’ve added it.

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.

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

Lisää palvelin

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

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.

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

.mcp.json

{
  "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

Avaa Connectors

Mene kohtaan Settings → Connectors ja klikkaa Add custom connector.

Lisää URL

Nimeä se Zippendo, kirjoita https://api.zippendo.com/mcp ja klikkaa Add.

Yhdistä

Klikkaa Connect avataksesi selainkirjautumisen ja hyväksy sitten organisaatio ja oikeudet.

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.

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.

Avaa MCP-asetukset

Avaa Cursor Settings → Tools & MCP → New MCP Server. Tämä avaa mcp.json-tiedostosi.

Lisää palvelin

mcp.json

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

Yleinen asetustiedosto sijaitsee polussa ~/.cursor/mcp.json ja projektikohtainen polussa .cursor/mcp.json.

Kirjaudu sisään

Palvelimen viereen ilmestyy Login-toiminto. Klikkaa sitä suorittaaksesi selainkirjautumisen.

Asennus yhdellä klikkauksella: Lisää Zippendo Cursor-ohjelmaan. Cursor pyytää sinua hyväksymään ja kirjoittaa merkinnän puolestasi.

VS Code (GitHub Copilot)

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

Lisää palvelin

Command Palette → MCP: Add Server → HTTP, liitä https://api.zippendo.com/mcp ja valitse sitten Workspace (kirjoittaa .vscode/mcp.json) tai Global.

Tunnistaudu

Auth-toiminto ilmestyy palvelinmerkinnän yläpuolelle tiedostossa mcp.json. Suorita selainkirjautuminen loppuun.

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

.vscode/mcp.json

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

Windsurf

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

ChatGPT

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

Ota Developer Mode käyttöön

Kytke päälle Settings → Connectors → Advanced → Developer Mode.

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.

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.

OpenAI Codex CLI

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

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

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.

~/.gemini/settings.json

{
  "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:

{
  "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

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.

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.

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.

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.

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.

Start

Quickstarts

Fulfillment flow

Connections

Operations

Organization & account

Yhdistä agenttisi

Yhdistimen URL

Ota käyttöön Zippendo-sovelluksesta

Claude Code

Claude Desktop

Claude verkossa

Cursor

VS Code (GitHub Copilot)

Windsurf

ChatGPT

OpenAI Codex CLI

Gemini CLI

Mikä tahansa muu MCP-asiakasohjelma

Vianmääritys

Yhdistimen URL

​Ota käyttöön Zippendo-sovelluksesta

​Claude Code

​Claude Desktop

​Claude verkossa

​Cursor

​VS Code (GitHub Copilot)

​Windsurf

​ChatGPT

​OpenAI Codex CLI

​Gemini CLI

​Mikä tahansa muu MCP-asiakasohjelma

​Vianmääritys

Ota käyttöön Zippendo-sovelluksesta

Claude Code

Claude Desktop

Claude verkossa

Cursor

VS Code (GitHub Copilot)

Windsurf

ChatGPT

OpenAI Codex CLI

Gemini CLI

Mikä tahansa muu MCP-asiakasohjelma

Vianmääritys