Jak připojit svého bota přes MCP

MCP (Model Context Protocol) je otevřený protokol, který propojuje AI nástroje s externími zdroji dat. Jakmile na svém botovi ChatbotIQ zapnete MCP, mohou vaši znalostní bázi prohledávat přímo programovací asistenti i další nástroje s podporou MCP.

Ocení to hlavně vývojové týmy: programovací asistent si vyhledá interní dokumentaci, aniž byste museli opustit IDE.

---

Předpoklady

• Bot ChatbotIQ s alespoň jedním indexovaným znalostním zdrojem.
• Placený tarif (Personal, Standard nebo Business). MCP není dostupné v tarifu Free.

---

Krok 1: Povolení MCP na vašem botovi

1. Otevřete Playground svého bota.
2. Otevřete záložku Nasazení a zvolte dlaždici AI asistenti.
3. Zvolte, jak MCP povolit:
   • S API klíčem: vygeneruje tajný klíč pro ověřený přístup. Doporučujeme pro soukromé znalostní báze.
   • Veřejné (bez auth): bez ověřování. Hodí se, když chcete, aby se znalostní báze bota mohl dotazovat kdokoli, kdo má URL.
4. Pokud jste zvolili režim API Key, hned si klíč zkopírujte. Zobrazí se jen jednou.
5. Poznamenejte si MCP endpoint URL uvedenou na stránce. Vypadá takto:

   https://app.chatbotiq.eu/v1/mcp/bots/<bot-id>/mcp

---

Krok 2: Připojení z vašeho AI nástroje

Postupujte podle pokynů pro svého klienta níže. Vždy budete potřebovat:

• MCP endpoint URL ze záložky MCP v Playgroundu
• API klíč (pokud jste povolili autentizovaný režim)

Playground v sekci Konfigurace klienta ukazuje konfigurační úryvky pro každého klienta, připravené ke zkopírování.

---

Claude (claude.ai a Claude Desktop)

Claude podporuje vzdálené MCP servery prostřednictvím Custom Connectors. Konektory nakonfigurované na claude.ai se automaticky synchronizují do aplikace Claude Desktop.

Důležité: Custom Connectors podporují pouze ověřování authless (public) a OAuth, ověřování přes Bearer token / API klíč nikoli. Při zapínání MCP na botovi ChatbotIQ pro Claude proto použijte Public mode. Když potřebujete ověřování přes API klíč, použijte raději Claude Code (viz níže).

Pro tarify Pro / Max

