MCP Strežniki
Povežite zunanja orodja in storitve z AI SmartTalk z uporabo Model Context Protocol (MCP). MCP je odprti standard, ki omogoča vašemu AI asistentu interakcijo z zunanjimi sistemi prek enotnega vmesnika.
Pregled
Integracija MCP Strežnika vam omogoča:
- Hkratno povezovanje več MCP strežnikov
- Izpostavljanje zunanjih orodij za klice vašega AI med pogovori
- Avtentikacijo s prilagojenimi HTTP glavi (API ključi, žetoni itd.)
- Preizkušanje povezav pred aktivacijo
- Razširitev zmogljivosti brez prilagojenega razvoja
Kaj je MCP? Model Context Protocol je odprti standard (razvila ga je Anthropic), ki omogoča AI sistemom, da se varno povežejo z zunanjimi podatkovnimi viri in orodji. Več informacij najdete na modelcontextprotocol.io.
Predpogoji
Preden začnete, se prepričajte, da imate:
- Aktivno AI SmartTalk račun
- Dostop do enega ali več MCP-združljivih strežnikov
- URL strežnika za vsak MCP strežnik
- Vse potrebne avtentikacijske podatke (API ključi, žetoni)
Kako deluje MCP
- Uporabnik postavi vprašanje, ki zahteva zunanje podatke
- AI SmartTalk prepozna, da potrebuje MCP orodje
- Kliče se ustrezen MCP strežnik z pravim orodjem
- Odgovor se vrne in AI oblikuje odgovor v naravnem jeziku
AI SmartTalk podpira več MCP strežnikov hkrati. Orodja iz različnih strežnikov so samodejno poimenovana, da se preprečijo konflikti.
Navodila po korakih
Korak 1: Dostop do MCP Integracije
- Prijavite se v svoj AI SmartTalk račun
- Pojdite na Upravljanje → Moji asistenti → [Ime vašega asistenta]
- Kliknite na Povezovalci v levem stranskem meniju
- Poiščite MCP Strežniki in kliknite nanj
Korak 2: Dodajte MCP Strežnik
Kliknite Dodaj strežnik, da odprete obrazec za konfiguracijo strežnika. Izpolnite naslednja polja:
| Polje | Obvezno | Opis |
|---|---|---|
| Ime strežnika | Da | Prijazno ime za identifikacijo tega strežnika (npr. "CRM podjetja", "Notranja wiki") |
| URL strežnika | Da | URL končne točke MCP strežnika (npr. https://mcp.example.com) |
| HTTP glave | Ne | Prilagojene glave za avtentikacijo ali druge zahteve |
AI SmartTalk samodejno doda /mcp na vaš URL, če se ne konča že z njim. Na primer, https://example.com postane https://example.com/mcp. Če vaš strežnik uporablja drugačno končno točko, jo vključite v URL (npr. https://example.com/api/mcp).
Korak 3: Dodajte Avtentikacijske Glave (neobvezno)
Če vaš MCP strežnik zahteva avtentikacijo, kliknite Dodaj glave, da konfigurirate prilagojene HTTP glave:
| Pogosta glava | Uporaba |
|---|---|
Authorization | Žetoni nosilca (npr. Bearer sk-xxx...) |
X-API-Key | Avtentikacija z API ključem |
X-Auth-Token | Avtentikacija s prilagojenim žetonom |
Za vsako glavo navedite:
- Ključ: Ime glave (izberite iz pogostih glav ali vnesite prilagojeno)
- Vrednost: Vrednost glave (občutljive vrednosti so samodejno maskirane v uporabniškem vmesniku)
Lahko dodate več glav na strežnik. Glave, ki vsebujejo "secret", "password", "token" ali "auth" v imenu ključa, so samodejno skrite zaradi varnosti.
Korak 4: Preizkusite Povezavo
Pred shranjevanjem kliknite Preizkusite povezavo, da preverite, ali je vaš strežnik dosegljiv:
- AI SmartTalk pošlje JSON-RPC inicializacijsko zahtevo vašemu strežniku
- Preizkus preveri več končnih točk zaporedoma:
/mcp,/health, nato osnovni URL - Rezultati prikazujejo stanje povezave, čas odziva in informacije o strežniku
| Rezultat preizkusa | Pomen |
|---|---|
| Povezano | Strežnik je uspešno odgovoril z MCP protokolom |
| Avtentikacija ni uspela | Preverite svoj API ključ ali žeton v glavah |
| Strežnik ni bil najden | Preverite, ali je URL pravilen |
| Povezava zavrnjena | Strežnik je morda nedosegljiv ali požarni zid blokira dostop |
| Časovna omejitev | Strežnik je predolgo odgovarjal (omejitev 10s) |
| SSL napaka | Preverite, ali ima strežnik veljaven SSL certifikat |
Korak 5: Shranite Konfiguracijo
- Kliknite Dodaj, da dodate strežnik na svoj seznam
- Ponovite korake 2-4, da dodate več MCP strežnikov, če je potrebno
- Kliknite Shrani integracijo, da aktivirate vse konfigurirane strežnike
Podpora za več strežnikov
AI SmartTalk podpira povezovanje več MCP strežnikov hkrati. To vam omogoča, da združite orodja iz različnih virov:
Poimenovanje Orodij
Orodja iz vsakega strežnika so samodejno predpono z imenom strežnika, da se preprečijo konflikti imen. Na primer:
company_crm__search_customersinternal_wiki__search_docsweather_api__get_forecast
To pomeni, da lahko varno povežete strežnike, ki izpostavljajo orodja z istim imenom.
Upravljanje z Več Strežniki
Nadzorna plošča integracije prikazuje vse konfigurirane strežnike z:
- Imenom strežnika in URL za enostavno identifikacijo
- Oznako števila glav, če so konfigurirane prilagojene glave
- Kazalnikom stanja (Konfigurirano / Nepopolno)
- Gumbi za dejanja: Preizkusite povezavo, Uredite ali Izbrišite posamezne strežnike
Odkritje Orodij
Ko so vaši MCP strežniki povezani, AI SmartTalk samodejno odkrije vsa razpoložljiva orodja, ki jih izpostavlja vsak strežnik. Ta orodja postanejo takoj na voljo vašemu AI asistentu.
AI asistent bo:
- Videti seznam vseh razpoložljivih orodij iz vseh povezanih strežnikov
- Samodejno izbral pravo orodje na podlagi uporabniških poizvedb
- Klical orodje z ustreznimi parametri
- Obdelal odgovor in zagotovil odgovor v naravnem jeziku
Ni vam treba ročno konfigurirati ali omogočiti posameznih orodij. Vsa orodja, ki jih izpostavlja povezan MCP strežnik, so samodejno na voljo vašemu AI asistentu.
Uporabniški Primeri
Upravljanje s Strankami
Povežite svoj CRM prek MCP:
- "Poiščite stranko Johna Smitha"
- "Kakšno je stanje računa #12345?"
- "Koliko odprtih podpornih zahtevkov imamo?"
Notranja Orodja
Dostop do sistemov podjetja:
- "Preverite zalogo za izdelek SKU-123"
- "Kaj je na urniku za jutri?"
- "Išči v naši notranji wiki za dokumente o uvajanju"
Zunanji Podatkovni Viri
Pridobivanje živega podatka:
- "Kakšno je trenutno vreme v Parizu?"
- "Pridobite najnovejšo ceno delnice za AAPL"
- "Preverite status leta za UA123"
Razvojna Orodja
Za tehnične ekipe:
- "Kakšno je stanje najnovejše gradnje?"
- "Išči naše GitHub težave za napake pri avtentikaciji"
- "Preverite zdravje produkcijskih strežnikov"
MCP Strežnik Primeri
Priljubljeni MCP Strežniki
| Strežnik | Namen | Povezava |
|---|---|---|
| Filesystem | Branje/pisanje lokalnih datotek | Vgrajen referenčni strežnik |
| PostgreSQL | Poizvedovanje po podatkovnih bazah | Skupnostni strežnik |
| GitHub | Upravljanje repozitorijev | Skupnostni strežnik |
| Slack | Integracija sporočil | Skupnostni strežnik |
| Google Drive | Upravljanje datotek | Skupnostni strežnik |
| Brave Search | Spletno iskanje | Skupnostni strežnik |
Najdite več: Obiščite MCP Strežniški Register za naraščajoč seznam skupnostnih MCP strežnikov.
Samostojni MCP Strežniki
Lahko ustvarite prilagojene MCP strežnike za:
- Lastniške notranje sisteme
- Prilagojeno poslovno logiko
- Varen ali zaseben dostop do podatkov
Uporabite katero koli MCP SDK (TypeScript, Python) za gradnjo lastnega strežnika.
Varnostne Upoštevnosti
Avtentikacija
Konfigurirajte avtentikacijo preko HTTP Headerjev v konfiguraciji strežnika:
| Metoda | Primer Headerja |
|---|---|
| Bearer Token | Authorization: Bearer sk-xxx... |
| API Ključ | X-API-Key: your-api-key |
| Prilagojen Token | X-Auth-Token: your-token |
Zasebnost Podatkov
- MCP poizvedbe lahko vsebujejo podatke o uporabniških pogovorih
- Poskrbite, da vaš MCP strežnik ravna s podatki v skladu z vašimi politikami zasebnosti
- Upoštevajte zahteve glede prebivališča podatkov
- AI SmartTalk prikriva občutljive vrednosti headerjev v uporabniškem vmesniku
Omrežna Varnost
- Uporabite HTTPS za vse MCP povezave
- Omejite dostop do MCP strežnika na zaupanja vredne IP naslove
- Uvedite omejevanje hitrosti na vašem MCP strežniku
- Poskrbite, da so veljavni SSL certifikati na voljo
Odpravljanje Težav
Težave s Povezavo
| Težava | Rešitev |
|---|---|
| "Povezava zavrnjena" | Preverite URL strežnika in vrata. Poskrbite, da strežnik deluje |
| "Avtentikacija ni uspela" (401) | Preverite vaš API ključ ali token v konfiguraciji headerjev |
| "Prepovedano" (403) | Preverite, da imajo vaše poverilnice potrebna dovoljenja |
| "Strežnik ni najden" (404) | Preverite URL. AI SmartTalk samodejno doda /mcp |
| "Časovna omejitev" | Preverite omrežno povezljivost in pravila požarnega zidu. Test ima časovno omejitev 10 sekund |
| "SSL napaka" | Poskrbite, da ima vaš MCP strežnik veljaven SSL certifikat |
| "Omejena hitrost" (429) | Preveč poizvedb. Počakajte in poskusite znova ali povečajte omejitve strežnika |
Težave s Orodji
| Težava | Rešitev |
|---|---|
| Orodja se ne prikazujejo | Preverite, ali MCP strežnik pravilno izpostavlja orodja. Poskusite osvežiti |
| Klicana napačna orodja | Preverite, ali so imena strežnikov opisna, da AI lažje izbere pravilno |
| Klic orodja ni uspel | Preverite dnevniške datoteke strežnika za napake. Poskrbite, da orodje vrne pričakovano obliko |
Pogoste Napake
- Pozabljanje na
/mcp: AI SmartTalk ga doda samodejno, vendar če je vaša končna točka drugačna, vključite celotno pot - Napačna oblika headerja: Prepričajte se, da headerji za avtentikacijo ustrezajo tistemu, kar vaš strežnik pričakuje
- Podvojena imena strežnikov: Vsak strežnik mora imeti edinstveno ime
Upravljanje MCP Strežnikov
| Dejanje | Kako |
|---|---|
| Dodaj strežnik | Kliknite "Dodaj Strežnik", izpolnite podrobnosti, preizkusite in shranite |
| Uredi strežnik | Kliknite ikono za urejanje na kartici strežnika |
| Preizkusi povezavo | Kliknite ikono za preizkus na kartici strežnika |
| Izbriši strežnik | Kliknite ikono za brisanje na kartici strežnika |
| Shrani spremembe | Kliknite "Shrani Integracijo", da ohranite vse spremembe |
Najboljše Prakse
- Uporabite opisna imena strežnikov: Pomaga AI razumeti, kateri strežnik naj poizve |
- Preizkusite pred shranjevanjem: Vedno preizkusite povezave, da zgodaj odkrijete težave s konfiguracijo |
- Začnite z enim strežnikom: Udobno se spoznajte z eno integracijo, preden dodate več |
- Zavarujte svoje poverilnice: Uporabite posebne API ključe za AI SmartTalk, ne osebnih tokenov |
- Nadzorujte svoje strežnike: Sledite, katera orodja so klicana in njihovo delovanje |
- Ohranjajte strežnike posodobljene: Poskrbite, da vaši MCP strežniki sledijo najnovejši specifikaciji protokola |