Dokumentace serveru MCP

Co to je?

Poznámka správce: Tato funkce je most mezi vašimi firemními daty a moderními asistenty AI, jako jsou ChatGPT, Claude nebo LeChat. Umožňuje vám “mluvit” s daty vašeho e-shopu pomocí přirozeného jazyka a získat okamžité odpovědi a analýzy.

Pro koho je to určeno? Administrátoři by si to měli přečíst, aby pochopili, jak mohou používat AI k prozkoumávání vlastních dat. Můžete si to sami nastavit v nastavení vaší oblíbené aplikace AI vložením poskytnuté adresy URL — bez kódování, bez API klíče, bez nutnosti vývojáře pro základní použití, i když váš vývojář vám může pomoci s pokročilejšími konfiguracemi.

Klíčové výhody pro e-shop:

Okamžité odpovědi na data: Zeptejte se své AI “Jakých bylo mých 5 nejprodávanějších produktů minulý týden?” nebo “Zobraz mi všechny objednávky z New Yorku” a získejte okamžitou odpověď.
Analýza přirozeného jazyka: Není třeba se učit složité dotazovací jazyky – stačí mluvit se svými daty, jako byste mluvili s lidským asistentem.
Přehledy poháněné umělou inteligencí: Nechte AI analyzovat vaše prodejní trendy, identifikovat položky s nízkými zásobami nebo shrnout chování zákazníků za vás.
Moderní pracovní postup: Přeneste data svého e-shopu přímo do nástrojů AI, které již používáte každý den pro plánování a strategii.

Přehled

Server Model Context Protocol (MCP) poskytuje standardizovaný přístup k vašim datům pro aplikace AI. Umožňuje AI asistentům, jako jsou LeChat, ChatGPT, Claude a další, dotazovat se přímo na vaše data pomocí přirozeného jazyka.

Protokol: JSON-RPC 2.0 | Protokol MCP 2025-06-18 | HTTP Transport | Dotazy v reálném čase

Rychlé nastavení

Pro AI asistenty, které podporují konektory MCP (ChatGPT, Claude, …), je to skutečně jeden krok: vložte níže uvedenou URL serveru do nastavení konektoru asistenta. Sám si najde cestu k přihlášení a požádá vás o schválení přístupu — bez API klíče, bez kopírování ID klientů, nic není potřeba předem nastavovat.

Koncový bod serveru

URL serveru: {HOSTNAME}/api/mcp/{companyId}/mcp

Informace o serveru: {HOSTNAME}/api/mcp/{companyId}/info

Stránka Nastavení s touto URL a instrukcemi pro kopírování a vkládání je také přímo dostupná na [navigate:/settings/mcp|Nastavení → MCP Server|plug].

Možnosti ověřování

Přihlášení a schválení [badge:Doporučeno|success|right]

Výchozí nastavení, které používají níže uvedené průvodce nastavením. Asistent sám zjistí, jak se připojit, jakmile mu poskytnete URL serveru, a poté otevře běžnou obrazovku pro přihlášení + “Schválit přístup?” — stejný typ výzvy, jaký byste viděli při připojování jakékoli jiné aplikace k vašemu účtu. V asistentovi není uloženo nic kromě uděleného přístupu a ten lze kdykoli odvolat (viz níže).

API klíč

Pro nástroje, které nepodporují automatický tok přihlášení, funguje statický API klíč stejně jako vždy: vygenerujte jej a vložte jako Bearer token.

[navigate:/apiKeys|Získat API klíč|key]

Vytvořte si vlastní integraci

Vývojáři integrující přímo (spíše než prostřednictvím hotového AI asistenta) mohou používat koncové body OAuth přímo — včetně samočinné registrace klienta (bez ručního nastavení, RFC 7591) a připojení pomocí PKCE namísto uloženého tajemství (RFC 7636). Viz doc/OAUTH_SETUP.md v kódové základně pro kompletní technický návod s příklady curl, nebo použijte předem registrované client_id/client_secret tradičním způsobem, pokud dáváte přednost.

