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 AI asistentům interagovat s externími systémy prostřednictvím jednotného rozhraní.
Přehled
Integrace MCP Serveru vám umožňuje:
- Připojit jakýkoli server kompatibilní s MCP
- Exponovat nástroje pro vaši AI, které může používat během konverzací
- Přistupovat k externím datům prostřednictvím standardizovaných protokolů
- Rozšířit možnosti bez potřeby vlastního 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 zdrojům dat a nástrojům.
Požadavky
Než začnete, ujistěte se, že máte:
- Aktivní účet AI SmartTalk
- Přístup k MCP serveru (self-hosted nebo třetí strany)
- URL MCP serveru a autentizační údaje
- Pochopení, které nástroje MCP server exponuje
Jak MCP funguje
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Dotaz uživatele│────▶│ AI SmartTalk │────▶│ MCP Server │
│ │ │ (AI Agent) │ │ │
│ "Zkontroluj můj CRM" │ │ │ │ - CRM nástroje │
│ │◀────│ Zpracovává dotaz│◀────│ - DB dotazy │
│ Odpověď │ │ Volá MCP nástroje│ │ - Přístup k souborům │
└─────────────────┘ └─────────────────┘ └─────────────────┘
- Uživatel se ptá na otázku, která vyžaduje externí data
- AI SmartTalk rozpozná, že potřebuje MCP nástroj
- MCP server je zavolán s příslušným nástrojem
- Odpověď je vrácena a AI formuluje odpověď
Krok za krokem nastavení
Krok 1: Přístup k integraci MCP
- Přihlaste se do svého účtu AI SmartTalk
- Přejděte na Nastavení → Integrace
- Najděte MCP servery a klikněte na Přidat server
Krok 2: Konfigurace MCP serveru
Zadejte podrobnosti o svém MCP serveru:
| Pole | Popis |
|---|---|
| Název serveru | Přátelské jméno pro toto připojení |
| URL serveru | Endpoint MCP serveru (např. https://mcp.example.com) |
| Transport | SSE (Server-Sent Events) nebo WebSocket |
| Autentizace | API klíč, OAuth nebo žádná |
Krok 3: Otestujte připojení
- Klikněte na Otestovat připojení
- AI SmartTalk provede ping na MCP server
- Ověřte, že stav ukazuje Připojeno
Krok 4: Objevte dostupné nástroje
Jakmile jste připojeni, AI SmartTalk načte seznam dostupných nástrojů:
| Nástroj | Popis | Parametry |
|---|---|---|
search_crm | Hledání zákaznických záznamů | dotaz, limit |
create_ticket | Vytvoření podpůrného tiketu | název, popis |
get_weather | Načtení údajů o počasí | lokalita |
Krok 5: Aktivujte nástroje pro svou AI
- Zkontrolujte objevené nástroje
- Aktivujte nástroje, které chcete, aby vaše AI používala
- Konfigurujte jakékoli specifické nastavení nástroje
- Uložte svou konfiguraci
Integrace SmartFlow
Nástroje MCP lze také použít v pracovních postupech SmartFlow:
Použití nástrojů MCP v tocích
- V SmartFlow najděte MCP v knihovně akcí
- Přetáhněte akci MCP do svého toku
- Vyberte MCP server a nástroj
- Mapujte vstupní parametry z kontextu vašeho toku
- Použijte odpověď nástroje v následujících akcích
Příklad: Tok pro vyhledávání zákazníka
Trigger: Chat Service (když se uživatel ptá na účet)
Actions:
1. Zavolání nástroje MCP:
Server: Company CRM
Tool: search_crm
Parameters:
query: {{user_email}}
2. Odpověď AI:
Context: Výsledek vyhledávání CRM
Prompt: Odpovězte na otázku uživatele ohledně účtu
Případové studie
Správa vztahů se zákazníky
Připojte svůj CRM přes MCP:
- "Vyhledejte 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:
- "Zkontrolujte zásoby pro produkt SKU-123"
- "Co je na programu na zítra?"
- "Hledejte v našem interním wiki dokumenty pro onboarding"
Externí datové zdroje
Načtěte živá data:
- "Jaké je aktuální počasí v Paříži?"
- "Získejte nejnovější cenu akcií pro AAPL"
- "Zkontrolujte stav letu UA123"
Vývojové nástroje
Pro technické týmy:
- "Jaký je stav poslední verze?"
- "Hledejte naše GitHub problémy na chyby autentizace"
- "Zkontrolujte stav produkčních serverů"
Příklady MCP serverů
Oblíbené 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 |
Zjistěte více: Navštivte MCP Server Registry pro komunitní servery.
Samo-hostované MCP servery
Můžete vytvořit vlastní MCP servery pro:
- Proprietární interní systémy
- Vlastní obchodní logiku
- Bezpečný/pouze soukromý přístup k datům
Bezpečnostní úvahy
Autentizace
| Metoda | Případ použití |
|---|---|
| API Key | Jednoduchá autentizace serveru na server |
| OAuth 2.0 | Přístup delegovaný uživateli |
| mTLS | Vysoké bezpečnostní prostředí |
Ochrana soukromí dat
- Žádosti MCP mohou obsahovat uživatelská data
- Zajistěte, aby váš MCP server správně zpracovával data
- Zvažte požadavky na umístění dat
- Logujte a auditujte volání nástrojů MCP
Síťová bezpečnost
- Používejte HTTPS pro všechny MCP připojení
- Omezte přístup k MCP serveru na IP adresy AI SmartTalk
- Implementujte omezení rychlosti na vašem MCP serveru
Řešení problémů
Problémy s připojením
| Problém | Řešení |
|---|---|
| "Connection refused" | Zkontrolujte URL serveru a port |
| "Authentication failed" | Ověřte přihlašovací údaje/API klíč |
| "Timeout" | Zkontrolujte síťové připojení, pravidla firewallu |
| "SSL error" | Zajistěte platný SSL certifikát |
Problémy s objevováním nástrojů
| Problém | Řešení |
|---|---|
| "No tools found" | Ověřte, že MCP server správně vystavuje nástroje |
| "Tool not available" | Zkontrolujte, zda je nástroj povolen na straně serveru |
| "Schema mismatch" | Aktualizujte AI SmartTalk pro obnovení schémat nástrojů |
Problémy za běhu
| Problém | Řešení |
|---|---|
| "Tool call failed" | Zkontrolujte protokoly serveru na chyby |
| "Unexpected response" | Ověřte, že nástroj vrací očekávaný formát |
| "Rate limited" | Implementujte zpětné odložení nebo zvyšte limity |
Správa MCP serverů
| Akce | Jak |
|---|---|
| Přidat server | Nastavení → Integrace → MCP → Přidat server |
| Upravit server | Klikněte na název serveru pro úpravu |
| Deaktivovat server | Přepněte na vypnuto bez smazání |
| Odstranit server | Tlačítko Smazat (nástroje se stanou nedostupnými) |
| Obnovit nástroje | Klikněte na Obnovit pro znovuobjevení nástrojů |
Nejlepší praktiky
- Začněte jednoduše: Připojte jeden server, důkladně otestujte a poté rozšiřte
- Dokumentujte nástroje: Udržujte interní dokumentaci o tom, co každý nástroj dělá
- Sledujte používání: Sledujte, které nástroje jsou volány a jejich výkon
- Zpracovávejte chyby elegantně: AI by měla elegantně zpracovávat selhání nástrojů
- Zabezpečte přihlašovací údaje: Používejte proměnné prostředí, ne hardcoded klíče
- Verzujte své servery: MCP servery by měly být verzovány pro stabilitu