MCP Serveri
Savienojiet ārējās rīkus un pakalpojumus ar AI SmartTalk, izmantojot Model Context Protocol (MCP). MCP ir atvērts standarts, kas ļauj jūsu AI asistentam mijiedarboties ar ārējām sistēmām caur vienotu saskarni.
Pārskats
MCP Servera integrācija ļauj jums:
- Vienlaicīgi savienot vairākus MCP serverus
- Izvērst ārējās rīkus jūsu AI, lai tos izmantotu sarunās
- Autentificēties ar pielāgotām HTTP galvenēm (API atslēgas, tokeni utt.)
- Pārbaudīt savienojumus pirms palaišanas
- Paplašināt iespējas bez pielāgotas izstrādes
Kas ir MCP? Model Context Protocol ir atvērts standarts (izstrādāts uzņēmumā Anthropic), kas ļauj AI sistēmām droši savienoties ar ārējiem datu avotiem un rīkiem. Uzziniet vairāk vietnē modelcontextprotocol.io.
Prasības
Pirms sākat, pārliecinieties, ka jums ir:
- Aktīvs AI SmartTalk konts
- Pieeja vienam vai vairākiem MCP saderīgiem serveriem
- Servera URL katram MCP serverim
- Jebkādas nepieciešamās autentifikācijas akreditācijas (API atslēgas, tokeni)
Kā darbojas MCP
- Lietotājs uzdod jautājumu, kas prasa ārējos datus
- AI SmartTalk atpazīst, ka nepieciešams MCP rīks
- Tiek izsaukts atbilstošais MCP serveris ar pareizo rīku
- Atbilde tiek atgriezta un AI formulē atbildi dabiskā valodā
AI SmartTalk atbalsta vairākus MCP serverus vienlaicīgi. Rīki no dažādiem serveriem automātiski tiek nosaukoti, lai novērstu konfliktus.
Soli pa solim iestatīšana
1. solis: Piekļuve MCP integrācijai
- Piesakieties savā AI SmartTalk kontā
- Dodieties uz Administrācija → Mani asistenti → [Jūsu asistenta nosaukums]
- Noklikšķiniet uz Savienotāji kreisajā sānu joslā
- Atrodiet MCP Serveri un noklikšķiniet uz tā
2. solis: Pievienot MCP serveri
Noklikšķiniet uz Pievienot serveri, lai atvērtu servera konfigurācijas veidlapu. Aizpildiet šādas lauciņus:
| Lauks | Nepieciešams | Apraksts |
|---|---|---|
| Servera nosaukums | Jā | Draudzīgs nosaukums, lai identificētu šo serveri (piemēram, "Uzņēmuma CRM", "Iekšējā Wiki") |
| Servera URL | Jā | MCP servera galapunkta URL (piemēram, https://mcp.example.com) |
| HTTP galvenes | Nē | Pielāgotas galvenes autentifikācijai vai citiem prasībām |
AI SmartTalk automātiski pievieno /mcp jūsu URL, ja tas jau nebeidzas ar to. Piemēram, https://example.com kļūst par https://example.com/mcp. Ja jūsu serveris izmanto citu galapunkta ceļu, iekļaujiet to URL (piemēram, https://example.com/api/mcp).
3. solis: Pievienot autentifikācijas galvenes (pēc izvēles)
Ja jūsu MCP serverim nepieciešama autentifikācija, noklikšķiniet uz Pievienot galvenes, lai konfigurētu pielāgotas HTTP galvenes:
| Parastā galvene | Lietošanas gadījums |
|---|---|
Authorization | Bearer tokeni (piemēram, Bearer sk-xxx...) |
X-API-Key | API atslēgas autentifikācija |
X-Auth-Token | Pielāgota tokenu autentifikācija |
Katram galvenei norādiet:
- Atslēga: Galvenes nosaukums (izvēlieties no parastajām galvenēm vai ierakstiet pielāgotu)
- Vērtība: Galvenes vērtība (jutīgas vērtības automātiski tiek maskētas lietotāja saskarnē)
Jūs varat pievienot vairākas galvenes katram serverim. Galvenes, kas satur "slepenais", "parole", "token" vai "auth" atslēgas nosaukumā, automātiski tiek slēptas drošības nolūkos.
4. solis: Pārbaudīt savienojumu
Pirms saglabāšanas noklikšķiniet uz Pārbaudīt savienojumu, lai pārliecinātos, ka jūsu serveris ir sasniedzams:
- AI SmartTalk nosūta JSON-RPC inicializācijas pieprasījumu uz jūsu serveri
- Tests pārbauda vairākus galapunktus secībā:
/mcp,/health, tad bāzes URL - Rezultāti parāda savienojuma statusu, atbildes laiku un servera informāciju
| Testa rezultāts | Nozīme |
|---|---|
| Savienots | Serveris veiksmīgi atbildēja ar MCP protokolu |
| Autentifikācija neizdevās | Pārbaudiet savu API atslēgu vai tokenus galvenēs |
| Serveris netika atrasts | Pārliecinieties, ka URL ir pareizs |
| Savienojums atteikts | Serveris var būt izslēgts vai ugunsmūris bloķē piekļuvi |
| Laika pārsniegums | Serveris atbildēja pārāk ilgi (10s limits) |
| SSL kļūda | Pārbaudiet, vai serverim ir derīgs SSL sertifikāts |
5. solis: Saglabāt konfigurāciju
- Noklikšķiniet uz Pievienot, lai pievienotu serveri jūsu sarakstam
- Atkārtojiet 2.-4. soli, lai pievienotu vairāk MCP serveru, ja nepieciešams
- Noklikšķiniet uz Saglabāt integrāciju, lai aktivizētu visus konfigurētos serverus
Vairāku serveru atbalsts
AI SmartTalk atbalsta vairāku MCP serveru vienlaicīgu savienošanu. Tas ļauj jums apvienot rīkus no dažādiem avotiem:
Rīku nosaukumu telpa
Rīki no katra servera automātiski tiek prefiksēti ar servera nosaukumu, lai novērstu nosaukumu konfliktus. Piemēram:
company_crm__search_customersinternal_wiki__search_docsweather_api__get_forecast
Tas nozīmē, ka jūs varat droši savienot serverus, kas izplata rīkus ar tādu pašu nosaukumu.
Vairāku serveru pārvaldība
Integrācijas informācijas panelis parāda visus konfigurētos serverus ar:
- Servera nosaukumu un URL vieglai identificēšanai
- Galvenes skaita insigni, ja ir konfigurētas pielāgotas galvenes
- Statusa indikatoru (Konfigurēts / Nepabeigts)
- Darbības pogas: Pārbaudīt savienojumu, Rediģēt vai Dzēst individuālos serverus
Rīku atklāšana
Kad jūsu MCP serveri ir savienoti, AI SmartTalk automātiski atklāj visus pieejamos rīkus, ko izplata katrs serveris. Šie rīki nekavējoties kļūst pieejami jūsu AI asistentam.
AI asistents:
- Redz visus pieejamos rīkus no visiem savienotajiem serveriem
- Automātiski izvēlas pareizo rīku, pamatojoties uz lietotāja pieprasījumiem
- Izsauc rīku ar atbilstošiem parametriem
- Apstrādā atbildi un sniedz atbildi dabiskā valodā
Jums nav nepieciešams manuāli konfigurēt vai aktivizēt individuālus rīkus. Visi rīki, ko izplata savienotais MCP serveris, automātiski ir pieejami jūsu AI asistentam.
Lietošanas gadījumi
Klientu attiecību pārvaldība
Savienojiet savu CRM, izmantojot MCP:
- "Meklēt klientu Džonu Smitu"
- "Kāds ir konta #12345 statuss?"
- "Cik daudz atvērtu atbalsta biļešu mums ir?"
Iekšējie rīki
Piekļūstiet uzņēmuma sistēmām:
- "Pārbaudiet krājumus produktam SKU-123"
- "Kas ir plānots rīt?"
- "Meklējiet mūsu iekšējā wiki uzņemšanas dokumentus"
Ārējie datu avoti
Iegūstiet reāllaika datus:
- "Kāds ir pašreizējais laiks Parīzē?"
- "Iegūstiet jaunāko akciju cenu AAPL"
- "Pārbaudiet lidojuma statusu UA123"
Izstrādes rīki
Tehniskajām komandām:
- "Kāds ir jaunākā būvniecības statuss?"
- "Meklējiet mūsu GitHub problēmas par autentifikācijas kļūdām"
- "Pārbaudiet ražošanas serveru veselību"
MCP Server Piemēri
Populārie MCP Serveri
| Serveris | Mērķis | Saite |
|---|---|---|
| Filesystem | Lasīt/rakstīt vietējās failus | Iebūvētais atsauces serveris |
| PostgreSQL | Vaicāt datubāzes | Kopienas serveris |
| GitHub | Repo pārvaldība | Kopienas serveris |
| Slack | Ziņojumu integrācija | Kopienas serveris |
| Google Drive | Failu pārvaldība | Kopienas serveris |
| Brave Search | Tīmekļa meklēšana | Kopienas serveris |
Atrodiet vairāk: Apmeklējiet MCP Serveru Reģistru augošajam kopienas MCP serveru sarakstam.
Pašizvietojami MCP Serveri
Jūs varat izveidot pielāgotus MCP serverus:
- Proprietārajām iekšējām sistēmām
- Pielāgotai biznesa loģikai
- Drošai vai privātai datu piekļuvei
Izmantojiet jebkuru MCP SDK (TypeScript, Python), lai izveidotu savu serveri.
Drošības Apsvērumi
Autentifikācija
Konfigurējiet autentifikāciju, izmantojot HTTP galvenes servera konfigurācijā:
| Metode | Galvenes Piemērs |
|---|---|
| Bearer Token | Authorization: Bearer sk-xxx... |
| API Key | X-API-Key: your-api-key |
| Custom Token | X-Auth-Token: your-token |
Datu Privātums
- MCP pieprasījumi var saturēt lietotāju sarunu datus
- Pārliecinieties, ka jūsu MCP serveris apstrādā datus saskaņā ar jūsu privātuma politikām
- Apsveriet datu uzturēšanas prasības
- AI SmartTalk maskē sensitīvas galvenes vērtības lietotāja saskarnē
Tīkla Drošība
- Izmantojiet HTTPS visām MCP savienojumiem
- Ierobežojiet MCP servera piekļuvi uzticamiem IP
- Ieviesiet pieprasījumu ierobežojumus savā MCP serverī
- Pārliecinieties, ka ir derīgas SSL sertifikāti
Problēmu Novēršana
Savienojuma Problēmas
| Problēma | Risinājums |
|---|---|
| "Savienojums atteikts" | Pārbaudiet servera URL un portu. Pārliecinieties, ka serveris darbojas |
| "Autentifikācija neizdevās" (401) | Pārbaudiet savu API atslēgu vai token galvenēs konfigurācijā |
| "Aizliegts" (403) | Pārbaudiet, vai jūsu akreditācijas dati ir ar nepieciešamajām atļaujām |
| "Serveris netika atrasts" (404) | Pārbaudiet URL. AI SmartTalk automātiski pievieno /mcp |
| "Laika ierobežojums" | Pārbaudiet tīkla savienojamību un ugunsmūra noteikumus. Testam ir 10 sekunžu laika ierobežojums |
| "SSL kļūda" | Pārliecinieties, ka jūsu MCP serverim ir derīgs SSL sertifikāts |
| "Pieprasījumu ierobežojums" (429) | Pārāk daudz pieprasījumu. Gaidiet un mēģiniet vēlreiz, vai palieliniet servera ierobežojumus |
Rīku Problēmas
| Problēma | Risinājums |
|---|---|
| Rīki neparādās | Pārbaudiet, vai MCP serveris pareizi izstaro rīkus. Mēģiniet atsvaidzināt |
| Nepareizi rīki izsaukti | Pārbaudiet, vai servera nosaukumi ir aprakstoši, lai palīdzētu AI izvēlēties pareizi |
| Rīka izsaukums neizdodas | Pārbaudiet servera žurnālus par kļūdām. Pārliecinieties, ka rīks atgriež sagaidāmo formātu |
Biežās Kļūdas
- Aizmirstot
/mcp: AI SmartTalk to pievieno automātiski, bet, ja jūsu galapunkts ir atšķirīgs, iekļaujiet pilnu ceļu - Nepareizs galvenes formāts: Pārliecinieties, ka autentifikācijas galvenes atbilst tam, ko jūsu serveris sagaida
- Dublēti servera nosaukumi: Katram serverim jābūt unik ālam nosaukumam
MCP Serveru Pārvaldība
| Rīcība | Kā |
|---|---|
| Pievienot serveri | Noklikšķiniet uz "Pievienot serveri", aizpildiet detaļas, pārbaudiet un saglabājiet |
| Rediģēt serveri | Noklikšķiniet uz rediģēšanas ikonas servera kartē |
| Pārbaudīt savienojumu | Noklikšķiniet uz pārbaudes ikonas servera kartē |
| Dzēst serveri | Noklikšķiniet uz dzēšanas ikonas servera kartē |
| Saglabāt izmaiņas | Noklikšķiniet uz "Saglabāt integrāciju", lai saglabātu visas izmaiņas |
Labākās Prakses
- Izmantojiet aprakstošus servera nosaukumus: Palīdz AI saprast, kuru serveri vaicāt (piemēram, "Uzņēmuma CRM" nevis "Serveris 1")
- Pārbaudiet pirms saglabāšanas: Vienmēr pārbaudiet savienojumus, lai agrīni atklātu konfigurācijas problēmas
- Sāciet ar vienu serveri: Iegūstiet pārliecību ar vienu integrāciju, pirms pievienojat vairāk
- Droši savus akreditācijas datus: Izmantojiet veltītas API atslēgas AI SmartTalk, nevis personiskos tokenus
- Uzraugiet savus serverus: Izsekojiet, kuri rīki tiek izsaukti un to veiktspēju
- Uzturiet serverus atjauninātus: Pārliecinieties, ka jūsu MCP serveri seko jaunākajai protokola specifikācijai