AI, dáta a integrácie

MCP CK DAKA

MCP server, cez ktorý AI asistenti bezpečne čítajú dáta systému CK DAKA

Server/API

O projekte

Server podľa Model Context Protocol, ktorý sprístupní dáta cestovnej kancelárie ľubovoľnému AI klientovi (Claude Code, Claude Desktop, claude.ai, vlastné appky cez Agent SDK). Číta priamo z MariaDB databázy systému CK – katalóg zájazdov a termínov, objednávky, faktúry, zákazníkov, dotazníky a predajné štatistiky – a iba číta, zápis je zablokovaný na viacerých úrovniach. Beží lokálne cez stdio alebo ako zdieľaná HTTP inštancia; v produkcii je vložený do backendu CK-DAKA-app ako interný endpoint s OAuth prihlásením.

Čo aplikácia vie

  • 24 MCP nástrojov v oblastiach katalóg (zájazdy, termíny s voľnou kapacitou, destinácie, kategórie, nástupné miesta), objednávky a faktúry, zákazníci, dotazníky od klientov a predajné štatistiky
  • Predajné prehľady: tržby za obdobie, ziskovosť jednotlivých odchodov a rebríček najpredávanejších zájazdov
  • Súhrny dotazníkov spokojnosti a zoznam otázok, vyhľadávanie a detail konkrétneho dotazníka
  • Prieskum databázy (zoznam tabuliek, popis stĺpcov) a vlastný SQL dotaz s povolením iba SELECT/WITH/SHOW/EXPLAIN/DESCRIBE
  • Automatická redakcia citlivých stĺpcov (heslá, tokeny, API kľúče, hashe, kódy darčekových kariet) a voliteľne dokladov totožnosti a IBAN
  • Ochrana proti zápisu na troch úrovniach: kontrola príkazu, READ ONLY transakcia na každom spojení a databázový účet len s právom SELECT; časový limit dotazu
  • Prompt „odporuc-zajazd“ – hotové zadanie na odporučenie zájazdu podľa požiadaviek klienta
  • Režim stdio aj bezstavový HTTP režim s bearer tokenom (porovnanie odolné voči časovaniu), zoznamom povolených IP a podporou reverznej proxy
  • Integračné testy proti skutočnej schéme so syntetickými dátami, diagnostický skript doctor a test endpointu

Technicky zaujímavé

  • AI asistent sa vie pýtať na celú firmu bežnou rečou – od voľných miest na termíne po ziskovosť odchodov – bez toho, aby mohol čokoľvek zmeniť
  • Viacvrstvová ochrana dát: read-only na úrovni kódu, transakcie aj DB účtu a automatické skrývanie citlivých stĺpcov
  • Jedno napojenie pre všetky projekty – stdio pre vývojárske nástroje, HTTP/OAuth pre claude.ai a appky