Discovery: {HOSTNAME}/.well-known/oauth-authorization-server
Autorizovat: {HOSTNAME}/auth/oauth/authorize
Výměna tokenu: {HOSTNAME}/auth/oauth/token
Odvolat: {HOSTNAME}/auth/oauth/revoke

Výsledný přístupový token se používá stejným způsobem jako API klíč — jako hlavička Authorization: Bearer <token> u požadavků na koncový bod MCP.

Nastavení platformy AI

Připojte svého oblíbeného AI asistenta k vašemu serveru MCP. Každá platforma níže se řídí stejným postupem: vložte URL serveru, klikněte na Připojit, přihlaste se a schvalte přístup — není vyžadován žádný API klíč.

Claude

1. Otevřete nastavení Claude

Přejděte na Nastavení → Konektory

2. Přidejte konektor

Klikněte na “Přidat konektor” a vložte URL serveru: {HOSTNAME}/api/mcp/{companyId}/mcp

3. Připojte se a schvalte

Klikněte na Připojit, přihlaste se, pokud budete vyzváni, a schvalte přístup. Zkuste se zeptat: “K jakým datům máte přístup?” nebo “Ukažte mi mé produkty”

ChatGPT [badge:Doporučeno|success|right]

1. Otevřete nastavení ChatGPT

Přejděte na Nastavení → Konektory

2. Přidejte vlastní konektor

Klikněte na “Přidat vlastní konektor” a vložte URL serveru: {HOSTNAME}/api/mcp/{companyId}/mcp

3. Připojte se a schvalte

Klikněte na Připojit, přihlaste se, pokud budete vyzváni, a schvalte přístup. Zkuste se zeptat: “Ukažte mi mé produkty” nebo “Jaké mám kategorie?”

**Poznámka:** Některé plány ChatGPT zpřístupňují konektory pouze pro výzkum/procházení, nikoli pro celou sadu nástrojů. Pokud se konektor neobjeví tam, kde byste ho očekávali, zkontrolujte, zda váš plán podporuje vlastní konektory.

LeChat

1. Otevřete LeChat

Přejděte na lechat.mistral.ai a začněte novou konverzaci

2. Přístup k nastavení konektoru/nástroje

V rozhraní chatu vyhledejte nastavení MCP nebo Externí nástroje

3. Přidejte server

Vložte URL serveru: {HOSTNAME}/api/mcp/{companyId}/mcp, poté se přihlaste a schvalte přístup, když budete vyzváni.

**Výhoda LeChat:**
LeChat od Mistral AI má vynikající podporu MCP a může efektivně používat vaše datové nástroje pro analýzu, reporting a úlohy průzkumu dat.

Cokoli jiného, co mluví MCP

Jakýkoli klient MCP s podporou vzdáleného konektoru objeví a dokončí přihlášení stejným způsobem – vložte URL serveru a postupujte podle jeho pokynů. Pro klienta, který podporuje pouze lokální most založený na stdio (bez vzdáleného OAuth), viz „Vytvořte si vlastní integraci“ výše, nebo se vraťte k použití statického API klíče.

Dostupné nástroje

AI nástroje zpřístupněné serverem MCP

query_data [badge:Nástroj|info|right]

Spouštějte dotazy pomocí dotazovacího jazyka

Příklad: products(limit: 10, where: "price > 100") { id, name, price }

list_entities [badge:Nástroj|info|right]

Vypište všechny dostupné entity/tabulky

Příklad: Nejsou vyžadovány žádné parametry

list_{entity} [badge:Nástroj|info|right]

Vypište záznamy z konkrétních entit

Příklad: limit: 10, where: "active = true", fields: "id, name"

Příklady API

Přímé volání API pro testování a integraci

Inicializace připojení

curl -X POST "{HOSTNAME}/api/mcp/{companyId}/mcp" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-06-18",
      "capabilities": {
        "roots": { "listChanged": true },
        "sampling": {}
      },
      "clientInfo": {
        "name": "TestClient",
        "version": "1.0.0"
      }
    }
  }'

Dotaz na data

curl -X POST "{HOSTNAME}/api/mcp/{companyId}/mcp" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "query_data",
      "arguments": {
        "query": "products(limit: 10) { id, name, price }"
      }
    }
  }'

Zjistěte více