Úvod

MCP (Model Context Protocol) je otvorený štandard, cez ktorý AI aplikácie siahajú do iných systémov. MCP server Ragnetiq sprístupní vašej AI rovnaké dáta ako API štatistík: AI sa potom dá pýtať bežnou rečou, napríklad „Na čo sa zákazníci v Česku pýtali tento mesiac najčastejšie?“ alebo „Porovnaj objednávky zo SmartBoxu v septembri a októbri“.

Adresa servera je https://mcp.ragnetiq.com. Server iba číta, nič nemení a nič neukladá: každú otázku AI prepošle s vaším kľúčom do API príslušného produktu, ktoré samo skontroluje, k čomu má kľúč prístup.

Používa tie isté kľúče ako API štatistík: as_ AI asistent, sb_ SmartBox, ss_ Smart Search. Nový kľúč netreba.
AI vidí iba produkty, ktorých kľúč pripojíte, a iba obchody a jazykové mutácie, ktoré kľúč pokrýva.
Osobné údaje zákazníkov sú v textoch nahradené [e-mail] a [telefón], rovnako ako v API.
Každé zavolanie nástroja je jedna požiadavka na API produktu a počíta sa do limitu 120 požiadaviek za minútu na kľúč.

Kľúče

Kľúč vám vystaví Ragnetiq, rovnako ako pre API. Pošlite ho v hlavičke Authorization; ak máte viac produktov, dajte všetky kľúče za seba oddelené čiarkou. Na každý produkt jeden kľúč.

Authorization: Bearer as_VAS_KLUC,sb_VAS_KLUC

Kľúč je tajný ako heslo. Používajte ho len zo servera (cron, backend, ETL), nikdy nie v prehliadači ani v mobilnej aplikácii. Ak unikne, napíšte nám: starý kľúč odvoláme a vystavíme nový; odvolaný kľúč prestane fungovať okamžite.

Aplikácie, ktoré hlavičku nastaviť nevedia (napríklad vlastné konektory v ChatGPT alebo na claude.ai), môžu dať kľúče do adresy: https://mcp.ragnetiq.com/as_…,sb_…. Takú adresu chráňte ako heslo: kto ju má, vidí vaše štatistiky. Kde sa dá, používajte hlavičku.

Pravidlá spoločné pre všetky API Ragnetiq (kľúče, stránkovanie, limity, chyby, verzie) sú aj na jednej stránke: Základy API.

Pripojenie

Claude Code

claude mcp add --transport http ragnetiq https://mcp.ragnetiq.com \
  --header "Authorization: Bearer as_VAS_KLUC,sb_VAS_KLUC"

Claude Desktop

V aplikácii otvorte Nastavenia → Developer → Edit Config a do claude_desktop_config.json pridajte server (potrebuje Node.js 18+). Potom aplikáciu reštartujte.

claude_desktop_config.json

{
  "mcpServers": {
    "ragnetiq": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.ragnetiq.com", "--header", "Authorization:${RAGNETIQ_AUTH}"],
      "env": { "RAGNETIQ_AUTH": "Bearer as_VAS_KLUC,sb_VAS_KLUC" }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "ragnetiq": {
      "url": "https://mcp.ragnetiq.com",
      "headers": { "Authorization": "Bearer as_VAS_KLUC,sb_VAS_KLUC" }
    }
  }
}

VS Code

Kľúče si VS Code vypýta pri prvom spustení a uloží ich bezpečne; v súbore nebudú.

.vscode/mcp.json

{
  "servers": {
    "ragnetiq": {
      "type": "http",
      "url": "https://mcp.ragnetiq.com",
      "headers": { "Authorization": "Bearer ${input:ragnetiq-keys}" }
    }
  },
  "inputs": [
    { "type": "promptString", "id": "ragnetiq-keys", "description": "Kľúče Ragnetiq (as_…,sb_…,ss_…)", "password": true }
  ]
}

ChatGPT, claude.ai a ďalšie

Pridajte vlastný MCP konektor (custom connector) bez prihlasovania (OAuth) s adresou, ktorá obsahuje kľúče: https://mcp.ragnetiq.com/as_…,sb_…. Ostatné aplikácie s podporou MCP cez HTTP („Streamable HTTP“) nastavte ako Cursor: adresa servera a hlavička Authorization.

