MCP Servery
Pripojte externé nástroje a služby k AI SmartTalk pomocou Model Context Protocol (MCP). MCP je otvorený štandard, ktorý umožňuje vášmu AI asistentovi interagovať s externými systémami prostredníctvom jednotného rozhrania.
Prehľad
Integrácia MCP Server vám umožňuje:
- Pripojiť viacero MCP serverov súčasne
- Exponovať externé nástroje pre váš AI na volanie počas rozhovorov
- Autentifikovať pomocou vlastných HTTP hlavičiek (API kľúče, tokeny atď.)
- Testovať pripojenia pred spustením do prevádzky
- Rozšíriť funkcie bez vlastného vývoja
Čo je MCP? Model Context Protocol je otvorený štandard (vyvinutý spoločnosťou Anthropic), ktorý umožňuje AI systémom bezpečne sa pripojiť k externým zdrojom dát a nástrojom. Viac informácií nájdete na modelcontextprotocol.io.
Predpoklady
Predtým, ako začnete, zabezpečte, aby ste mali:
- Aktívny účet AI SmartTalk
- Prístup k jednému alebo viacerým serverom kompatibilným s MCP
- URL adresu servera pre každý MCP server
- Akékoľvek požadované autentifikačné údaje (API kľúče, tokeny)
Ako MCP funguje
- Používateľ sa pýta na otázku, ktorá vyžaduje externé dáta
- AI SmartTalk rozpozná, že potrebuje MCP nástroj
- Správny MCP server je zavolaný so správnym nástrojom
- Odpoveď je vrátená a AI formuluje odpoveď v prirodzenom jazyku
AI SmartTalk podporuje viacero MCP serverov naraz. Nástroje z rôznych serverov sú automaticky menované, aby sa predišlo konfliktom.
Postupná konfigurácia
Krok 1: Prístup k integrácii MCP
- Prihláste sa do svojho účtu AI SmartTalk
- Prejdite na Administrácia → Moji asistenti → [Názov vášho asistenta]
- Kliknite na Konektory v ľavom bočnom paneli
- Nájdite MCP Servery a kliknite naň
Krok 2: Pridať MCP server
Kliknite na Pridať server, aby ste otvorili formulár na konfiguráciu servera. Vyplňte nasledujúce polia:
| Pole | Povinné | Popis |
|---|---|---|
| Názov servera | Áno | Priateľský názov na identifikáciu tohto servera (napr. "CRM spoločnosti", "Interná wiki") |
| URL servera | Áno | URL adresa koncového bodu MCP servera (napr. https://mcp.example.com) |
| HTTP hlavičky | Nie | Vlastné hlavičky na autentifikáciu alebo iné požiadavky |
AI SmartTalk automaticky pridáva /mcp k vašej URL, ak už nekončí týmto spôsobom. Napríklad, https://example.com sa stane https://example.com/mcp. Ak váš server používa iný koncový bod, zahrňte ho do URL (napr. https://example.com/api/mcp).
Krok 3: Pridať autentifikačné hlavičky (voliteľné)
Ak váš MCP server vyžaduje autentifikáciu, kliknite na Pridať hlavičky, aby ste nakonfigurovali vlastné HTTP hlavičky:
| Bežná hlavička | Použitie |
|---|---|
Authorization | Bearer tokeny (napr. Bearer sk-xxx...) |
X-API-Key | Autentifikácia pomocou API kľúča |
X-Auth-Token | Autentifikácia pomocou vlastného tokenu |
Pre každú hlavičku poskytnite:
- Kľúč: Názov hlavičky (vyberte z bežných hlavičiek alebo zadajte vlastný)
- Hodnota: Hodnota hlavičky (citlivé hodnoty sú automaticky maskované v UI)
Môžete pridať viacero hlavičiek na server. Hlavičky obsahujúce "secret", "password", "token" alebo "auth" v názve kľúča sú automaticky skryté z bezpečnostných dôvodov.
Krok 4: Otestovať pripojenie
Pred uložením kliknite na Otestovať pripojenie, aby ste overili, že váš server je dostupný:
- AI SmartTalk odošle JSON-RPC inicializačný požiadavok na váš server
- Test kontroluje viacero koncových bodov v poradí:
/mcp,/health, potom základnú URL - Výsledky zobrazujú stav pripojenia, čas odpovede a informácie o serveri
| Výsledok testu | Význam |
|---|---|
| Pripojené | Server úspešne odpovedal s protokolom MCP |
| Autentifikácia zlyhala | Skontrolujte svoj API kľúč alebo token v hlavičkách |
| Server nenájdený | Overte, že URL je správna |
| Pripojenie odmietnuté | Server môže byť vypnutý alebo firewall blokuje prístup |
| Časový limit | Server trval príliš dlho na odpoveď (limit 10s) |
| SSL chyba | Skontrolujte, či má server platný SSL certifikát |
Krok 5: Uložiť konfiguráciu
- Kliknite na Pridať, aby ste pridali server do svojho zoznamu
- Opakujte kroky 2-4, aby ste pridali ďalšie MCP servery, ak je to potrebné
- Kliknite na Uložiť integráciu, aby ste aktivovali všetky nakonfigurované servery
Podpora viacerých serverov
AI SmartTalk podporuje pripojenie viacerých MCP serverov súčasne. To vám umožňuje kombinovať nástroje z rôznych zdrojov:
Názvoslovie nástrojov
Nástroje z každého servera sú automaticky predponované názvom servera, aby sa predišlo konfliktom názvov. Napríklad:
company_crm__search_customersinternal_wiki__search_docsweather_api__get_forecast
To znamená, že môžete bezpečne pripojiť servery, ktoré exponujú nástroje so rovnakým názvom.
Správa viacerých serverov
Informačný panel integrácie zobrazuje všetky nakonfigurované servery s:
- Názvom servera a URL pre jednoduchú identifikáciu
- Odznakom počtu hlavičiek, ak sú nakonfigurované vlastné hlavičky
- Indikátorom stavu (Nakonfigurované / Neúplné)
- Tlačidlami akcií: Otestovať pripojenie, Upraviť alebo Odstrániť jednotlivé servery
Objavovanie nástrojov
Akonáhle sú vaše MCP servery pripojené, AI SmartTalk automaticky objavuje všetky dostupné nástroje exponované každým serverom. Tieto nástroje sú okamžite dostupné vášmu AI asistentovi.
AI asistent:
- Uvidí zoznam všetkých dostupných nástrojov zo všetkých pripojených serverov
- Automaticky vyberie správny nástroj na základe otázok používateľa
- Zavolá nástroj s príslušnými parametrami
- Spracuje odpoveď a poskytne odpoveď v prirodzenom jazyku
Nemusíte manuálne konfigurovať alebo aktivovať jednotlivé nástroje. Všetky nástroje exponované pripojeným MCP serverom sú automaticky dostupné vášmu AI asistentovi.
Prípadové štúdie
Správa vzťahov so zákazníkmi
Pripojte svoj CRM cez MCP:
- "Vyhľadaj zákazníka Johna Smitha"
- "Aký je stav účtu #12345?"
- "Koľko máme otvorených podporných tiketov?"
Interné nástroje
Prístup k firemným systémom:
- "Skontroluj zásoby pre produkt SKU-123"
- "Čo je na programe na zajtra?"
- "Vyhľadaj naše interné wiki pre dokumenty o onboardingu"
Externé zdroje dát
Získajte živé dáta:
- "Aké je aktuálne počasie v Paríži?"
- "Získaj najnovšiu cenu akcií pre AAPL"
- "Skontroluj stav letu UA123"
Vývojové nástroje
Pre technické tímy:
- "Aký je stav najnovšej zostavy?"
- "Vyhľadaj naše GitHub problémy pre chyby autentifikácie"
- "Skontroluj stav produkčných serverov"
MCP Server Príklady
Populárne MCP Servery
| Server | Účel | Odkaz |
|---|---|---|
| Filesystem | Čítanie/zápis miestnych súborov | Vstavaný referenčný server |
| PostgreSQL | Dotazovanie databáz | Komunitný server |
| GitHub | Správa repozitárov | Komunitný server |
| Slack | Integrácia správ | Komunitný server |
| Google Drive | Správa súborov | Komunitný server |
| Brave Search | Vyhľadávanie na webe | Komunitný server |
Nájdite viac: Navštívte MCP Server Registry pre rastúci zoznam komunitných MCP serverov.
Samo-hostované MCP Servery
Môžete vytvoriť vlastné MCP servery pre:
- Proprietárne interné systémy
- Vlastnú obchodnú logiku
- Bezpečný alebo súkromný prístup k údajom
Použite akékoľvek MCP SDK (TypeScript, Python) na vytvorenie vlastného servera.
Bezpečnostné Úvahy
Autentifikácia
Konfigurujte autentifikáciu cez HTTP Hlavičky v konfigurácii servera:
| Metóda | Príklad Hlavičky |
|---|---|
| Bearer Token | Authorization: Bearer sk-xxx... |
| API Kľúč | X-API-Key: your-api-key |
| Vlastný Token | X-Auth-Token: your-token |
Ochrana Údajov
- MCP požiadavky môžu obsahovať údaje o konverzáciách používateľov
- Zabezpečte, aby váš MCP server spracovával údaje v súlade s vašimi politikami ochrany osobných údajov
- Zvážte požiadavky na umiestnenie údajov
- AI SmartTalk maskuje citlivé hodnoty hlavičiek v UI
Sieťová Bezpečnosť
- Použite HTTPS pre všetky MCP pripojenia
- Obmedzte prístup k MCP serveru na dôveryhodné IP adresy
- Implementujte obmedzenie rýchlosti na vašom MCP serveri
- Zabezpečte, aby platné SSL certifikáty boli na mieste
Riešenie Problémov
Problémy s Pripojením
| Problém | Riešenie |
|---|---|
| "Pripojenie odmietnuté" | Skontrolujte URL servera a port. Uistite sa, že server beží |
| "Autentifikácia zlyhala" (401) | Overte svoj API kľúč alebo token v konfigurácii hlavičiek |
| "Zakázané" (403) | Skontrolujte, či vaše poverenia majú požadované oprávnenia |
| "Server nenájdený" (404) | Overte URL. AI SmartTalk automaticky pridáva /mcp |
| "Časový limit" | Skontrolujte sieťové pripojenie a pravidlá firewallu. Test má časový limit 10 sekúnd |
| "SSL chyba" | Uistite sa, že váš MCP server má platný SSL certifikát |
| "Obmedzená rýchlosť" (429) | Príliš veľa požiadaviek. Počkajte a skúste znova, alebo zvýšte limity servera |
Problémy s Nástrojmi
| Problém | Riešenie |
|---|---|
| Nástroje sa nezobrazujú | Overte, či MCP server správne vystavuje nástroje. Skúste obnoviť stránku |
| Nesprávne volané nástroje | Skontrolujte, či sú názvy serverov popisné, aby AI mohlo správne vybrať |
| Volanie nástroja zlyhá | Skontrolujte protokoly servera na chyby. Uistite sa, že nástroj vracia očakávaný formát |
Bežné Chyby
- Zabudnutie na
/mcp: AI SmartTalk to pridáva automaticky, ale ak je váš koncový bod iný, zahrňte celú cestu - Nesprávny formát hlavičky: Uistite sa, že autentifikačné hlavičky zodpovedajú tomu, čo váš server očakáva
- Duplicitné názvy serverov: Každý server musí mať jedinečný názov
Správa MCP Serverov
| Akcia | Ako |
|---|---|
| Pridať server | Kliknite na "Pridať server", vyplňte podrobnosti, otestujte a uložte |
| Upraviť server | Kliknite na ikonu úpravy na karte servera |
| Otestovať pripojenie | Kliknite na ikonu testu na karte servera |
| Zmazať server | Kliknite na ikonu zmazania na karte servera |
| Uložiť zmeny | Kliknite na "Uložiť integráciu", aby ste zachovali všetky zmeny |
Najlepšie Praktiky
- Používajte popisné názvy serverov: Pomáha AI pochopiť, ktorý server dotazovať (napr. "CRM spoločnosti" namiesto "Server 1")
- Testujte pred uložením: Vždy testujte pripojenia, aby ste odhalili problémy s konfiguráciou včas
- Začnite s jedným serverom: Získajte istotu s jednou integráciou pred pridaním ďalších
- Zabezpečte svoje poverenia: Používajte špeciálne API kľúče pre AI SmartTalk, nie osobné tokeny
- Monitorujte svoje servery: Sledujte, ktoré nástroje sú volané a ich výkon
- Udržujte servery aktuálne: Uistite sa, že vaše MCP servery dodržiavajú najnovšiu špecifikáciu protokolu