Model Context Protocol
Kverton pro AI asistenty
Claude, ChatGPT, Cursor a další asistenti umějí přes MCP server pracovat s vaším Kvertonem přímo: založit dynamický kód, změnit, kam vede, vykreslit ho, přečíst statistiky. Vy říkáte, co chcete; asistent volá totéž API jako vaše systémy.
Co to je
Model Context Protocol je otevřený standard, kterým AI asistenti získávají nástroje. Kverton MCP server je malý program (npm balíček), který běží u vás a překládá požadavky asistenta na volání Kverton API pod vaším klíčem. Nic se neinstaluje na server Kvertonu, data tečou jen mezi vaším asistentem a vaším týmem.
„Založ dynamický kód pro podzimní menu na example.cz/menu-podzim, vykresli ho jako SVG a zítra mi řekni, kolik lidí ho naskenovalo v Praze.“
Asistent postupně zavolá kverton_create_code, kverton_render_svg a druhý den kverton_code_stats — a odpoví číslem, ne odkazem na návod.
Zapnutí za dvě minuty
- V Kvertonu založte API klíč: Týmy → tým → API klíče. Pro čtení statistik stačí klíč jen čtení; pro zakládání a změny kódů čtení + změny.
- Přidejte server do svého asistenta (Node.js 18+ musí být 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 další
Každý MCP klient má v nastavení „přidat server“ — vyplňte příkaz a proměnnou prostředí: npx -y @kverton/mcp, KVERTON_API_KEY.
Server běží lokálně přes stdio. Vyžaduje tarif s API (Pro nebo Studio); volání se počítají do denní kvóty týmu.
Co asistent umí
Třináct nástrojů, každý přesně jeden koncový bod API. Nic navíc, nic skrytého.
| 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čnost a hranice
- Asistent má přesně ta práva, která má klíč — klíč jen pro čtení nedovolí nic změnit ani smazat.
- Klíč zůstává u vás v konfiguraci asistenta; Kverton ho nikdy nezobrazí znovu a kdykoli ho zneplatníte v nastavení týmu.
- Každé volání je v přehledu užití klíče (kolik, kdy, k čemu) a počítá se do kvóty tarifu.
- Mazání kódu je nevratné — asistent je poučen, aby dal přednost pozastavení; přesto zvažte klíč bez práva změn pro každodenní dotazy.