# Yhdistä MCP-palvelimet bottiisi MCP-palvelinten avulla tekoälybottisi voi käyttää muiden järjestelmien työkaluja live-keskustelujen aikana – ilman, että sinun tarvitsee rakentaa jokaista työkalua käsin. Osoitat botin MCP-palvelimeen kerran, ja jokainen palvelimen tarjoama työkalu tulee botin käyttöön automaattisesti. Jos olet käyttänyt mukautettuja funktioita (Custom Functions), kyseessä on sama idea vietynä askeleen pidemmälle: mukautettu funktio on yksittäinen työkalu, jonka kytket itse, kun taas MCP-palvelin on valmis työkalupaketti, jonka botti voi löytää ja jota se voi kutsua itsenäisesti. --- ## Mikä on MCP-palvelin? MCP (Model Context Protocol) on avoin standardi, jolla tekoälyavustajille annetaan pääsy ulkoisiin työkaluihin. Monet nykyaikaiset sovellukset ja palvelut julkaisevat nykyään "MCP-palvelimen" – yhden verkko-osoitteen, joka paljastaa joukon työkaluja, joita tekoäly voi kutsua: etsiä jotain, hakea tietueen, suorittaa kyselyn tai luoda kohteen. Sen sijaan, että kuvailisit jokaisen työkalun botille, annat Your AI Connector-palvelulle palvelimen osoitteen ja pääsyavaimen. Your AI Connector kysyy palvelimelta "mitä osaat tehdä?", saa vastauksena luettelon työkaluista ja tekee ne botin käytettäviksi. Kun palvelin lisää uuden työkalun, bottisi voi käyttää sitä ilman lisämäärityksiä sinun puoleltasi. **Mukautetut funktiot vs. MCP-palvelimet – kumpaa käyttää:** | | Mukautetut funktiot | MCP-palvelimet | | ------------------ | --------------------------------------------------- | -------------------------------------------------------------- | | **Mitä määrität** | Yksi työkalu kerrallaan, täysin käsin (URL, syötteet, vastausten yhdistäminen). | Yksi palvelimen osoite — botti löytää kaikki sen työkalut puolestasi. | | **Paras käyttökohde** | Yksittäinen, tietty kutsu omaan järjestelmääsi. | Yhteyden muodostaminen palveluun, joka tukee jo MCP:tä ja tarjoaa useita työkaluja. | | **Ylläpito** | Päivität funktion, kun työkalu muuttuu. | Palvelimen uudet työkalut ilmestyvät automaattisesti. | Voit käyttää molempia samanaikaisesti samassa agentissa. --- ## Miten se toimii (yksinkertaistettuna) 1. **Rekisteröit MCP-palvelimen** **MCP Servers** -sivulla – syötät sen verkko-osoitteen ja valtuutusotsakkeen (yleensä API-avaimen). 2. Your AI Connector **muodostaa yhteyden ja tunnistaa** palvelimen työkalut sekä tallentaa luettelon muistiinsa. 3. **Otat palvelimen käyttöön** agentilla. 4. Keskustelun aikana, kun asiakas pyytää jotain, mihin työkalu voi vastata, **botti kutsuu työkalua**, lukee tuloksen ja vastaa luonnollisesti. Asiakas ei koskaan näe taustalla tapahtuvaa toimintaa – hän saa vain vastauksen, joka perustuu ajantasaiseen tietoon. ### Mitä MCP-työkalukutsu maksaa MCP-palvelimen työkalukutsu laskutetaan täsmälleen samalla tavalla kuin mukautettu funktiokutsu, agenttisi tekoälyn laatutason mukaisesti: | Tekoälyn laatutaso | Krediittejä per MCP-työkalukutsu | Kun oma Anthropic-avain (BYOK) on yhdistetty | |---|---|---| | Pro | 1 krediitti | 0 krediittiä – toimii omalla avaimellasi | | Economy (vanhentunut) | 0,5 krediittiä | 0 krediittiä – toimii omalla avaimellasi | | Max | 0,25 krediittiä | edelleen 0,25 krediittiä, laskutetaan vaikka oma avain olisi yhdistetty, koska Max toimii omalla mallillamme | | Mini | 0,15 krediittiä | edelleen 0,15 krediittiä, laskutetaan vaikka oma avain olisi yhdistetty, koska Mini toimii omalla mallillamme | --- ## MCP-palvelimen lisääminen (vaihe vaiheelta) Napsauta pääsivupalkin **AI Studio** -kohdasta **MCP Servers**. Napsauta sitten **+ Add Server**. Täytä lomake: | Kenttä | Mitä syötetään | Esimerkki | | -------------------- | ----------------------------------------------------------------------------- | --------------------------------- | | **Name** | Lyhyt nimi palvelimelle (käytetään myös työkalujen nimeämiseen botille). | `Order System` | | **Server URL** | Palvelimen MCP-osoite (joskus kutsutaan nimellä "endpoint"), joka alkaa `https://`. | `https://tools.mystore.com/mcp` | | **Auth Header Name** | Otsake, jota palvelin odottaa todennusta varten. Jätä arvoksi `Authorization`, ellei palvelimen dokumentaatiossa toisin mainita. | `Authorization` | | **Auth Header Value**| Itse tunnistetieto siinä muodossa, jota palvelin odottaa. | `Bearer sk_live_abc123` | ### Kirjautumistavan valinta: API-avain vai OAuth Your AI Connector tukee kahta tapaa todentautua palvelimelle. Valitse se, jota palvelimen dokumentaatio ohjeistaa käyttämään, käyttämällä lomakkeen yläreunassa olevaa **Authentication**-valintaa: - **API-avain / otsake:** edellä kuvattu alkuperäinen menetelmä. Liität kiinteän tunnisteen (API-avaimen tai tokenin) **Auth Header Value** -kenttään, ja Your AI Connector lähettää sen jokaisen pyynnön yhteydessä. Paras palvelimille, jotka tarjoavat pitkäikäisen avaimen. - **OAuth (kirjautuminen):** palvelimille, jotka pyytävät kirjautumaan avaimen liittämisen sijaan. OAuthin kohdalla ei tarvitse kopioida avainta – hyväksyt pääsyn kirjautumalla sisään, samalla tavalla kuin "Kirjaudu Googlella" toimii muilla sivustoilla. **Yhdistäminen OAuthilla:** 1. Valitse **OAuth** todennusmenetelmäksi. Auth Header -kentät katoavat ja niiden tilalle tulee **Connect**-kortti – et tarvitse avainta. 2. Täytä **Name** ja **Server URL**, ja napsauta sitten **Save**. Palvelin lisätään luetteloosi, mutta se näkyy toistaiseksi tilassa **not connected**. 3. Napsauta palvelimen kohdalla **Connect**. Avautuu suojattu kirjautumisikkuna, jossa hyväksyt pääsyn. 4. Hyväksy, niin ikkuna sulkeutuu itsestään. Palvelin näkyy nyt yhdistettynä, ja Your AI Connector lataa sen työkalut. Siinä kaikki. Your AI Connector pitää yhteyden tuoreena automaattisesti taustalla, joten sinun ei yleensä tarvitse koskea siihen enää koskaan. Jos palvelin katkaisee yhteyden (esimerkiksi kirjautumisen vanhentuessa tai jos joku peruuttaa sen palvelimen puolella), se näkyy katkaistuna – napsauta vain **Reconnect** ja kirjaudu uudelleen. Jos palvelinta ei voida määrittää automaattisesti, kun napsautat Connect, sinua pyydetään liittämään muutamia tietoja (kirjautumisosoite ja asiakastunnus), jotka palvelimen oma dokumentaatio tarjoaa, minkä jälkeen Connect viimeistelee kirjautumisen. ### Testaa yhteys Ennen tallentamista napsauta **Test Connection**. Your AI Connector ottaa yhteyden palvelimeen ja näyttää luettelon sen tarjoamista työkaluista. Tämä on nopein tapa varmistaa, että URL-osoite ja avain ovat oikein – jos yhteys epäonnistuu, näet virheilmoituksen heti siinä sen sijaan, että huomaisit sen kesken keskustelun. Kun testi onnistuu, napsauta **Tallenna**. Palvelimesi näkyy luettelossa vihreän tilapisteen ja tarjottujen työkalujen määrän kera. ### Palvelinluettelon lukeminen Jokainen luettelon palvelin näyttää: - **Tilapisteen** – vihreä, kun viimeisin yhteys toimi, punainen, kun viimeisin yritys epäonnistui (vie hiiri päälle nähdäksesi virheen), harmaa ennen ensimmäistä onnistunutta yhteyttä. - **Palvelimen osoitteen** ja sen, kuinka monta työkalua se tarjoaa tällä hetkellä. - **Päälle/pois-kytkimen**, jolla voit nopeasti ottaa koko palvelimen käyttöön tai poistaa sen käytöstä poistamatta sitä. Your AI Connector päivittää kunkin palvelimen työkaluluettelon taustalla noin kerran päivässä, joten uudet työkalut ilmestyvät automaattisesti. Hidas tai tilapäisesti tavoittamaton palvelin ei koskaan hidasta keskustelua – botti käyttää yksinkertaisesti viimeisintä tunnettua työkaluluetteloa ja toimii hallitusti, jos kutsu ei mene läpi. ### Valitseminen, mitä työkaluja botti voi käyttää Palvelin tarjoaa usein enemmän työkaluja kuin haluat botin käyttävän. Voit kytkeä yksittäisiä työkaluja päälle tai pois päältä irrottamatta koko palvelinta. 1. Napsauta palvelimen kohdalla luettelossa olevaa **kynäkuvaketta (muokkaa)**. 2. Vieritä **Työkalut**-osioon – jokainen palvelimen tarjoama työkalu on lueteltu, ja jokaisella on oma päälle/pois-kytkin. 3. Kytke pois päältä kaikki työkalut, joita et halua botin kutsuvan, tai käytä **Ota kaikki käyttöön** / **Poista kaikki käytöstä** -painikkeita asettaaksesi ne kerralla. 4. Napsauta **Tallenna muutokset**. Vain ne työkalut, jotka jätät päälle, tarjotaan botille. Pois päältä kytketty työkalu on botille täysin näkymätön – se ei voi kutsua sitä, eikä se lasketa mukaan 40 työkalun rajoitukseen. Kaksi asiaa, jotka on hyvä tietää: - **Uudet työkalut pysyvät pois päältä, kunnes otat ne käyttöön.** Kun olet kuratoinut palvelimen työkalut, kaikki myöhemmin lisätyt työkalut ovat oletuksena pois päältä, joten mitään uutta ei tule botin käyttöön ennen kuin päätät ottaa sen käyttöön. (Palvelimet, joita et ole koskaan kuratoinut, pitävät kaikki työkalunsa päällä, aivan kuten aiemminkin.) - **Tämä on erillinen alla olevasta agenttivalinnasta.** Tässä päätät, mitkä palvelimen työkalut ovat ylipäätään olemassa koko tilin laajuisesti; agentin kohdalla päätät, mitkä palvelimet kyseinen agentti voi tavoittaa — ja voit halutessasi rajata sen työkaluja entisestään vain kyseiselle agentille. ### Suoritusrajojen asettaminen työkaluittain Jokaisen työkalun päälle/pois-kytkimen vierestä löydät **Rajat**-hallintapainikkeen. Se avaa samat suoritusrajat, joita voit asettaa [mukautetulle funktiolle](custom-functions.md#execution-limits), mutta ne koskevat vain kyseistä työkalua. Tämä on hyödyllistä, kun palvelimen työkalu kutsuu maksullista kolmannen osapuolen palvelua tai kun työkalun tulisi suorittua vain kerran keskustelua kohden. Kaikki tässä on valinnaista; jätä kentät tyhjiksi, niin työkalu toimii täsmälleen kuten ennenkin. - **Vain luku.** Jotkin palvelimet ilmoittavat jokaisen työkalun kohdalla, lukeeko se vain tietoja. **Automaattinen (palvelinasetus)** luottaa tähän ilmoitukseen; voit ohittaa sen kumpaan tahansa suuntaan – merkitse työkalu **Vain luku** -tilaan, kun tiedät, ettei se koskaan luo tai muuta mitään (tämä antaa tekoälylle mahdollisuuden yrittää keskeytynyttä vastausta uudelleen sen sijaan, että asiakas jäisi ilman vastausta), tai **Ei vain luku** -tilaan, jos et luota palvelimen ilmoitukseen. - **Tarjoa välimuistista tallennettu tulos toistuvissa kutsuissa.** Kun tekoäly kutsuu työkalua uudelleen samoilla syötteillä, aiempaa tulosta käytetään uudelleen (enintään 24 tunnin ajan) sen sijaan, että palvelimelle tehtäisiin uusi kutsu. - **Enimmäissuoritukset keskustelua kohden** ja **enimmäissuoritukset aikaväliä kohden** toimivat täsmälleen samalla tavalla kuin mukautetuissa funktioissa: ne koskevat vain onnistuneita suorituksia, ja kun raja tulee vastaan, tekoälylle kerrotaan syy ja se vastaa jo hallussaan olevilla tiedoilla – asiakasta ei koskaan jätetä pulaan. Testikeskustelut on vapautettu näistä rajoituksista. Rehellinen huomautus luottamuksesta: rajoitukset hallitsevat sitä, kutsummeko me palvelinta ja kuinka usein – ne eivät voi muuttaa sitä, mitä palvelin tekee sisäisesti kutsun jälkeen. Kolmannen osapuolen työkalun merkitseminen Vain luku -tilaan on vahvempi väite kuin oman mukautetun funktion kohdalla, koska kyseessä on jonkun muun koodi; tee näin vain työkaluille, jotka ymmärrät. --- ## Palvelimen ottaminen käyttöön agentissa Palvelimen rekisteröinti tekee siitä saatavilla olevan; valitset silti itse, mitkä agentit voivat käyttää sitä. 1. Avaa [Agent](../ai-agents/ai-agents.md) ja siirry sen **AI Abilities** -välilehdelle. (Jos kampanjalla on omat AI-asetukset suoraan eikä erillisen agentin kautta, sama luettelo näkyy kyseisen kampanjan omassa **AI Abilities** -vaiheessa.) 2. Etsi **MCP servers** -osio. 3. Ota käyttöön jokainen palvelin, jota haluat tämän agentin botin käyttävän. 4. Napsauta **Save changes** – valinnat tulevat voimaan vasta tallennuksen jälkeen. Voit ottaa käyttöön enintään **5 palvelinta per agentti**. Vain käyttöön ottamasi palvelimet ovat kyseisen agentin botin käytettävissä, mikä pitää botin keskittyneenä olennaisiin työkaluihin. ### Agentin käytettävissä olevien työkalujen valitseminen Kun palvelin on otettu käyttöön agentissa, voit myös rajata, **mitä sen työkaluja** kyseinen agentti saa kutsua — tämä on kätevää, kun yhden agentin tulisi vain lukea tietoja, kun taas toinen saa myös luoda tietueita. 1. Napsauta **AI Abilities** -välilehdellä käytössä olevan palvelimen kohdalla riviä **"… tools enabled for this agent"** laajentaaksesi työkalulistan. 2. Kytke pois päältä kaikki työkalut, joita tämän agentin ei pitäisi käyttää, ja napsauta sitten **Save changes**. Kaksi sääntöä pitävät tämän ennakoitavana: - **Agentti voi vain rajata, ei koskaan laajentaa.** Työkalut, jotka olet kytkenyt pois päältä koko tilin laajuisesti (MCP Servers -sivulla), eivät näy täällä, eikä niitä voi ottaa uudelleen käyttöön yksittäiselle agentille. - **Agentit perivät oletukset.** Agentti, jonka työkalulistaan et ole koskenut, noudattaa yksinkertaisesti tilin laajuisia valintoja — mukaan lukien työkalut, jotka otat käyttöön myöhemmin. Kun olet rajannut agentin listaa, uudet työkalut pysyvät pois päältä kyseiselle agentille, kunnes otat ne käyttöön. --- ## Valmis esimerkki: Yhdistä Shopify-kauppa Jokaisessa Shopify-kaupassa on sisäänrakennettu MCP-palvelin – ei asennettavia sovelluksia tai luotavia avaimia. Shopify isännöi sitä kaupan omassa verkko-osoitteessa, jonka perään on lisätty `/api/mcp`. Mitä botti saa siltä: - **Tuotehaku** – etsi tuotteita kuvailemalla, mitä asiakas haluaa ("lämmin juoksutakki alle 100 dollarilla"), sisältäen reaaliaikaiset hinnat, versiot ja varastotilanteen. - **Tuotetiedot** – kattavat tiedot tietystä tuotteesta, mukaan lukien vaihtoehdot ja saatavuus. - **Kaupan käytännöt ja UKK** – vastaukset toimitus-, palautus-, hyvitys- ja tietosuojakysymyksiin suoraan kaupan omilta sivuilta. - **Ostoskori** – luo asiakkaalle ostoskori ja anna heille kassalinkki. Yhdistä palvelin lisäämällä se seuraavilla tiedoilla: | Kenttä | Mitä syötetään | |---|---| | **Nimi** | `Shopify Store` (tai kaupan nimi) | | **Palvelimen URL-osoite** | Kaupan verkko-osoite ja sen perään `/api/mcp` – esimerkiksi `https://mystore.com/api/mcp`. Myös kaupan tekninen osoite toimii: `https://mystore.myshopify.com/api/mcp`. | | **Todennus** | Jätä valituksi **API key / header** ja jätä **Auth Header Value** tyhjäksi – tämä palvelin ei vaadi avainta. | Tallenna, napsauta **Test Connection** ja ota palvelin käyttöön agentissasi – siinä on koko asennus. Kaksi asiaa, jotka on hyvä tietää: - **Tilaukset eivät ole tällä palvelimella.** Shopify pitää tilaustiedot tarkoituksella poissa tästä julkisesta päätepisteestä. Jos haluat vastata "missä tilaukseni on?" -kysymyksiin, yhdistä tämä palvelin yhteen mukautettuun funktioon – katso [Shopify-tilausten tila -esimerkki](custom-functions.md#complete-example-shopify-order-status). - **Se toimii millä tahansa Shopify-kaupalla** – myös asiakkaan kaupalla, jos hallinnoit muiden tilejä. Tarvitset vain kaupan verkko-osoitteen. --- ## Tietoturva – Yhdistä vain luotettaviin palvelimiin Botti voi kutsua yhdistämääsi MCP-palvelinta, ja se voi palauttaa tekstiä, jota botti lukee ja jonka perusteella se toimii. Käsittele sitä kuten mitä tahansa muuta integraatiota, jolla on pääsy järjestelmiisi: - **Rekisteröi vain palvelimia, joita hallitset tai joihin luotat täysin.** Työkalun kuvauksen kirjoittaa palvelimen ylläpitäjä, ja botti lukee nämä kuvaukset päättääkseen, milloin työkalua käytetään. - **Käytä erillistä, rajoitettua API-avainta**, älä järjestelmänvalvojan tunnuksia. Avaimesi tallennetaan turvallisesti, eikä sitä koskaan näytetä tiedostojen viennissä. Sama koskee OAuth-kirjautumisia – pääsytunnisteet tallennetaan turvallisesti ja ne poistetaan kaikista vientitiedoista. - **URL-osoitteen on oltava julkinen `https://`-osoite.** Sisäverkon, localhost- ja yksityisverkon osoitteet hylätään turvallisuussyistä. - **Poista palvelin käytöstä heti, kun lakkaat luottamasta siihen** – kytke se pois päältä tai poista se, niin se katoaa välittömästi kaikilta agenteilta. --- ## Vianmääritys - **Punainen tilapiste / yhteys epäonnistui:** Avaa palvelin uudelleen ja napsauta **Testaa yhteys** nähdäksesi tarkan virheen. Yleisimmät syyt ovat väärä tai vanhentunut avain, kirjoitusvirhe URL-osoitteessa tai se, että palvelin vaatii muun otsikkonimen kuin `Authorization`. - **OAuth-palvelin lakkasi toimimasta / pyytää kirjautumaan uudelleen:** OAuth-kirjautumiset voidaan peruuttaa tai ne voivat vanhentua palvelimen puolella. Avaa palvelin ja napsauta **Yhdistä** uudelleen kirjautuaksesi sisään. Huomaa, että OAuth-kirjautumisia ei koskaan kopioida tilien välillä, joten kopioidun Agentin tai kampanjan palvelimet on yhdistettävä uudelleen tilillä, johon kopioit ne. - **Botti ei käytä työkalua:** Tarkista ensin, että työkalu on kytketty päälle palvelimen **Työkalut**-osiossa (muokkaa palvelinta nähdäksesi luettelon) – pois päältä kytketty työkalu on botille näkymätön. Varmista sitten, että palvelin on otettu käyttöön kyseisessä Agentissa ja että asiakkaan pyyntö vastaa selvästi työkalun toimintaa. Kuten mukautettujen funktioiden kohdalla, selkeät työkalujen nimet ja kuvaukset palvelimen puolella auttavat bottia valitsemaan oikein. - **Palvelimen tarjoama työkalu ei näy botille:** Jos olet kuratoinut tämän palvelimen työkaluja, muista, että kaikki kuratoinnin jälkeen lisätyt työkalut ovat oletuksena pois päältä. Muokkaa palvelinta, avaa **Työkalut**-osio ja kytke työkalu päälle. - **Käsitteleekö liitin MCP HTTP -istuntoja?** Kyllä. Jos palvelimesi antaa `mcp-session-id`-otsikon yhteyden muodostamisen yhteydessä, tallennamme sen ja lähetämme sen takaisin jokaisessa seuraavassa pyynnössä yhdessä `MCP-Protocol-Version`-otsikon kanssa. Tilalliset palvelimet toimivat ilman ylimääräisiä määrityksiä sinun puoleltasi. - **Työkalu ohitettiin:** Agentti voi käyttää enintään 5 palvelinta ja 40 MCP-työkalua kerrallaan. Jos palvelin tarjoaa erittäin suuren määrän työkaluja, kaikkia ei ehkä ladata – kytke tarpeettomat työkalut pois päältä palvelimen **Työkalut**-osiossa tai pidä kukin palvelin keskittyneenä vain niihin työkaluihin, joita todella käytät. --- ## Tilauksia koskevat vaatimukset MCP-palvelimet ovat osa kehittäjätyökalupakkia, mukautettujen funktioiden ohella. Jos et näe **MCP-palvelimet**-kohtaa sivupalkin AI Studio -osiossa, nykyinen tilauksesi ei sisällä sitä – päivitä tilaus kehittäjätyökalut sisältävään versioon ottaaksesi sen käyttöön. --- ## Seuraavat vaiheet - [Mukautetut funktiot](custom-functions.md) — määritä yksittäinen työkalu käsin sen sijaan, että yhdistäisit koko palvelimen. - [Tekoälyagentit](../ai-agents/ai-agents.md) — paikka, jossa MCP-palvelimet otetaan käyttöön botille. - [Tekoälyagentit](../ai-agents/ai-agents.md) — AI Studion pääsivu, jossa MCP-palvelimet-ryhmä sijaitsee.