Dokumentácia servera MCP

Čo je to?

Poznámka správcu: Táto funkcia je mostom medzi vašimi obchodnými dátami a modernými asistentmi AI, ako sú ChatGPT, Claude alebo LeChat. Umožňuje vám “hovoriť” s dátami vášho e-shopu pomocou prirodzeného jazyka, aby ste získali okamžité odpovede a analýzy.

Pre koho je to určené? Správcovia by si to mali prečítať, aby pochopili, ako môžu používať AI na skúmanie svojich vlastných dát. Môžete si to nastaviť sami v nastaveniach svojej obľúbenej aplikácie AI vložením poskytnutej URL – nie je potrebné žiadne kódovanie, žiadny API kľúč ani vývojár pre základné použitie, hoci váš vývojár vám môže pomôcť s pokročilejšími konfiguráciami.

Kľúčové výhody pre e-shop:

Okamžité odpovede na dáta: Opýtajte sa svojej AI “Aké boli moje top 5 najpredávanejších produktov minulý týždeň?” alebo “Zobraz mi všetky objednávky z New Yorku” a získajte okamžitú odpoveď.
Analýza prirodzeného jazyka: Nie je potrebné učiť sa zložité dopytovacie jazyky - jednoducho sa rozprávajte so svojimi dátami, ako keby ste sa rozprávali s ľudským asistentom.
Štatistiky poháňané AI: Nechajte AI analyzovať vaše trendy predaja, identifikovať položky s nízkym stavom zásob alebo zhrnúť správanie zákazníkov za vás.
Moderný pracovný postup: Prineste dáta svojho e-shopu priamo do nástrojov AI, ktoré už používate každý deň na plánovanie a stratégiu.

Prehľad

Server Model Context Protocol (MCP) poskytuje štandardizovaný prístup k vašim dátam pre aplikácie AI. Umožňuje AI asistentom, ako sú LeChat, ChatGPT, Claude a ďalšie, priamo dopytovať vaše dáta pomocou prirodzeného jazyka.

Protokol: JSON-RPC 2.0 | Protokol MCP 2025-06-18 | HTTP Transport | Dopyty v reálnom čase

Rýchle nastavenie

Pre AI asistentov, ktorí podporujú MCP konektory (ChatGPT, Claude, …), je to skutočne jeden krok: vložte nižšie uvedenú URL servera do nastavení konektora asistenta. Sám si nájde spôsob, ako vás prihlásiť a požiada vás o schválenie prístupu — žiadny API kľúč, žiadne kopírovanie ID klientov, nič, čo by ste museli vopred nastavovať.

Koncový bod servera

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

Informácie o serveri: {HOSTNAME}/api/mcp/{companyId}/info

Stránka Nastavenia s touto URL a pokynmi na kopírovanie a vloženie je tiež priamo dostupná na [navigate:/settings/mcp|Nastavenia → MCP Server|plug].

Možnosti autentifikácie

Prihlásenie a schválenie [badge:Odporúčané|success|right]

Predvolené nastavenie, ktoré používajú nižšie uvedené sprievodcovia nastavením. Asistent sám zistí, ako sa pripojiť, akonáhle mu poskytnete URL servera, a potom otvorí bežnú obrazovku prihlásenia + “Schváliť prístup?” — rovnaký typ výzvy, akú by ste videli pri pripájaní akejkoľvek inej aplikácie k vášmu účtu. V asistentovi sa neukladá nič okrem udeleného prístupu a ten môže byť kedykoľvek zrušený (pozri nižšie).

API kľúč

Pre nástroje, ktoré nepodporujú automatický tok prihlásenia, statický API kľúč funguje rovnako ako vždy: vygenerujte ho a vložte ako Bearer token.

[navigate:/apiKeys|Získať API kľúč|key]

Vytvorte si vlastnú integráciu

