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:1
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.
2
Kirjaudut Zippendo-palveluun
Jos et ole vielä kirjautunut sisään, päädyt Zippendo-palvelun kirjautumissivulle. Kirjaudu sisään kuten tavallisesti.
3
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.
4
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.
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.
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).
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ö.
Tokenit ja uusiminen
Asiakasohjelmasi hallitsee OAuth-tokenit puolestasi:
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 (esimerkiksiclaude 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.
Kortti näyttää vain itse yhdistämäsi agentit. Jokainen tiimin jäsen yhdistää ja katkaisee omat agenttinsa.
Kehittäjille: löytymispäätepisteet
API on oma OAuth 2.1 -valtuutuspalvelimensa. Vakiomuotoiset löytymispäätepisteet ovat julkisia:
Vaatimustenmukainen MCP-asiakasohjelma hoitaa tämän kaiken puolestasi: annat sille vain URL-osoitteen.