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

# Tunnistautuminen

> Näin Zippendo-palvelun MCP-palvelin kirjaa tekoälyagenttisi sisään OAuth 2.1:llä ja miten valitset sen saaman organisaation ja oikeudet.

Päätät tarkasti, mitä yhdistetty tekoälyagentti saa tehdä Zippendo-palvelussa: missä organisaatiossa se toimii ja mitä oikeuksia sillä on. Yhdistimen URL-osoite (`https://api.zippendo.com/mcp`) on suojattu **OAuth 2.1** -tunnistautumisella. Et liitä tokenia koskaan itse: asiakasohjelmasi löytää kirjautumisen URL-osoitteesta, avaa selaimesi, ja sinä kirjaudut Zippendo-palveluun ja hyväksyt pääsyn. Tällä sivulla kerrotaan, mitä tapahtuu ja mitä voit hallita.

## Yhdistämisen vaiheet

Kun lisäät URL-osoitteen asiakasohjelmaan ja yhdistät ensimmäistä kertaa:

<Steps>
  <Step title="Asiakasohjelmasi löytää kirjautumisen">
    Palvelin vastaa ensimmäiseen tunnistautumattomaan pyyntöön osoittamalla OAuth-tietonsa. Asiakasohjelmasi rekisteröityy automaattisesti (sinun ei tarvitse luoda asiakastunnusta) ja avaa selaimesi.
  </Step>

  <Step title="Kirjaudut Zippendo-palveluun">
    Jos et ole vielä kirjautunut sisään, päädyt Zippendo-palvelun kirjautumissivulle. Kirjaudu sisään kuten tavallisesti.
  </Step>

  <Step title="Hyväksyt pääsyn suostumusnäkymässä">
    **Authorize access** -näkymä (pääsyn hyväksyminen) näyttää asiakasohjelman nimen, yhdistettävän **Organization**-valinnan ja pyydetyt **Permissions**-oikeudet. Valitse organisaatio, rastita myönnettävät oikeudet ja napsauta **Authorize**. Kieltäydy napsauttamalla **Deny**.
  </Step>

  <Step title="Yhteys on muodostettu">
    Selain palauttaa hallinnan asiakasohjelmallesi, joka tallentaa tokenit ja uusii ne itse. Sinun ei tarvitse kirjautua uudelleen, ennen kuin katkaiset agentin yhteyden tai sen pääsy vanhenee.
  </Step>
</Steps>

<Note>
  Tiimin jäsen, jonka pääsy on rajattu yhteen brändiin, ei voi yhdistää agenttia. Suostumusnäkymä hylkää pyynnön. Pyydä jotakuta, jolla on pääsy koko organisaatioon, yhdistämään se.
</Note>

## Organisaation valinta

Jokainen yhteys kuuluu **yhdelle organisaatiolle**. Suostumusnäkymässä valitset, missä organisaatiossa agentti saa toimia, ja jokainen työkalukutsu pysyy tässä organisaatiossa.

Jos haluat työskennellä toisessa organisaatiossa, yhdistä uudelleen ja valitse suostumusnäkymässä toinen organisaatio. Asiakasohjelmissa, jotka sallivat useamman palvelinmerkinnän, voit myös lisätä toisen yhdistimen samalla URL-osoitteella ja hyväksyä sen toiselle organisaatiolle.

## Oikeuksien rajaaminen

Suostumusnäkymässä voit myöntää **vähemmän** oikeuksia kuin asiakasohjelma pyytää, mutta et koskaan enemmän. Yksi oikeus on pidettävä vähintään. Jos asiakasohjelma ei pyydä mitään tiettyä, näkymä tarjoaa luku- ja kirjoitusoikeuden kaikkeen. Myönnä vain se, mitä agentti tarvitsee:

* Vastaako se vain kysymyksiin? Myönnä pelkät **Read**-oikeudet.
* Pitäisikö sen luoda ja lähettää lähetyksiä? Lisää kirjoitusoikeus lähetyksiin (`write:shipments`).

Agenttisi näkemät työkalut suodatetaan hyväksymiesi oikeuksien mukaan. Koko kartta on sivulla [Työkalut ja oikeudet](/docs/fi/mcp/tools).

<Info>
  Agentti toimii **sinuna**, vain hyväksymässäsi organisaatiossa ja hyväksymilläsi oikeuksilla, eikä **koskaan** Zippendo-palvelun henkilöstön oikeuksilla. Jokainen työkalukutsu käy läpi saman kirjautumisen, oikeustarkistukset, palvelupaketin rajat ja validoinnin kuin tavallinen API-pyyntö.
</Info>

## Tokenit ja uusiminen

Asiakasohjelmasi hallitsee OAuth-tokenit puolestasi:

| Token | Voimassaoloaika | Huomioita |
| - | - | - |
| Access token | 1 tunti | Lähetetään jokaisen pyynnön mukana. |
| Refresh token | 30 päivää | Vaihtuu aina, kun sitä käytetään. Vanhan refresh tokenin käyttö uudelleen katsotaan varkaudeksi ja **päättää koko yhteyden**. |

Sinun ei tarvitse käsitellä näitä itse: asiakasohjelma tallentaa ja uusii ne.

## Yhteyden katkaiseminen

Voit lopettaa agentin pääsyn menemällä Zippendo-sovelluksessa kohtaan **Apps & integrations**. **MCP (AI agents)** -kortti listaa yhdistämäsi agentit sekä sen, milloin kutakin on viimeksi käytetty ja kuinka monta oikeutta sillä on. Napsauta agentin vieressä **Disconnect**. Sen pääsy päättyy heti, myös sillä jo olevien tokenien osalta.

Voit myös poistaa yhdistimen asiakasohjelmastasi (esimerkiksi `claude mcp remove zippendo` tai poistamalla se asiakasohjelman MCP- tai Connectors-asetuksista). Se estää asiakasohjelmaa käyttämästä sitä, mutta vain **Disconnect** Zippendo-palvelussa peruu tokenit Zippendo-palvelun puolella.

<Note>
  Kortti näyttää vain itse yhdistämäsi agentit. Jokainen tiimin jäsen yhdistää ja katkaisee omat agenttinsa.
</Note>

## Kehittäjille: löytymispäätepisteet

API on oma OAuth 2.1 -valtuutuspalvelimensa. Vakiomuotoiset löytymispäätepisteet ovat julkisia:

| Päätepiste | Tarkoitus |
| - | - |
| `GET /.well-known/oauth-protected-resource` | RFC 9728: ohjaa asiakasohjelmat valtuutuspalvelimelle. |
| `GET /.well-known/oauth-authorization-server` | RFC 8414: valtuutuspalvelimen metatiedot. |
| `POST /oauth/register` | RFC 7591: asiakkaan dynaaminen rekisteröinti (julkiset PKCE-asiakkaat). |
| `GET /oauth/authorize` | Aloittaa valtuutuksen (PKCE S256). |
| `POST /oauth/token` | Vaihtaa koodin ja kierrättää refresh tokenit. |

Vaatimustenmukainen MCP-asiakasohjelma hoitaa tämän kaiken puolestasi: annat sille vain URL-osoitteen.


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