MCP Servery
Připojte externí nástroje a služby k AI SmartTalk pomocí Model Context Protocol (MCP). MCP je otevřený standard, který umožňuje vašemu AI asistentovi interagovat s externími systémy prostřednictvím jednotného rozhraní.
Přehled
Integrace MCP Serveru vám umožňuje:
- Připojit více MCP serverů současně
- Exponovat externí nástroje pro vaše AI, aby je mohlo volat během konverzací
- Autentizovat pomocí vlastních HTTP hlaviček (API klíče, tokeny atd.)
- Testovat připojení před spuštěním do produkce
- Rozšířit funkce bez vlastní vývoje
Co je MCP? Model Context Protocol je otevřený standard (vyvinutý společností Anthropic), který umožňuje AI systémům bezpečně se připojit k externím datovým zdrojům a nástrojům. Další informace naleznete na modelcontextprotocol.io.
Požadavky
Než začnete, ujistěte se, že máte:
- Aktivní účet AI SmartTalk
- Přístup k jednomu nebo více serverům kompatibilním s MCP
- URL serveru pro každý MCP server
- Jakékoli potřebné autentizační údaje (API klíče, tokeny)
Jak MCP funguje
- Uživatel se ptá na otázku, která vyžaduje externí data
- AI SmartTalk rozpozná, že potřebuje MCP nástroj
- Je zavolán příslušný MCP server se správným nástrojem
- Odpověď je vrácena a AI formuluje odpověď v přirozeném jazyce
AI SmartTalk podporuje více MCP serverů najednou. Nástroje z různých serverů jsou automaticky jmenně prostorově odděleny, aby se předešlo konfliktům.
Nastavení krok za krokem
Krok 1: Přístup k integraci MCP
- Přihlaste se do svého účtu AI SmartTalk
- Přejděte na Administrace → Moji asistenti → [Název vašeho asistenta]
- Klikněte na Konektory v levém postranním panelu
- Najděte MCP Servery a klikněte na něj
Krok 2: Přidat MCP server
Klikněte na Přidat server, abyste otevřeli formulář pro konfiguraci serveru. Vyplňte následující pole:
| Pole | Povinné | Popis |
|---|---|---|
| Název serveru | Ano | Přátelský název pro identifikaci tohoto serveru (např. "CRM společnosti", "Interní wiki") |
| URL serveru | Ano | URL koncového bodu MCP serveru (např. https://mcp.example.com) |
| HTTP hlavičky | Ne | Vlastní hlavičky pro autentizaci nebo jiné požadavky |
AI SmartTalk automaticky přidává /mcp k vaší URL, pokud již nekončí tímto způsobem. Například https://example.com se stane https://example.com/mcp. Pokud váš server používá jinou cestu koncového bodu, zahrňte ji do URL (např. https://example.com/api/mcp).
Krok 3: Přidat autentizační hlavičky (volitelné)
Pokud váš MCP server vyžaduje autentizaci, klikněte na Přidat hlavičky, abyste nakonfigurovali vlastní HTTP hlavičky:
| Běžná hlavička | Případ použití |
|---|---|
Authorization | Bearer tokeny (např. Bearer sk-xxx...) |
X-API-Key | Autentizace pomocí API klíče |
X-Auth-Token | Autentizace pomocí vlastního tokenu |
Pro každou hlavičku zadejte:
- Klíč: Název hlavičky (vyberte z běžných hlaviček nebo zadejte vlastní)
- Hodnota: Hodnota hlavičky (citlivé hodnoty jsou automaticky skryty v uživatelském rozhraní)
Můžete přidat více hlaviček na server. Hlavičky obsahující "secret", "password", "token" nebo "auth" v názvu klíče jsou automaticky skryty pro bezpečnost.
Krok 4: Otestovat připojení
Před uložením klikněte na Otestovat připojení, abyste ověřili, že váš server je dostupný:
- AI SmartTalk odešle JSON-RPC inicializační požadavek na váš server
- Test kontroluje více koncových bodů v tomto pořadí:
/mcp,/health, poté základní URL - Výsledky ukazují stav připojení, čas odezvy a informace o serveru
| Výsledek testu | Význam |
|---|---|
| Připojeno | Server úspěšně odpověděl s protokolem MCP |
| Autentizace selhala | Zkontrolujte svůj API klíč nebo token v hlavičkách |
| Server nenalezen | Ověřte, že je URL správná |
| Připojení odmítnuto | Server může být mimo provoz nebo firewall blokuje přístup |
| Časový limit | Server trval příliš dlouho na odpověď (limit 10s) |
| SSL chyba | Zkontrolujte, že server má platný SSL certifikát |
Krok 5: Uložit konfiguraci
- Klikněte na Přidat, abyste přidali server do svého seznamu
- Opakujte kroky 2-4 pro přidání dalších MCP serverů, pokud je to potřeba
- Klikněte na Uložit integraci, abyste aktivovali všechny nakonfigurované servery
Podpora více serverů
AI SmartTalk podporuje připojení více MCP serverů současně. To vám umožňuje kombinovat nástroje z různých zdrojů:
Jmenné prostorování nástrojů
Nástroje z každého serveru jsou automaticky předponovány názvem serveru, aby se předešlo konfliktům názvů. Například:
company_crm__search_customersinternal_wiki__search_docsweather_api__get_forecast
To znamená, že můžete bezpečně připojit servery, které exponují nástroje se stejným názvem.
Správa více serverů
Informační panel integrace zobrazuje všechny nakonfigurované servery s:
- Název serveru a URL pro snadnou identifikaci
- Odznak počtu hlaviček, pokud jsou nakonfigurovány vlastní hlavičky
- Indikátor stavu (Nakonfigurováno / Neúplné)
- Akční tlačítka: Otestovat připojení, Upravit nebo Smazat jednotlivé servery
Objevování nástrojů
Jakmile jsou vaše MCP servery připojeny, AI SmartTalk automaticky objevuje všechny dostupné nástroje exponované každým serverem. Tyto nástroje se okamžitě stávají dostupnými pro vašeho AI asistenta.
AI asistent:
- Uvidí seznam všech dostupných nástrojů ze všech připojených serverů
- Automaticky vybere správný nástroj na základě dotazů uživatele
- Zavolá nástroj s odpovídajícími parametry
- Zpracuje odpověď a poskytne odpověď v přirozeném jazyce
Nemusíte ručně konfigurovat nebo aktivovat jednotlivé nástroje. Všechny nástroje exponované připojeným MCP serverem jsou automaticky dostupné pro vašeho AI asistenta.
Případové studie
Správa vztahů se zákazníky
Připojte svůj CRM přes MCP:
- "Najdi zákazníka Johna Smitha"
- "Jaký je stav účtu #12345?"
- "Kolik máme otevřených podpůrných tiketů?"
Interní nástroje
Přístup k firemním systémům:
- "Zkontroluj zásoby pro produkt SKU-123"
- "Co je na programu na zítra?"
- "Hledej v naší interní wiki dokumenty pro onboardování"
Externí datové zdroje
Získejte živá data:
- "Jaké je aktuální počasí v Paříži?"
- "Získejte nejnovější cenu akcií pro AAPL"
- "Zkontrolujte stav letu pro UA123"
Vývojové nástroje
Pro technické týmy:
- "Jaký je stav posledního buildu?"
- "Hledej naše GitHub problémy pro chyby autentizace"
- "Zkontroluj zdraví produkčních serverů"
Příklady MCP Serverů
Populární MCP Servery
| Server | Účel | Odkaz |
|---|---|---|
| Filesystem | Čtení/zápis místních souborů | Vestavěný referenční server |
| PostgreSQL | Dotazování na databáze | Komunitní server |
| GitHub | Správa repozitářů | Komunitní server |
| Slack | Integrace zpráv | Komunitní server |
| Google Drive | Správa souborů | Komunitní server |
| Brave Search | Webové vyhledávání | Komunitní server |
Zjistěte více: Navštivte MCP Server Registry pro rostoucí seznam komunitních MCP serverů.
Samo-hostované MCP Servery
Můžete vytvořit vlastní MCP servery pro:
- Proprietární interní systémy
- Vlastní obchodní logiku
- Bezpečný nebo soukromý přístup k datům
Použijte jakýkoli MCP SDK (TypeScript, Python) k vytvoření vlastního serveru.
Bezpečnostní Úvahy
Autentizace
Nakonfigurujte autentizaci prostřednictvím HTTP Hlaviček v konfiguraci serveru:
| Metoda | Příklad Hlavičky |
|---|---|
| Bearer Token | Authorization: Bearer sk-xxx... |
| API Klíč | X-API-Key: your-api-key |
| Vlastní Token | X-Auth-Token: your-token |
Ochrana Dat
- MCP požadavky mohou obsahovat data o uživatelských konverzacích
- Zajistěte, aby váš MCP server zpracovával data v souladu s vašimi politikami ochrany soukromí
- Zvažte požadavky na umístění dat
- AI SmartTalk maskuje citlivé hodnoty hlaviček v uživatelském rozhraní
Síťová Bezpečnost
- Používejte HTTPS pro všechny MCP připojení
- Omezte přístup k MCP serveru na důvěryhodné IP adresy
- Implementujte omezení rychlosti na vašem MCP serveru
- Zajistěte platné SSL certifikáty
Řešení Problémů
Problémy s Připojením
| Problém | Řešení |
|---|---|
| "Připojení odmítnuto" | Zkontrolujte URL serveru a port. Ujistěte se, že server běží |
| "Autentizace selhala" (401) | Ověřte svůj API klíč nebo token v konfiguraci hlaviček |
| "Zakázáno" (403) | Zkontrolujte, že vaše přihlašovací údaje mají požadovaná oprávnění |
| "Server nenalezen" (404) | Ověřte URL. AI SmartTalk automaticky přidává /mcp |
| "Časový limit" | Zkontrolujte síťové připojení a pravidla firewallu. Test má časový limit 10 sekund |
| "SSL chyba" | Ujistěte se, že váš MCP server má platný SSL certifikát |
| "Omezená rychlost" (429) | Příliš mnoho požadavků. Počkejte a zkuste to znovu, nebo zvyšte limity serveru |
Problémy s Nástroji
| Problém | Řešení |
|---|---|
| Nástroje se nezobrazují | Ověřte, že MCP server správně vystavuje nástroje. Zkuste obnovit |
| Chybné nástroje volány | Zkontrolujte, že názvy serverů jsou popisné, aby AI mohla správně vybírat |
| Volání nástroje selhalo | Zkontrolujte protokoly serveru na chyby. Ujistěte se, že nástroj vrací očekávaný formát |
Běžné Chyby
- Zapomenutí na
/mcp: AI SmartTalk to přidává automaticky, ale pokud je váš koncový bod jiný, zahrňte celou cestu - Špatný formát hlavičky: Ujistěte se, že autentizační hlavičky odpovídají tomu, co váš server očekává
- Duplicitní názvy serverů: Každý server musí mít unikátní název
Správa MCP Serverů
| Akce | Jak |
|---|---|
| Přidat server | Klikněte na "Přidat server", vyplňte detaily, otestujte a uložte |
| Upravit server | Klikněte na ikonu úpravy na kartě serveru |
| Otestovat připojení | Klikněte na ikonu testu na kartě serveru |
| Smazat server | Klikněte na ikonu smazání na kartě serveru |
| Uložit změny | Klikněte na "Uložit integraci", aby se všechny změny uložily |
Nejlepší Praktiky
- Používejte popisné názvy serverů: Pomáhá AI pochopit, který server dotazovat (např. "CRM společnosti" místo "Server 1")
- Testujte před uložením: Vždy testujte připojení, abyste včas odhalili problémy s konfigurací
- Začněte s jedním serverem: Získejte jistotu s jednou integrací před přidáním dalších
- Zabezpečte své přihlašovací údaje: Používejte specializované API klíče pro AI SmartTalk, nikoli osobní tokeny
- Sledujte své servery: Sledujte, které nástroje jsou volány a jejich výkon
- Udržujte servery aktualizované: Zajistěte, aby vaše MCP servery dodržovaly nejnovější specifikaci protokolu