# Thril Claudessa, ChatGPT:ssä ja muissa tekoälyavustajissa (/fi/businesses/integrations/mcp) Tekoälyavustajan yhteys käyttää yrityksenne [julkisen API:n](/fi/businesses/integrations/public-api) tunnistetta. Thril lisää julkisen API:n pyynnöstä. Ottakaa yhteyttä [Thrilin tukeen](mailto:support@thril.fi) saadaksenne sen. Tekoälyavustaja, kuten Claude tai ChatGPT, voi käyttää yrityksenne tietoja Thrilissä Thrilin MCP-palvelimen kautta. Kysytte omin sanoin, ja avustaja hakee vastauksen varauksistanne, asiakkaistanne, maksuistanne ja tapahtumistanne. Luvallanne se voi myös tehdä muutoksia, esimerkiksi luoda kampanjakoodin. MCP on avoin standardi, jolla tekoälyavustajat liittyvät muihin järjestelmiin. Sen käyttöönotto ei vaadi kehittäjää. Thrilin MCP-palvelimen osoite on: ``` https://api-public.thril.fi/mcp ``` --- ## Kysymyksiä avustajalle [#kysymyksiä-avustajalle] Avustaja ulottuu samoihin tietoihin ja toimintoihin kuin [julkinen API](/fi/businesses/integrations/public-api#apin-tiedot-ja-toiminnot). Se osaa yhdistellä niitä ja laskea puolestanne: - "Paljonko myimme korttimaksuina viime kuussa, ja paljonko hyvitimme?" - "Keiden asiakkaiden jäsenyys päättyy seuraavan kahden viikon aikana?" Pilatesstudio voi olla yhteydessä jäseniin ennen kuin he jäävät pois. - "Ketkä ovat ilmoittautuneet lauantain padel-turnaukseen, ja montako paikkaa on vielä jäljellä?" - "Minä iltoina ensi viikolla golfsimulaattoreissamme on vielä vapaita aikoja?" - "Luo kumppanikuntosalimme jäsenille 20 %:n kampanjakoodi, joka on voimassa kuun loppuun." - "Anna maksuton 30 €:n lahjakortti asiakkaalle, jonka tunti peruttiin, ja kerro minulle koodi." Kun yhteys on valmis, kysykää "Mitä osaat tehdä Thrilissä?", niin avustaja luettelee toiminnot, jotka sillä on käytössään. --- ## Ennen yhdistämistä [#ennen-yhdistämistä] **API-tunniste.** Avustajan yhdistävä henkilö syöttää yrityksenne julkisen API:n tunnisteen kerran Thrilin sivulle selaimessa. Avustaja ei näe tunnistetta. Kuka tahansa, jolla tunniste on, voi yhdistää avustajan kaikkiin yrityksenne tietoihin. Antakaa se siis vain henkilöille, jotka näkisivät samat tiedot muutenkin Thrilin hallintapaneelissa. **Lukeminen ja muuttaminen.** Thrilin sivulla valitsette, mitä yhteys saa tehdä. **Read Thril data** antaa avustajan hakea tietoja. **Change Thril data** antaa sen lisäksi varata vakiovuoroja, antaa lahjakortteja, luoda kampanjakoodeja ja muuttaa resurssienne hinnoittelusääntöjä. Aloittakaa pelkällä lukemisella. Muutosoikeuden voi lisätä myöhemmin yhdistämällä uudelleen. **Asiakkaidenne tiedot.** Se, mitä avustaja lukee, asiakkaiden nimet ja yhteystiedot mukaan lukien, siirtyy avustajan taustalla olevalle yritykselle teidän ja sen välisen sopimuksen mukaisesti. Käyttäkää avustajaa, jolle yrityksenne jo uskoo asiakastietoja, esimerkiksi Clauden tai ChatGPT:n yrityspakettia. --- ## Kirjautuminen Thriliin [#kirjautuminen-thriliin] Jokainen avustaja yhdistetään samalla tavalla. Kun Thrilin osoite on lisätty, avustaja avaa Thrilin sivun selaimeen: 1. Tarkista, että sivulla lukee yhdistämäsi avustajan nimi ja että aloitit yhdistämisen itse. 2. Syötä yrityksenne julkisen API:n tunniste kenttään **Public API token**. 3. Pidä kohdassa **Access** valittuna **Read Thril data**. Valitse myös **Change Thril data**, jos haluat avustajan tekevän muutoksia. 4. Valitse **Connect**. Selain palaa avustajaan, ja Thril on käytössä. --- ## Avustaja neuvoo myös itse [#avustaja-neuvoo-myös-itse] Avustajat tuntevat omat asetuksensa hyvin. Jos valikkoa ei löydy tai vaihe näyttää erilaiselta kuin tässä, kysykää avustajalta itseltään: "Haluan lisätä MCP-palvelimen osoitteesta https://api-public.thril.fi/mcp liittimeksi. Neuvo minua vaihe vaiheelta." Näiden sovellusten valikot muuttuvat usein, ja avustaja tuntee käyttämänne version. Sama toimii, kun Thril on yhdistetty. Pyytäkää avustajaa selittämään luku, kokeilemaan kysymystä toisin tai ehdottamaan, mitä kannattaisi katsoa seuraavaksi. --- ## Clauden yhdistäminen [#clauden-yhdistäminen] Claudessa verkossa tai työpöytäsovelluksessa: 1. Avaa **Customize** → **Connectors**. 2. Valitse **Add custom connector**. 3. Syötä Thrilin osoite `https://api-public.thril.fi/mcp` ja valitse **Add**. Jos Claude kysyy kirjautumistapaa, valitse **Register automatically**. 4. Kirjaudu Thriliin avautuvalla sivulla. Clauden Team- tai Enterprise-paketissa omistaja lisää liittimen kohdassa **Organization settings** → **Connectors**. Kukin käyttäjä löytää sen jälkeen Thrilin kohdasta **Customize** → **Connectors** merkinnällä **Custom**, valitsee **Connect** ja kirjautuu Thriliin. Keskustelussa Claude käyttää Thriliä, kun kysymys sitä vaatii. Liittimen voi kytkeä pois yksittäisestä keskustelusta **+**-valikosta. ### Claude Code [#claude-code] Lisätkää Thril päätteessä: ```sh claude mcp add --transport http thril https://api-public.thril.fi/mcp ``` Suorita sitten Claude Codessa `/mcp`, valitse **thril** ja kirjaudu Thriliin selaimessa. Claude Code vaatii version 2.1.232 tai uudemman. --- ## ChatGPT:n yhdistäminen [#chatgptn-yhdistäminen] ChatGPT liittyy MCP-palvelimiin kehittäjätilassa, joka on käytössä maksullisissa paketeissa. Business- tai Enterprise-työtilassa ylläpitäjän voi ensin olla tarpeen sallia se. 1. Ota ChatGPT:n asetuksista käyttöön **Developer mode**. 2. Luo sovellus ja syötä Thrilin osoite `https://api-public.thril.fi/mcp`. Valitse kirjautumistavaksi OAuth, jos ChatGPT kysyy. 3. Kirjaudu Thriliin avautuvalla sivulla. 4. Valitse keskustelussa Thril kehittäjätilan työkaluista. ChatGPT siirtelee näitä asetuksia versiosta toiseen. Jos valikot näyttävät erilaisilta, kysykää ChatGPT:ltä: "Miten lisään MCP-palvelimen kehittäjätilassa?" --- ## Muiden työkalujen yhdistäminen [#muiden-työkalujen-yhdistäminen] Thriliin voi yhdistää minkä tahansa tekoälytyökalun, joka tukee etä-MCP-palvelimia ja OAuth-kirjautumista, esimerkiksi tekoälyavustajalla varustetun koodieditorin. Lisätkää työkalun asetuksissa etä- tai HTTP-MCP-palvelin, syöttäkää `https://api-public.thril.fi/mcp` ja kirjautukaa Thriliin, kun työkalu avaa selaimen. Työkalun oma avustaja osaa yleensä kertoa, missä sen MCP-asetukset ovat. --- ## Avustajan yhteyden katkaiseminen [#avustajan-yhteyden-katkaiseminen] Poistakaa Thril-liitin avustajan asetuksista. Jos haluatte katkaista yhteyden lopullisesti, pyytäkää [Thrilin tukea](mailto:support@thril.fi) perumaan se. Uusi julkisen API:n tunniste katkaisee kaikkien vanhalla tunnisteella yhdistettyjen avustajien yhteydet, ja kukin yhdistää avustajansa uudelleen uudella tunnisteella.