1. Otevřete claude.ai nebo Claude Desktop.
2. Přejděte na Customize (v levém postranním panelu) > Connectors.
3. Klikněte na +, poté na Add custom connector.
4. Zadejte MCP endpoint URL z Playgroundu ChatbotIQ (např. https://app.chatbotiq.eu/v1/mcp/bots/<bot-id>/mcp).
5. Klikněte na Add.

Pro tarify Team / Enterprise

Nastavení administrátorem:

1. Přejděte na Organization settings > Connectors.
2. Klikněte na Add, najeďte na Custom, vyberte Web.
3. Zadejte MCP endpoint URL.
4. Klikněte na Add.

Členové se poté připojují individuálně:

1. Přejděte na Customize > Connectors.
2. Najděte konektor označený Custom.
3. Klikněte na Connect.

Použití konektoru

Po nastavení aktivujte konektor zvlášť v každé konverzaci: klikněte na tlačítko + v poli pro psaní zprávy, vyberte Connectors a zapněte svůj konektor ChatbotIQ. Claude pak může prohledávat vaši znalostní bázi přímo.

---

Claude Code (CLI)

Claude Code podporuje MCP servery prostřednictvím příkazu claude mcp add.

S API klíčem:

claude mcp add --transport http chatbotiq-my-docs \
  https://app.chatbotiq.eu/v1/mcp/bots/<bot-id>/mcp \
  --header "Authorization: Bearer mcpk_your_api_key_here"

Public mode (bez autentizace):

claude mcp add --transport http chatbotiq-my-docs \
  https://app.chatbotiq.eu/v1/mcp/bots/<bot-id>/mcp

Možnosti rozsahu:

• --scope local (výchozí): dostupné pouze v aktuálním projektu, uloženo soukromě v ~/.claude.json.
• --scope project: sdíleno s vaším týmem prostřednictvím .mcp.json v kořeni projektu (commitnuto do gitu).
• --scope user: dostupné napříč všemi vašimi projekty.

Ověření připojení:

claude mcp list        # list configured servers
/mcp                   # check status inside a Claude Code session

Sdílená konfigurace týmu (.mcp.json v kořeni projektu):

{
  "mcpServers": {
    "chatbotiq-my-docs": {
      "type": "http",
      "url": "https://app.chatbotiq.eu/v1/mcp/bots/<bot-id>/mcp",
      "headers": {
        "Authorization": "Bearer ${CHATBOTIQ_MCP_KEY}"
      }
    }
  }
}

Členové týmu nastaví proměnnou prostředí CHATBOTIQ_MCP_KEY lokálně. Claude Code podporuje syntaxi ${VAR} a ${VAR:-default} v hodnotách konfigurace.

---

GitHub Copilot (VS Code)

GitHub Copilot podporuje MCP servery prostřednictvím souboru .vscode/mcp.json ve vašem projektu nebo konfigurace na úrovni uživatele.

Možnost A: Command Palette

1. Otevřete Command Palette (Ctrl+Shift+P / Cmd+Shift+P).
2. Spusťte MCP: Add Server.
3. Vyberte HTTP jako typ serveru.
4. Zadejte název (např. chatbotiq-my-docs) a MCP endpoint URL.
5. VS Code za vás vytvoří nebo aktualizuje .vscode/mcp.json.

Možnost B: Úprava konfiguračního souboru

Vytvořte nebo upravte .vscode/mcp.json v kořeni svého projektu:

S API klíčem (s použitím vstupních proměnných pro tajné údaje):

{
  "inputs": [
    {
      "type": "promptString",
      "id": "chatbotiq-key",
      "description": "ChatbotIQ MCP API Key",
      "password": true
    }
  ],
  "servers": {
    "chatbotiq-my-docs": {
      "type": "http",
      "url": "https://app.chatbotiq.eu/v1/mcp/bots/<bot-id>/mcp",
      "headers": {
        "Authorization": "Bearer ${input:chatbotiq-key}"
      }
    }
  }
}

VS Code vás při prvním připojení vyzve k zadání API klíče. Hodnota je uložena bezpečně a není commitnuta do gitu.

Public mode (bez autentizace):

{
  "servers": {
    "chatbotiq-my-docs": {
      "type": "http",
      "url": "https://app.chatbotiq.eu/v1/mcp/bots/<bot-id>/mcp"
    }
  }
}

Poznámka: VS Code nejprve zkouší transport HTTP Streamable a v případě potřeby přejde na SSE. API klíče nevkládejte natvrdo, použijte raději proměnné ${input:...}. U nového MCP serveru budete při prvním použití vyzváni, abyste mu udělili důvěru.

---

Cursor

Cursor podporuje MCP prostřednictvím konfiguračního souboru JSON nebo uživatelského rozhraní Settings.

Možnost A: Uživatelské rozhraní Settings

1. Otevřete Settings: Cmd+, (macOS) / Ctrl+, (Windows/Linux).
2. Přejděte na Tools & MCP.
3. Klikněte na Add new MCP server.
4. Nastavte:
   • Type: streamableHttp
   • Name: chatbotiq-my-docs
   • URL: vaše MCP endpoint URL
5. Plně restartujte Cursor (nejen znovu načtěte okno).

Možnost B: Konfigurační soubor

Vytvořte nebo upravte .cursor/mcp.json v kořeni svého projektu (na úrovni projektu) nebo ~/.cursor/mcp.json (globálně):

S API klíčem:

{
  "mcpServers": {
    "chatbotiq-my-docs": {
      "type": "streamableHttp",
      "url": "https://app.chatbotiq.eu/v1/mcp/bots/<bot-id>/mcp",
      "headers": {
        "Authorization": "Bearer mcpk_your_api_key_here"
      }
    }
  }
}

Public mode (bez autentizace):

{
  "mcpServers": {
    "chatbotiq-my-docs": {
      "url": "https://app.chatbotiq.eu/v1/mcp/bots/<bot-id>/mcp"
    }
  }
}

Po uložení plně restartujte Cursor. Vyžaduje Cursor v0.40 nebo novější.

---

Windsurf

Windsurf podporuje MCP prostřednictvím svého tržiště pluginů nebo ruční konfigurace.

Možnost A: Uživatelské rozhraní pluginů

1. Otevřete Windsurf a klikněte na ikonu Plugins v postranním panelu.
2. Klikněte na Manage plugins > View raw config.
3. Přidejte svůj server ChatbotIQ (viz formát JSON níže).
4. Uložte a obnovte.

Možnost B: Úprava konfiguračního souboru

Upravte ~/.codeium/windsurf/mcp_config.json:

S API klíčem:

{
  "mcpServers": {
    "chatbotiq-my-docs": {
      "serverUrl": "https://app.chatbotiq.eu/v1/mcp/bots/<bot-id>/mcp",
      "headers": {
        "Authorization": "Bearer mcpk_your_api_key_here"
      }
    }
  }
}

Public mode (bez autentizace):

{
  "mcpServers": {
    "chatbotiq-my-docs": {
      "serverUrl": "https://app.chatbotiq.eu/v1/mcp/bots/<bot-id>/mcp"
    }
  }
}

Poznámka: Windsurf používá pro vzdálené MCP servery serverUrl (nikoli url).

---

ChatGPT

ChatGPT podporuje vzdálené MCP servery v tarifech Plus, Team, Enterprise a Education. Podporovány jsou pouze vzdálené servery (žádné lokální/stdio).

1. Otevřete ChatGPT Settings.
2. Přejděte na Apps (nebo Connectors) > Advanced settings.
3. Zapněte Developer Mode.
4. Klikněte na Create pro přidání nového konektoru.
5. Vyplňte:
   • Name: výstižný název (např. ChatbotIQ Docs)
   • MCP Server URL: vaše MCP endpoint URL
   • Authentication: zvolte API Key a zadejte Bearer mcpk_your_api_key_here (nebo None pro public mode)
6. Klikněte na Create pro uložení.
7. V nové konverzaci klikněte na nabídku +, vyberte Developer mode a poté povolte svůj konektor ChatbotIQ.

ChatGPT před každým voláním nástroje zobrazí potvrzovací dialog.

---

Dostupné MCP nástroje

Po připojení má váš AI nástroj k dispozici tyto nástroje:

Nástroj	Popis
search_knowledge_base	Hybridní vyhledávání (sémantické + klíčová slova, následně přeřazené) napříč znalostní bází vašeho bota. Vrací relevantní pasáže se zdrojovými URL a skóre relevance. Volitelně top_k (výchozí 8, max 20) a source_id.
list_sources	Vypíše všechny znalostní zdroje připojené k botovi, včetně typu zdroje, základní URL a počtu stránek.
get_page_content	Načte úplný markdown obsah konkrétní stránky podle její URL.
list_pages	Vypíše stránky ve znalostní bázi se stránkováním. Volitelné filtry source_id, url_prefix a title_contains.

Parametr source_id přijímá buď název zdroje tak, jak jej vypisuje list_sources (nezáleží na velikosti písmen, např. Product Docs), nebo jeho ID. Asistent tak může omezit vyhledávání bez předchozího dohledávání ID. Pokud název odpovídá více zdrojům, prohledají se všechny.

Vyhledávání používá stejnou retrieval pipeline jako chatovací widget, takže výsledky přes MCP odpovídají tomu, co by našel samotný bot.

Parametr query je omezen na 4000 znaků. Předávejte cílenou otázku, nikoli celý dokument; pro načtení celé stránky použijte get_page_content.

---

Zobrazení MCP nástrojů v chatovacím widgetu (volitelné)

Chcete-li návštěvníkům ukázat dostupné MCP nástroje přímo ve vloženém chatovacím widgetu:

1. Zapněte MCP v režimu Public mode (přepínač u widgetu vyžaduje public mode).
2. V záložce MCP přepněte Zobrazit ve widgetu na ON.

V rozhraní widgetu se tak zobrazí dostupné nástroje a uživatelé hned vidí, k jakým datům má bot přístup.

---

Použití vlastní MCP domény

Ve výchozím stavu používá MCP endpoint URL doménu app.chatbotiq.eu. V placených tarifech ji můžete nasměrovat na vlastní doménu (např. ai.yourcompany.com), takže MCP klienti uvidí URL s vaší značkou.

Nastavení

1. Přejděte na Nastavení → Vlastní MCP doména.
2. Zadejte svou vlastní doménu (např. ai.yourcompany.com).
3. U svého poskytovatele DNS vytvořte CNAME záznam směřující vaši doménu na cíl uvedený v nastavení (např. mcp.chatbotiq.eu).
4. Kliknutím na Ověřit a uložit zkontrolujte propagaci DNS. Stav prochází těmito fázemi:
   • Čeká na DNS: čeká se na propagaci vašeho CNAME záznamu.
   • Čeká na SSL: DNS ověřeno, SSL certifikát je automaticky vystavován.
   • Aktivní: vše funguje. Vaše MCP URL nyní používají vaši vlastní doménu.
5. Jakmile je doména aktivní, všechny MCP endpoint URL vašich botů se automaticky přepnou na https://ai.yourcompany.com/v1/mcp/bots/<bot-id>/mcp.

Poznámka: Propagace DNS může trvat až 48 hodin, obvykle ale proběhne během několika minut. Na Znovu ověřit DNS můžete klikat opakovaně.

Vlastní doménu odeberete tak, že na stejné stránce nastavení vymažete pole s doménou.

---

Řešení problémů

• Connection refused / timeout: Ověřte, že je endpoint URL správná a že má bot zapnuté MCP.
• 401 Unauthorized: Zkontrolujte, že je API klíč správný a v hlavičce Authorization má prefix Bearer .
• 403 Forbidden: MCP zřejmě není na tomto botovi zapnuté nebo je bot neaktivní.
• Nástroje se nezobrazují: Po přidání konfigurace klienta plně restartujte. Někteří klienti (Claude Desktop, Cursor) vyžadují plný restart, ne jen znovunačtení okna.
• Omezení rychlosti (rate limited): MCP endpointy mají omezení rychlosti pro každého bota zvlášť. Chvíli počkejte a zkuste to znovu.
• Vlastní doména nefunguje: Ověřte, že se DNS propagoval (nslookup ai.yourcompany.com se musí přeložit). Než se URL přepnou, musí být stav domény “Aktivní”.

---

Související

• Referenční příručka nastavení bota: nastavení MCP
• Vytvoření znalostního bota pro Confluence: tutoriál využívající MCP
• Uzavření smyčky zpětné vazby dokumentace: Insights MCP server pro členy workspace