> ## 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. # Työkalut ja oikeudet > Työkalut, joita Zippendo MCP -palvelin tarjoaa, mitkä oikeudet avaavat ne ja esimerkkikehotteita. Työkalut ovat toimintoja, joita tekoälyagenttisi voi tehdä Zippendo-palvelussa puolestasi, kuten lähetyksen luominen tai tilauksen lukeminen. MCP-palvelin tarjoaa yhden työkalun jokaista rajapinnan toimintoa kohden, ja agenttisi näkee vain ne työkalut, jotka [hyväksymäsi oikeudet](/docs/fi/mcp/authentication) sallivat. ## Miten työkalut liittyvät oikeuksiin Jokainen työkalu vaatii oikeuden (scope), joka vastaa resurssia ja toimintoa: * Tietojen lukeminen vaatii `read:`-oikeuden. Lähetysten listaaminen vaatii esimerkiksi oikeuden `read:shipments`. * Tietojen muuttaminen vaatii vastaavan `write:`-oikeuden. Lähetyksen luominen vaatii esimerkiksi oikeuden `write:shipments`. Oikeudet rakentuvat toistensa päälle, joten voit antaa laajan tai suppean pääsyn: * **`write:all`** sisältää oikeuden `read:all` ja kaikki alla olevan taulukon `write:`-oikeudet. * **`read:all`** sisältää kaikki alla olevan taulukon `read:`-oikeudet. * **`write:`** sisältää oikeuden **`read:`** (`write:shipments` sisältää oikeuden `read:shipments`). Agentti, jolle on annettu vain `read:shipments`, näkee lähetysten **lukutyökalut** (lista, tiedot, seuranta, asiakirjat) mutta ei yhtään työkalua, jolla lähetyksiä luodaan, lähetetään tai poistetaan. ## Oikeuksien viite | Resurssi | Lukuoikeus | Kirjoitusoikeus | Luku antaa agentille mahdollisuuden… | Kirjoitus antaa lisäksi mahdollisuuden… | | - | - | - | - | - | | Lähetykset | `read:shipments` | `write:shipments` | Listata lähetyksiä, nähdä tiedot ja seuranta, hakea osoitekortit ja asiakirjat | Luoda, muuttaa, lähettää, jakaa ja poistaa lähetyksiä; siirtää paketteja; luoda palautuslähetyksiä; hakea osoitekortti uudelleen | | Tilaukset | `read:orders` | `write:orders` | Listata tilauksia ja nähdä niiden tiedot | Luoda, muuttaa ja poistaa tilauksia | | Kuljetusyhtiöt | `read:carriers` | `write:carriers` | Listata yhdistetyt kuljetusyhtiöt ja niiden kuljetuspalvelut | Yhdistää, päivittää ja poistaa kuljetusyhtiöitä; hakea noutopisteitä | | Myyntikanavat | `read:order_channels` | `write:order_channels` | Listata myyntikanavat ja niiden webhook-tila | Luoda, muuttaa ja poistaa kanavia; synkronoida ja testata niitä; rekisteröidä niiden webhookit; hallita kassa-tokeneita ja allekirjoitussalaisuuksia | | Osoitteet | `read:addresses` | `write:addresses` | Listata lähettäjän, noudon ja palautusten osoitteet | Luoda, päivittää ja poistaa osoitteita | | Toimitussäännöt | `read:shipping_rules` | `write:shipping_rules` | Listata toimitussäännöt | Luoda, muuttaa ja poistaa toimitussääntöjä | | Automaatiot | `read:automations` | `write:automations` | Listata automaatiot, niiden ajot ja käytettävissä olevat vaiheet | Luoda, muuttaa, poistaa ja ajaa automaatioita | | Tulostimet | `read:printers` | `write:printers` | Listata tulostimet | Rekisteröidä, hyväksyä, poistaa käytöstä, muuttaa ja poistaa tulostimia | | Webhookit | `read:webhooks` | `write:webhooks` | Listata webhookit ja niiden toimitukset | Luoda, muuttaa, testata ja poistaa webhookeja | | Integraatiot | `read:integrations` | `write:integrations` | Listata käytettävissä olevat integraatiot, yhteydesi ja niiden toimitukset | Yhdistää, muuttaa, testata ja poistaa integraatioita | | Roolit | `read:roles` | `write:roles` | Listata roolit | Luoda, muuttaa ja poistaa rooleja | | Tiimin jäsenet | `read:users` | `write:users` | (ei lukutyökaluja) | Lisätä tiimin jäsen organisaatioon | | **Kaikki** | `read:all` | `write:all` | Kaikki yllä olevat lukutyökalut | Kaikki yllä olevat työkalut | Suostumusnäkymä voi näyttää myös muita oikeuksia, kuten organisaatiot, tiimin jäsenet (`org_members`), palautusportaalit ja API-tokenit. Ne eivät avaa tällä hetkellä yhtään MCP-työkalua. Anna suppein joukko, joka riittää tehtävään. `read:all` ja `write:shipments` on hyvä oletus avustajalle, joka raportoi kaikesta mutta toimii vain lähetyksissä. ## Esimerkkikehotteet Kun yhteys on tehty, puhu agentillesi tavallisella kielellä. Se valitsee oikeat työkalut ja kysyy Zippendo-palvelulta: * "Kuinka monta lähetystä on vielä odottamassa ja millä kuljetusyhtiöillä ne ovat?" * "Luo lähetys tilaukselle #10421 kuljetusyhtiöllä PostNord ja anna minulle seurantakoodi." * "Jaa tilauksen #10388 lähetys kahteen pakettiin ja lähetä molemmat." * "Millä viimeisen 24 tunnin tilauksilla ei ole vielä lähetystä?" * "Seuraa lähetystä `shp_8f3kd9` ja kerro, onko se myöhässä." * "Lisää toimitussääntö, joka lähettää yli 10 kg:n tilaukset kuljetusyhtiöllä GLS." ## Dokumentaatio- ja SDK-työkalut Toimintotyökalujen lisäksi MCP-palvelin antaa agentin **lukea Zippendo-palvelun dokumentaatiota**, jotta se voi auttaa sinua *rakentamaan* integraation omalla ohjelmointikielelläsi. Nämä työkalut eivät vaadi **mitään oikeutta**, ja jokaisella yhdistetyllä agentilla ne ovat käytössä. | Työkalu | Mitä se tekee | | - | - | | `search_documentation` | Hakee kaikesta dokumentaatiosta: oppaista, koko API-viitteestä ja SDK-sivuilta. Jätä kysely pois selataksesi koko hakemistoa. | | `fetch_documentation` | Lukee minkä tahansa sivun markdownina (API-viitteen sivuilla on mukana päätepisteen OpenAPI-kuvaus). Anna `openapi` saadaksesi koko raakamäärittelyn. | | `get_sdk_reference` | Kunkin kielen (TypeScript, Python, PHP, Go, Ruby) SDK-viite: metodien allekirjoitukset ja ajettavat esimerkit. | Agentille kerrotaan, että se **suosii kielesi SDK:ta** ja käyttää raakaa OpenAPI-määrittelyä vain, kun sille ei ole SDK:ta. Sisältö tulee suoraan osoitteesta [zippendo.com/docs](https://www.zippendo.com/docs) ja SDK-repositorioista, joten se on aina ajan tasalla. Kokeile esimerkiksi näitä kehotteita: * "Kirjoita Zippendo Python SDK:ta käyttäen skripti, joka luo lähetyksen tilaukselle ja tulostaa seurantakoodin." * "Miten todennan itseni Zippendo-rajapintaan Go-kielellä? Näytä SDK:n käyttöönotto." * "Käytän PHP:tä. Kirjoita webhook-käsittelijä, joka varmentaa allekirjoituksen ja reagoi tapahtumaan `shipment.dispatched`." ## Turvallisuusmalli Työkalukutsut ajetaan sinuna, vain hyväksymilläsi oikeuksilla. Yhteys kuuluu yhdelle organisaatiolle. Se ei voi lukea tai muuttaa toisen organisaation tietoja. Agentti ei voi koskaan tehdä Zippendo-henkilöstön toimintoja. Jokainen kutsu käy läpi samat kirjautumis-, pakettirajoitus- ja validointitarkistukset kuin sovellus. Lähetysten, tilausten, kuljetusyhtiöiden, osoitteiden, toimitussääntöjen tai roolien poistaminen, lähetyksen lähettäminen sekä kassa-tokenien ja allekirjoitussalaisuuksien luominen tai peruuttaminen vaativat kaikki erillisen vahvistuksen työkalukutsussa, joten agentin pitäisi kysyä sinulta ensin. Jotkin arkaluonteiset toiminnot, kuten laskutus ja API-tokenien hallinta, on jätetty kokonaan pois työkaluista, eikä mikään agentti voi käyttää niitä oikeuksistaan riippumatta. ## Samat työkalut toimivat avustajassa Zippy MCP-palvelin jakaa työkalunsa avustajan **Zippy** kanssa, joka on Zippendo-sovelluksen avustaja. Vain paikka on eri: Zippy toimii sovelluksen sisällä, kun taas MCP antaa oman tekoälytyökalusi käyttää samoja toimintoja. Molemmat käyttävät samoja oikeuksia, organisaation rajoja ja validointia. Valmiina ottamaan tämän käyttöön? Seuraa työkalusi käyttöönotto-opasta. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.