Vývojári integrujúci priamo (namiesto prostredníctvom hotového AI asistenta) môžu priamo používať koncové body OAuth — vrátane samoregistrácie klienta (bez manuálneho nastavenia, RFC 7591) a pripojenia pomocou PKCE namiesto uloženého tajomstva (RFC 7636). Pozrite si doc/OAUTH_SETUP.md v kódovej základni pre kompletný technický návod s príkladmi curl, alebo použite vopred zaregistrovaný client_id/client_secret tradičným spôsobom, ak to preferujete.

Discovery: {HOSTNAME}/.well-known/oauth-authorization-server
Authorize: {HOSTNAME}/auth/oauth/authorize
Token exchange: {HOSTNAME}/auth/oauth/token
Revoke: {HOSTNAME}/auth/oauth/revoke

Výsledný prístupový token sa používa rovnako ako API kľúč — ako hlavička Authorization: Bearer <token> pri požiadavkách na koncový bod MCP.

Nastavenie platformy AI

Pripojte svojho obľúbeného AI asistenta k serveru MCP. Každá platforma nižšie má rovnaký postup: vložte URL servera, kliknite na Pripojiť, prihláste sa a schváľte prístup — nie je potrebný žiadny API kľúč.

Claude

1. Otvorte nastavenia Claude

Prejdite na Nastavenia → Konektory

2. Pridajte konektor

Kliknite na “Pridať konektor” a vložte URL servera: {HOSTNAME}/api/mcp/{companyId}/mcp

3. Pripojte sa a schváľte

Kliknite na Pripojiť, prihláste sa, ak budete vyzvaní, a schváľte prístup. Skúste sa opýtať: “K akým dátam máte prístup?” alebo “Ukážte mi moje produkty”

ChatGPT [badge:Odporúčané|success|right]

1. Otvorte nastavenia ChatGPT

Prejdite na Nastavenia → Konektory

2. Pridajte vlastný konektor

Kliknite na “Pridať vlastný konektor” a vložte URL servera: {HOSTNAME}/api/mcp/{companyId}/mcp

3. Pripojte sa a schváľte

Kliknite na Pripojiť, prihláste sa, ak budete vyzvaní, a schváľte prístup. Skúste sa opýtať: “Ukážte mi moje produkty” alebo “Aké kategórie mám?”

**Poznámka:** Niektoré plány ChatGPT sprístupňujú konektory len na výskum/prehliadanie, nie na celú sadu nástrojov. Ak sa konektor nezobrazí tam, kde očakávate, skontrolujte, či váš plán podporuje vlastné konektory.

LeChat

1. Otvorte LeChat

Prejdite na lechat.mistral.ai a začnite novú konverzáciu

2. Prístup k nastaveniam konektora/nástroja

V rozhraní chatu vyhľadajte nastavenia MCP alebo External Tools

3. Pridajte server

Vložte URL servera: {HOSTNAME}/api/mcp/{companyId}/mcp, potom sa prihláste a schváľte prístup, keď budete vyzvaní

**Výhoda LeChat:**
LeChat od Mistral AI má vynikajúcu podporu MCP a môže efektívne využívať vaše dátové nástroje na analýzu, reporting a úlohy prieskumu dát.

Čokoľvek iné, čo hovorí MCP

Akýkoľvek klient MCP s podporou vzdialeného konektora objaví a dokončí prihlásenie rovnakým spôsobom — prilepte URL servera a postupujte podľa jeho pokynov. Pre klienta, ktorý podporuje iba lokálny mostík založený na stdio (bez vzdialeného OAuth), pozrite si “Vytvorte si vlastnú integráciu” vyššie, alebo sa vráťte k statickému API kľúču.

Dostupné nástroje

Nástroje AI sprístupnené serverom MCP

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

Spúšťajte dopyty pomocou dopytovacieho jazyka

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

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

Zobrazí zoznam všetkých dostupných entít/tabuliek

Príklad: Nevyžadujú sa žiadne parametre

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

Zobrazí zoznam záznamov z konkrétnych entít

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

Príklady API

Priame volania API na testovanie a integráciu

Inicializácia pripojenia

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

Dopytovanie dát

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

Zistite viac