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

# MCP-palvelin

> Yhdistä tekoälytyökalut, kuten Claude, ChatGPT ja Cursor, Zippendo-tietoihisi Model Context Protocolilla (MCP).

MCP-liittimen avulla tekoälytyökalut, kuten Claude, ChatGPT ja Cursor, voivat työskennellä Zippendo-tietojesi kanssa: kysy tavallisella kielellä, ja avustaja luo lähetyksiä, seuraa paketteja ja lukee tilauksesi puolestasi.

Zippendo pyörittää omaa **MCP (Model Context Protocol) server** -palvelinta. Yhdistetty tekoälytyökalu käyttää samoja oikeuksia ja tarkistuksia kuin Zippendo-sovellus. Se toimii minkä tahansa MCP-asiakkaan kanssa, mukaan lukien Claude Code, Claude Desktop, Claude verkossa, Cursor, VS Code (GitHub Copilot), Windsurf, ChatGPT, Codex CLI, Gemini CLI ja omat agenttisi.

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

  Streamable HTTP, suojattu OAuth 2.1:llä. Lisää URL tekoälytyökaluusi ja kirjaudu sisään: mitään ei tarvitse asentaa eikä tokenia kopioida.
</Card>

## Näin yhdistät

Lisää `https://api.zippendo.com/mcp` tekoälytyökaluusi mukautettuna MCP-liittimenä. Työkalu avaa Zippendo-kirjautumisen selaimessasi, jossa valitset organisaation ja hyväksyt oikeudet. Työkalusi pitää yhteyden ajan tasalla itse sen jälkeen.

Zippendo-sovelluksessa **Apps & integrations** → **Catalog** → **MCP (AI agents)** → **Connect** opastaa sinut samoissa vaiheissa omalle työkalullesi. Katso kaikki työkalut sivulta [Yhdistä agenttisi](/docs/fi/mcp/connect).

## Mitä voit tehdä

Kun yhteys on muodostettu, agentti voi työskennellä Zippendo-tietojesi parissa hyväksymiesi oikeuksien rajoissa:

* **Shipments**: luo, jaa, lähetä ja seuraa lähetyksiä; hae osoitekortit ja asiakirjat.
* **Orders**: lue myyntikanaviesi tuomat tilaukset ja muuta ne lähetyksiksi.
* **Carriers**: listaa yhdistetyt kuljetusyhtiöt ja niiden kuljetuspalvelut sekä hae noutopisteitä.
* **Addresses and shipping rules**: lue ja hallitse lähettäjän osoitteita ja toimitussääntöjä.
* **Automations, webhooks, printers and more**: suurin osa siitä, mitä API tarjoaa.

Tarkat työkalut riippuvat myöntämistäsi oikeuksista. Koko kartta: [Työkalut ja oikeudet](/docs/fi/mcp/tools).

## Vaatimukset

* Zippendo-tili, jolla on pääsy vähintään yhteen organisaatioon. Tiimin jäsen, joka on rajattu yhteen brändiin, ei voi yhdistää agenttia.
* MCP-asiakas, joka tukee etäliittimiä. Jotkin tekoälytyökalut tarjoavat mukautettuja liittimiä vain maksullisilla tilauksilla (esimerkiksi ChatGPT). Katso [Yhdistä agenttisi](/docs/fi/mcp/connect).

## Miten se toimii

Liittimen URL on Zippendo-API:iin sisäänrakennettu Streamable HTTP -MCP-palvelin. Se tarjoaa samat työkalut kuin **Zippy**, Zippendo-sovelluksen avustaja. Jokainen työkalukutsu kulkee oikean API:n läpi samalla kirjautumisella, oikeustarkistuksilla, tilauksen rajoilla ja validoinnilla kuin mikä tahansa muu pyyntö. Agentti toimii **sinuna**, vain hyväksymässäsi organisaatiossa ja hyväksymilläsi oikeuksilla, eikä koskaan Zippendo-henkilökunnan oikeuksilla.

<CardGroup cols={3}>
  <Card title="Yhdistä agenttisi" icon="plug" href="/docs/fi/mcp/connect">
    Vaiheittainen asennus Claudelle, Cursorille, VS Codelle, ChatGPT:lle ja muille.
  </Card>

  <Card title="Tunnistautuminen" icon="shield-check" href="/docs/fi/mcp/authentication">
    Miten kirjautuminen toimii, organisaation valinta ja oikeuksien rajaaminen.
  </Card>

  <Card title="Työkalut ja oikeudet" icon="wrench" href="/docs/fi/mcp/tools">
    Mitkä työkalut kukin oikeus avaa, esimerkkikehotteineen.
  </Card>
</CardGroup>


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