MCP Servers
Yhdistä ulkoiset työkalut ja palvelut AI SmartTalkiin käyttäen Model Context Protocol (MCP) -protokollaa. MCP on avoin standardi, joka mahdollistaa AI-avustajasi vuorovaikutuksen ulkoisten järjestelmien kanssa yhtenäisen käyttöliittymän kautta.
Yleiskatsaus
MCP Server -integraatio mahdollistaa sinulle:
- Yhdistää useita MCP-palvelimia samanaikaisesti
- Altistaa ulkoisia työkaluja AI:lle käytettäväksi keskustelujen aikana
- Todentaa mukautetuilla HTTP-otsikoilla (API-avaimet, tokenit jne.)
- Testata yhteyksiä ennen käyttöönottoa
- Laajentaa toimintoja ilman mukautettua kehitystä
Mikä on MCP? Model Context Protocol on avoin standardi (kehitetty Anthropicin toimesta), joka mahdollistaa AI-järjestelmien turvallisen yhdistämisen ulkoisiin tietolähteisiin ja työkaluihin. Lue lisää osoitteesta modelcontextprotocol.io.
Esivaatimukset
Ennen kuin aloitat, varmista, että sinulla on:
- Aktiivinen AI SmartTalk -tili
- Pääsy yhteen tai useampaan MCP-yhteensopivaan palvelimeen
- Kunkin MCP-palvelimen palvelin-URL
- Mahdolliset vaaditut todennustiedot (API-avaimet, tokenit)
Kuinka MCP toimii
- Käyttäjä esittää kysymyksen, joka vaatii ulkoista tietoa
- AI SmartTalk tunnistaa, että se tarvitsee MCP-työkalun
- Oikeaa MCP-palvelinta kutsutaan oikealla työkalulla
- Vastaus palautuu ja AI muotoilee luonnollisen kielen vastauksen
AI SmartTalk tukee useita MCP-palvelimia kerralla. Eri palvelimilta tulevat työkalut nimetään automaattisesti erikseen konfliktien estämiseksi.
Vaiheittainen asennus
Vaihe 1: Pääsy MCP-integraatioon
- Kirjaudu AI SmartTalk -tilillesi
- Siirry kohtaan Hallinta → Omat avustajat → [Avustajasi nimi]
- Napsauta Liittimet vasemmassa sivupalkissa
- Etsi MCP Servers ja napsauta sitä
Vaihe 2: Lisää MCP-palvelin
Napsauta Lisää palvelin avataksesi palvelinmäärityslomakkeen. Täytä seuraavat kentät:
| Kenttä | Pakollinen | Kuvaus |
|---|---|---|
| Palvelimen nimi | Kyllä | Ystävällinen nimi tämän palvelimen tunnistamiseksi (esim. "Yrityksen CRM", "Sisäinen Wiki") |
| Palvelimen URL | Kyllä | MCP-palvelimen päätepisteen URL (esim. https://mcp.example.com) |
| HTTP-otsikot | Ei | Mukautetut otsikot todennusta tai muita vaatimuksia varten |
AI SmartTalk lisää automaattisesti /mcp URL-osoitteesi loppuun, jos se ei jo pääty siihen. Esimerkiksi, https://example.com muuttuu https://example.com/mcp. Jos palvelimesi käyttää eri päätepistepolkua, sisällytä se URL-osoitteeseen (esim. https://example.com/api/mcp).
Vaihe 3: Lisää todennusotsikot (valinnainen)
Jos MCP-palvelimesi vaatii todennusta, napsauta Lisää otsikot mukautettujen HTTP-otsikoiden määrittämiseksi:
| Yleinen otsikko | Käyttötapa |
|---|---|
Authorization | Bearer-tokenit (esim. Bearer sk-xxx...) |
X-API-Key | API-avaimen todennus |
X-Auth-Token | Mukautetun tokenin todennus |
Jokaiselle otsikolle anna:
- Avain: Otsikon nimi (valitse yleisistä otsikoista tai kirjoita mukautettu)
- Arvo: Otsikon arvo (herkät arvot peitetään automaattisesti käyttöliittymässä)
Voit lisätä useita otsikoita per palvelin. Otsikot, jotka sisältävät "salaisuus", "salasana", "token" tai "auth" avaimen nimessä, piilotetaan automaattisesti turvallisuuden vuoksi.
Vaihe 4: Testaa yhteys
Ennen tallentamista napsauta Testaa yhteys varmistaaksesi, että palvelin on saavutettavissa:
- AI SmartTalk lähettää JSON-RPC-initialisointipyynnön palvelimellesi
- Testi tarkistaa useita päätepisteitä järjestyksessä:
/mcp,/health, sitten perus-URL - Tulokset näyttävät yhteystilan, vasteajan ja palvelintiedot
| Testitulokset | Merkitys |
|---|---|
| Yhdistetty | Palvelin vastasi onnistuneesti MCP-protokollalla |
| Todennus epäonnistui | Tarkista API-avain tai token otsikoissa |
| Palvelinta ei löytynyt | Varmista, että URL on oikea |
| Yhteys kielletty | Palvelin saattaa olla alhaalla tai palomuuri estää pääsyn |
| Aika loppui | Palvelin kesti liian kauan vastata (10s raja) |
| SSL-virhe | Tarkista, että palvelimella on voimassa oleva SSL-sertifikaatti |
Vaihe 5: Tallenna määritys
- Napsauta Lisää lisätäksesi palvelimen luetteloosi
- Toista Vaiheet 2-4 lisätäksesi lisää MCP-palvelimia tarvittaessa
- Napsauta Tallenna integraatio aktivoidaksesi kaikki määritetyt palvelimet
Monipalvelintuki
AI SmartTalk tukee useiden MCP-palvelimien yhdistämistä samanaikaisesti. Tämä mahdollistaa työkalujen yhdistämisen eri lähteistä:
Työkalujen nimensijoitus
Jokaiselta palvelimelta tulevat työkalut saavat automaattisesti etuliitteen palvelimen nimestä nimikonfliktien estämiseksi. Esimerkiksi:
company_crm__search_customersinternal_wiki__search_docsweather_api__get_forecast
Tämä tarkoittaa, että voit turvallisesti yhdistää palvelimia, jotka altistavat työkaluja, joilla on sama nimi.
Useiden palvelimien hallinta
Integraatiopaneeli näyttää kaikki määritetyt palvelimet, joissa on:
- Palvelimen nimi ja URL helppoa tunnistamista varten
- Otsikoiden määrä -merkki, jos mukautettuja otsikoita on määritetty
- Tilaindikaattori (Määritetty / Epätäydellinen)
- Toimintopainikkeet: Testaa yhteys, Muokkaa tai Poista yksittäiset palvelimet
Työkalujen löytäminen
Kun MCP-palvelimesi on yhdistetty, AI SmartTalk löytää automaattisesti kaikki käytettävissä olevat työkalut, jotka jokainen palvelin altistaa. Nämä työkalut tulevat heti saataville AI-avustajallesi.
AI-avustaja:
- Näkee luettelon kaikista käytettävissä olevista työkaluista kaikilta yhdistetyiltä palvelimilta
- Valitsee automaattisesti oikean työkalun käyttäjän kysymysten perusteella
- Kutsuu työkalua asianmukaisilla parametreilla
- Käsittelee vastauksen ja antaa luonnollisen kielen vastauksen
Sinun ei tarvitse määrittää tai aktivoida yksittäisiä työkaluja manuaalisesti. Kaikki yhdistetyn MCP-palvelimen altistamat työkalut ovat automaattisesti saatavilla AI-avustajallesi.
Käyttötapaukset
Asiakkuudenhallinta
Yhdistä CRM:si MCP:n kautta:
- "Etsi asiakas John Smith"
- "Mikä on tilin #12345 tila?"
- "Kuinka monta avointa tukipyyntöä meillä on?"
Sisäiset työkalut
Pääsy yritysjärjestelmiin:
- "Tarkista varasto tuotteen SKU-123 osalta"
- "Mitä on aikataulussa huomenna?"
- "Etsi sisäisestä wikistämme perehdytysdokumentteja"
Ulkoiset tietolähteet
Hae reaaliaikaista tietoa:
- "Mikä on nykyinen sää Pariisissa?"
- "Hae AAPL:n viimeisin osakekurssi"
- "Tarkista lennon tila UA123"
Kehitystyökalut
Teknisille tiimeille:
- "Mikä on viimeisimmän rakennuksen tila?"
- "Etsi GitHub-ongelmistamme todennusvirheitä"
- "Tarkista tuotantopalvelimien tila"
MCP Server Esimerkit
Suositut MCP Palvelimet
| Palvelin | Tarkoitus | Linkki |
|---|---|---|
| Filesystem | Lue/kirjoita paikallisia tiedostoja | Sisäänrakennettu viittauspalvelin |
| PostgreSQL | Kyselytietokantoihin | Yhteisön palvelin |
| GitHub | Repo-hallinta | Yhteisön palvelin |
| Slack | Viestintäintegraatio | Yhteisön palvelin |
| Google Drive | Tiedostohallinta | Yhteisön palvelin |
| Brave Search | Verkkohaku | Yhteisön palvelin |
Löydä lisää: Vieraile MCP Server Registry -sivustolla saadaksesi lisää yhteisön MCP palvelimista.
Itse Isännöidyt MCP Palvelimet
Voit luoda mukautettuja MCP palvelimia:
- Proprietaarisille sisäisille järjestelmille
- Mukautetulle liiketoimintalogiikalle
- Turvalliseen tai yksityiseen tietoon pääsyyn
Käytä mitä tahansa MCP SDK:ta (TypeScript, Python) rakentaaksesi oman palvelimesi.
Turvallisuusnäkökohdat
Varmennus
Määritä varmennus HTTP-otsikoiden kautta palvelimen konfiguraatiossa:
| Menetelmä | Otsikk esimerkki |
|---|---|
| Bearer Token | Authorization: Bearer sk-xxx... |
| API Key | X-API-Key: your-api-key |
| Mukautettu Token | X-Auth-Token: your-token |
Tietosuoja
- MCP-pyynnöt saattavat sisältää käyttäjän keskusteludataa
- Varmista, että MCP palvelimesi käsittelee tietoja tietosuojakäytäntöjesi mukaisesti
- Ota huomioon tietojen oleskeluvaatimukset
- AI SmartTalk peittää herkät otsikkotiedot käyttöliittymässä
Verkon turvallisuus
- Käytä HTTPS:ää kaikissa MCP-yhteyksissä
- Rajoita MCP palvelimen pääsy luotettuihin IP-osoitteisiin
- Toteuta nopeusrajoituksia MCP palvelimellasi
- Varmista, että voimassa olevat SSL-sertifikaatit ovat käytössä
Vianetsintä
Yhteysongelmat
| Ongelma | Ratkaisu |
|---|---|
| "Yhteys kielletty" | Tarkista palvelimen URL ja portti. Varmista, että palvelin on käynnissä |
| "Varmennus epäonnistui" (401) | Varmista API-avaimesi tai tokenisi otsikoiden konfiguraatiossa |
| "Kielletty" (403) | Tarkista, että tunnuksillasi on tarvittavat oikeudet |
| "Palvelinta ei löytynyt" (404) | Varmista URL. AI SmartTalk lisää /mcp automaattisesti |
| "Aika loppui" | Tarkista verkkoyhteys ja palomuurisäännöt. Testillä on 10 sekunnin aikaraja |
| "SSL-virhe" | Varmista, että MCP palvelimellasi on voimassa oleva SSL-sertifikaatti |
| "Nopeusrajoitus" (429) | Liian monta pyyntöä. Odota ja yritä uudelleen tai lisää palvelimen rajoja |
Työkaluongelmat
| Ongelma | Ratkaisu |
|---|---|
| Työkalut eivät näy | Varmista, että MCP palvelin altistaa työkalut oikein. Yritä päivittää |
| Väärät työkalut kutsuttu | Tarkista, että palvelinnimet ovat kuvaavia auttaakseen AI:ta valitsemaan oikein |
| Työkalukutsu epäonnistuu | Tarkista palvelinlokit virheiden varalta. Varmista, että työkalu palauttaa odotetun muodon |
Yleiset virheet
- Unohtaminen
/mcp: AI SmartTalk lisää sen automaattisesti, mutta jos päätepisteesi on erilainen, sisällytä koko polku - Väärä otsikkomuoto: Varmista, että varmennusotsikot vastaavat sitä, mitä palvelimesi odottaa
- Kaksinkertaiset palvelinnimet: Jokaisella palvelimella on oltava ainutlaatuinen nimi
MCP Palvelimien Hallinta
| Toiminto | Kuinka |
|---|---|
| Lisää palvelin | Napsauta "Lisää palvelin", täytä tiedot, testaa ja tallenna |
| Muokkaa palvelinta | Napsauta muokkausikonia palvelinkortilla |
| Testaa yhteys | Napsauta testikuvaketta palvelinkortilla |
| Poista palvelin | Napsauta poistoikonia palvelinkortilla |
| Tallenna muutokset | Napsauta "Tallenna integraatio" tallentaaksesi kaikki muutokset |
Parhaat käytännöt
- Käytä kuvaavia palvelinnimiä: Auttaa AI:ta ymmärtämään, mikä palvelin kysytään (esim. "Yrityksen CRM" sen sijaan, että "Palvelin 1")
- Testaa ennen tallentamista: Testaa aina yhteydet, jotta saat kiinni konfiguraatio-ongelmista aikaisessa vaiheessa
- Aloita yhdellä palvelimella: Totu yhteen integraatioon ennen kuin lisäät lisää
- Varmista tunnuksesi: Käytä omistettuja API-avaimia AI SmartTalkille, älä henkilökohtaisia tokeneita
- Seuraa palvelimiasi: Seuraa, mitkä työkalut kutsutaan ja niiden suorituskykyä
- Pidä palvelimet ajan tasalla: Varmista, että MCP palvelimesi noudattavat uusinta protokollan määrittelyä