Dokumentace serveru MCP

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í

Koncový bod serveru

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

Bearer Token: Váš API klíč

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

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

Nastavení platformy AI

Připojte svého oblíbeného AI asistenta k vašemu serveru MCP

Nastavení LeChat [badge:Doporučeno|success|right]

1. Otevřete LeChat

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

2. Vytvořte API klíč

Vygenerujte API klíč pro přístup k serveru MCP

[navigate:/apiKeys|Spravovat API klíče|key]

3. Přejděte do nastavení MCP

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

4. Přidejte server MCP

Přidejte svůj server MCP s následující konfigurací:

Název serveru: {productName}
URL serveru: {HOSTNAME}/api/mcp/{companyId}/mcp
Autorizační hlavička: Bearer YOUR_API_KEY

5. Otestujte připojení

LeChat otestuje připojení a zobrazí dostupné nástroje. Zkuste se zeptat: “K jakým datům mám přístup?” nebo “Zobraz mi moje produkty”

**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.

Nastavení ChatGPT Desktop

1. Nainstalujte ChatGPT Desktop

Stáhněte a nainstalujte aplikaci ChatGPT Desktop od OpenAI

2. Vytvořte API klíč

Vygenerujte API klíč pro přístup k serveru MCP

[navigate:/apiKeys|Spravovat API klíče|key]

3. Konfigurujte ChatGPT

Přidejte následující konfiguraci do nastavení ChatGPT Desktop

Konfigurační soubor:

{
  "mcpServers": {
    "{productName}": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/server-fetch",
        "{HOSTNAME}/api/mcp/{companyId}/mcp"
      ],
      "env": {
        "MCP_SERVER_URL": "{HOSTNAME}/api/mcp/{companyId}/mcp",
        "AUTHORIZATION": "Bearer YOUR_API_KEY"
      }
    }
  }
}

4. Začněte používat

ChatGPT má nyní přímý přístup k vašim datům! Zkuste se zeptat: “Zobraz mi moje produkty” nebo “Jaké mám kategorie?”

Nastavení ChatGPT Web [badge:Omezené|warning|right]

Webová verze ChatGPT má omezenou podporu MCP prostřednictvím vzdálených serverových připojení pro výzkumné účely. Nepodporuje celou škálu funkcí MCP dostupných v desktopové aplikaci.

Kroky nastavení:

1. Vytvořte API klíč

Vygenerujte API klíč pro přístup k serveru MCP

2. Přejděte do nastavení ChatGPT

V chat.openai.com klikněte na svůj profil → Nastavení → Připojení

3. Přidejte server MCP

Přidejte URL svého serveru MCP s autorizační hlavičkou:

URL: {HOSTNAME}/api/mcp/{companyId}/mcp
Autorizace: Bearer YOUR_API_KEY

4. Otestujte připojení

ChatGPT otestuje připojení a zobrazí dostupné nástroje pro výzkum

**Poznámka:**
Webová verze podporuje pouze vzdálené servery MCP pro výzkumné úlohy. Pro plnou funkčnost MCP včetně nástrojů, zdrojů a výzev doporučujeme používat aplikaci ChatGPT Desktop.

**Bezpečnostní upozornění**
Uchovávejte své API klíče v bezpečí a nesdílejte je veřejně. Zacházejte s nimi jako s hesly.

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 }"
      }
    }
  }'

Testování a ladění

[navigate:/devdoc/test-query|Testovací dotazy|play]

Použijte tyto nástroje k otestování nastavení serveru MCP a ověření syntaxe dotazů před použitím s aplikacemi AI.

Zjistěte více