Model Context Protocol
Kverton pre AI asistentov
Claude, ChatGPT, Cursor a ďalší asistenti vedia cez MCP server pracovať s vaším Kvertonom priamo: založiť dynamický kód, zmeniť, kam vedie, vykresliť ho, prečítať štatistiky. Vy hovoríte, čo chcete; asistent volá to isté API ako vaše systémy.
Čo to je
Model Context Protocol je otvorený štandard, ktorým AI asistenti získavajú nástroje. Kverton MCP server je malý program (npm balíček), ktorý beží u vás a prekladá požiadavky asistenta na volania Kverton API pod vaším kľúčom. Na server Kvertonu sa nič neinštaluje, dáta tečú len medzi vaším asistentom a vaším tímom.
„Založ dynamický kód pre jesenné menu na example.sk/menu-jesen, vykresli ho ako SVG a zajtra mi povedz, koľko ľudí ho naskenovalo v Bratislave.“
Asistent postupne zavolá kverton_create_code, kverton_render_svg a na druhý deň kverton_code_stats — a odpovie číslom, nie odkazom na návod.
Zapnutie za dve minúty
- V Kvertone založte API kľúč: Tímy → tím → API kľúče. Na čítanie štatistík stačí kľúč len čítanie; na zakladanie a zmeny kódov čítanie + zmeny.
- Pridajte server do svojho asistenta (Node.js 18+ musí byť v počítači):
Claude Desktop — claude_desktop_config.json
{
"mcpServers": {
"kverton": {
"command": "npx",
"args": ["-y", "@kverton/mcp"],
"env": { "KVERTON_API_KEY": "kv_XXXXXXXX_…" }
}
}
}
Claude Code
claude mcp add kverton \ -e KVERTON_API_KEY=kv_XXXXXXXX_… \ -- npx -y @kverton/mcp
Cursor, Windsurf, ChatGPT a ďalšie
Každý MCP klient má v nastavení „pridať server“ — vyplňte príkaz a premennú prostredia: npx -y @kverton/mcp, KVERTON_API_KEY.
Server beží lokálne cez stdio. Vyžaduje tarifu s API (Pro alebo Studio); volania sa počítajú do dennej kvóty tímu.
Čo asistent vie
Trinásť nástrojov, každý presne jeden koncový bod API. Nič navyše, nič skryté.
| Nástroj | API | Práva |
|---|---|---|
| kverton_me | GET /me | read |
| kverton_list_codes | GET /codes | read |
| kverton_create_code | POST /codes | write |
| kverton_get_code | GET /codes/{id} | read |
| kverton_update_code | PATCH /codes/{id} | write |
| kverton_delete_code | DELETE /codes/{id} | write |
| kverton_code_stats | GET /codes/{id}/stats | read |
| kverton_code_history | GET /codes/{id}/history | read |
| kverton_rollback_code | POST /codes/{id}/rollback | write |
| kverton_list_groups | GET /groups | read |
| kverton_render_svg | POST /render | read |
| kverton_list_webhooks | GET /webhooks | read |
| kverton_create_webhook | POST /webhooks | write |
Bezpečnosť a hranice
- Asistent má presne tie práva, ktoré má kľúč — kľúč len na čítanie nedovolí nič zmeniť ani zmazať.
- Kľúč ostáva u vás v konfigurácii asistenta; Kverton ho nikdy nezobrazí znovu a kedykoľvek ho zneplatníte v nastavení tímu.
- Každé volanie je v prehľade užitia kľúča (koľko, kedy, na čo) a počíta sa do kvóty tarify.
- Mazanie kódu je nevratné — asistent je poučený, aby dal prednosť pozastaveniu; napriek tomu zvážte kľúč bez práva zmien pre každodenné otázky.