Tunnistautuminen ja käyttöavaimet¶
Kaluston omistaja antaa integraatiolle lukuoikeuden luomalla nimetyn avaimen. Avainta käsitellään kuten salasanaa.
Tavallinen taustaohjelma lähettää avaimen jokaisen pyynnön Authorization-otsakkeessa. Selain- tai chat-istuntoa ei tarvita.
Authorization: Bearer <EWOOKS_MCP_KEY>
Content-Type: application/json
MCP-Protocol-Version: 2025-11-25
Käyttöoikeuden edellytykset¶
Nykyinen toteutus edellyttää oikeutettua kaluston omistajan tiliä, Ewooksin määrittämää MCP-käyttöoikeutta ja omistajan tekemää yhteyden käyttöönottoa. Pyynnön tunnistautumisessa tarkistetaan tilin aktiivisuus, estot, soveltuvat tilausehdot ja kaluston nykyinen omistus.
Yleinen ylläpitäjärooli ei anna pääsyä toisen omistajan kalustoon. Tässä versiossa valitaan yksi ehdot täyttävä omistettu fleet. Vapaa usean fleetin valinta tai delegoitu yrityspääkäyttäjyys eivät kuulu rajapinnan yleisiin ominaisuuksiin.
Avaimen luonti¶
- Kirjaudu Ewooks-portaaliin.
- Avaa Tekoäly-yhteydet / AI connections. Nimestään huolimatta avainta voi käyttää myös tavallinen integraatio-ohjelma.
- Jos yhteys ei ole käytettävissä, varmista käyttöoikeus Ewooksilta. Pelkkä yleinen ylläpitäjärooli ei riitä toisen omistajan kalustoon.
- Ota yhteys käyttöön ja anna avaimelle kuvaava nimi, esimerkiksi ”Oma taloushallintoliitäntä”.
- Luo avain ja kopioi se heti turvalliseen salaisuuksien säilytykseen. Avainta ei näytetä uudelleen.
Avain on voimassa 90 päivää. Käyttäjällä voi olla enintään viisi aktiivista, vanhentumatonta avainta. Nykyinen avain antaa fleetin lukuoikeuden kaikille neljälle MCP-työkalulle; työkalukohtaisia valintoja ei ole.
Vaihto ja sulkeminen¶
Luo uusi avain ennen vanhan päättymistä, päivitä se integraation palvelimelle ja varmista yhteys. Sulje sen jälkeen vanha avain portaalissa. Kadonnutta avainta ei palauteta, vaan se korvataan.
Jos tietojen lukeminen pitää lopettaa heti, sulje kyseinen avain. Koko yhteyden poistaminen käytöstä sulkee nykyiset avaimet ja OAuth-yhteydet. Oikeudet tarkistetaan jokaisella pyynnöllä, myös tilannekuvan seuraavalla sivulla.
Turvallinen luovutus kehittäjälle¶
Sopikaa erikseen vastaanottava palvelu ja suojattu tapa toimittaa sen tarvitsema avain. Älä lähetä avainta sähköpostiketjuun, tukipyyntöön tai chat-keskusteluun. Älä lisää sitä nettisivun JavaScriptiin, URL-osoitteeseen tai versionhallintaan.
Avaimen sulkeminen estää tulevat haut. Se ei poista tietoja, jotka vastaanottava järjestelmä on jo ehtinyt tallentaa. Sopikaa siksi myös vastaanottajan käyttöoikeuksista ja säilytysajoista.
Jo lähetettyä vastausta ei voi kutsua takaisin. Sulkeminen tarkistetaan seuraavassa pyynnössä, myös samalla tilannekuvakursorilla jatkettaessa.
OAuth-asiakasohjelmat¶
Nykyinen OAuth-kirjautuminen on rajattu tuettuun ChatGPT-asiakasohjelmaan. Rajapinnassa ei ole avointa OAuth-rekisteröintiä mielivaltaisille kumppanisovelluksille. Tavallinen palvelimelta palvelimelle toimiva integraatio käyttää yllä kuvattua nimettyä API-avainta, ellei Ewooksin kanssa ole erikseen sovittu muusta.
Työkalujen metatiedon oauth2-määritys kuvaa tuettua OAuth-käyttöä. Päätepiste hyväksyy sen lisäksi tässä ohjeessa kuvatut ewmcp_-alkuiset Bearer-avaimet.
Erota ympäristöt¶
Luo avain siihen ympäristöön, jota käytät, ja lähetä se vain kyseisen ympäristön kiinteään HTTPS-päätepisteeseen. Älä kokeile epäonnistunutta tunnistautumista automaattisesti toisella palvelimella äläkä välitä Authorization-otsaketta uudelleenohjaukseen. Tunnistautumisvirheen jälkeen tarkista avain, tili ja fleetin käyttöoikeus.