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ää:

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:

MCP-palvelimen lisääminen (vaihe vaiheelta) #

Napsauta pääsivupalkin AI Studio -kohdasta MCP Servers. Napsauta sitten + Add Server.

Täytä lomake:

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, 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 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:

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.
• 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 — määritä yksittäinen työkalu käsin sen sijaan, että yhdistäisit koko palvelimen.
• Tekoälyagentit — paikka, jossa MCP-palvelimet otetaan käyttöön botille.
• Tekoälyagentit — AI Studion pääsivu, jossa MCP-palvelimet-ryhmä sijaitsee.