Overenie

Server odpovedá na štandardné správy MCP (JSON-RPC 2.0 cez HTTP POST). Zoznam nástrojov si overíte aj bez AI:

curl https://mcp.ragnetiq.com \
  -H "Authorization: Bearer as_VAS_KLUC,sb_VAS_KLUC" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Nástroje

AI dostane iba nástroje produktov, ktorých kľúč ste pripojili. Všetky majú voliteľné obdobie from a to (YYYY-MM-DD, predvolene posledných 30 dní, najviac 366 dní); dni sa počítajú v časovom pásme Europe/Bratislava. Odpoveď je JSON z API produktu.

AI asistent (`as_`)

Nástroj	Čo vráti	API
`assistant_client`	E-shop, jeho jazykové mutácie a zapnuté moduly.	/client
`assistant_summary`	Čísla z dashboardu aj s predchádzajúcim obdobím.	/summary
`assistant_conversations`	Konverzácie s celým priebehom, po stranách (predvolene 20, najviac 200).	/conversations
`assistant_products`	Top 100 odporúčaných produktov s preklikmi.	/products
`assistant_orders`, `assistant_carts`	Objednávky a košíky pripísané asistentovi.	/orders

Voliteľne market: doména jazykovej mutácie, napríklad demo-shop.cz.

SmartBox (`sb_`)

Nástroj	Čo vráti	API
`smartbox_shops`	Obchody a trhy kľúča.	/shops
`smartbox_summary`	Čísla z prehľadu, trhy a najčastejšie otázky.	/summary
`smartbox_products`	Top 100 produktov, na ktoré sa zákazníci pýtali.	/products
`smartbox_events`	Otázky a odpovede, po stranách (predvolene 100, najviac 1 000).	/events
`smartbox_orders`	Pripísané objednávky, po stranách.	/orders

Voliteľne shop a market.

Smart Search (`ss_`)

Nástroj	Čo vráti	API
`search_shops`	Obchody kľúča.	/shops
`search_summary`	Čísla z prehľadu vrátane odporúčaní.	/summary
`search_queries`	Najhľadanejšie výrazy, výrazy bez výsledku a bez prekliku.	/queries
`search_products`	Produkty nájdené a otvorené cez vyhľadávanie.	/products
`search_events`	Surové udalosti, po stranách (predvolene 100, najviac 1 000).	/events
`search_purchases`	Objednávky, ktoré vyhľadávanie zachytilo, po stranách.	/purchases

Voliteľne shop.

Surové dáta (konverzácie, udalosti, objednávky) idú po stranách s menšou predvolenou veľkosťou ako v API, aby sa zmestili do pamäte modelu. Veľmi dlhú odpoveď server skráti a AI vyzve, nech si vypýta kratšie obdobie alebo ďalšiu stranu.

Na čo sa pýtať

„Ako si AI asistent viedol tento mesiac oproti minulému?“
„Na čo sa zákazníci v slovenskej mutácii najčastejšie pýtali a čo im asistent odporučil?“
„Ktoré výrazy v Smart Search nemajú žiadny výsledok? Navrhni synonymá.“
„Ktoré produkty v SmartBoxe majú veľa otázok, ale málo objednávok?“
„Priprav mi stručný mesačný report zo všetkých produktov Ragnetiq.“

Bezpečnosť

Server je iba na čítanie: nástroje nič nezapisujú, nemenia nastavenia a neposielajú správy zákazníkom.
Server nič neukladá. Kľúč použije iba na požiadavku do API produktu a výsledok vráti vašej AI.
Čo AI z odpovedí zapamätá, rieši poskytovateľ vašej AI aplikácie (Anthropic, OpenAI…) podľa vašich nastavení u neho.
Ak kľúč unikne, napíšte nám: odvoláme ho a vystavíme nový; odvolaný kľúč prestane fungovať okamžite aj v MCP.

Zmeny

Dátum	Verzia	Zmena
25. 10. 2026	v1	Prvé vydanie: nástroje pre AI asistenta, SmartBox a Smart Search; kľúče v hlavičke alebo v adrese.

MCP server