Nástroje MCP

MCP server Kaloka dovolí agentovi číst běhy, připomínky, návrhy, changelog i dokumentaci a odpovídat kontrolujícím. Je součástí plánu Team a vyšších. Zachytávání, vyhodnocení a nahrávání zůstávají v CLI.

Připojení

Server je na https://kaloko.app/mcp (MCP přes Streamable HTTP). Ověříte se API tokenem organizace v hlavičce Authorization; jak ho vytvořit: Role a tokeny.

claude mcp add --transport http kaloko https://kaloko.app/mcp --header "Authorization: Bearer $KALOKO_TOKEN"

Ostatní agenti (Codex, Cursor) dostanou stejnou adresu a hlavičku jako HTTP MCP server. Na čtení stačí token jen pro čtení; nástroje, které zapisují, potřebují token s příslušným rozsahem. Token read:health (pro dashboard) vidí jen get_health, get_health_aggregate, get_health_diff a list_findings. Screenshoty a soubory přes MCP necestují: odpovědi nesou jejich adresy, které stáhnete stejným tokenem.

list_runs, list_notifications a list_comments odpovídají po stránkách. Když odpovídá víc položek, než je limit, odpověď má next; nástroj zavolejte znovu s cursor nastaveným na tuto hodnotu. REST API stránkuje stejné seznamy přes ?cursor= a další stránku uvádí v hlavičkách X-Next-Cursor a Link.

Běhy a kontrola

NástrojCo dělá
get_startedkde organizace stojí, její ukázkový běh a další kroky
add_sample_runpřidá ukázkový běh, nebo vrátí ten, který už existuje
list_projectsprojekty organizace s jejich zkratkami
upsert_projectzaloží projekt s názvem nebo ho přejmenuje (správce projektu) a přidá ho do produktu; jako kaloko projects create, rename a sync
list_runssdílené běhy od nejnovějšího, s filtrem podle scénáře, projektu, verdiktu, autora, prostředí, větve, ref (záznam, ke kterému běh patří, třeba CC-2026-001) nebo purpose (dry_run, formal, smoke); cursor pro další stránku
get_run_summaryjeden běh: stav každého kroku a jazyka, kritéria, která chtějí pozornost, s důkazy a zdůvodněním, adresy screenshotů, odkaz na plachtu, řádky (lanes) a role (sessions) toku a u každého kroku jeho řádek a roli
get_stack_itemsstránky stack kroku s jejich stavem a nesplněnými kritérii
get_step_assetsnejnovější snímek každého kroku scénáře na stálých adresách (Business); state vybere stav kroku
get_step_recordingvideo a záznam průběhu kroku; state vybere stav kroku
get_criteria_verdictsverdikty kontrolujících u ručních nebo přepsaných kritérií
get_review_queueo čem v běhu ještě musí rozhodnout člověk, a odkaz na kontrolu, který mu předáte
decide_stepvlastní schválení nebo vrácení kroku agentem; označí se jako agentovo a nikdy se nepočítá jako lidské
revoke_carried_approvalzruší schválení převzaté u kroku, na který se má někdo podívat znovu
get_signoff_recordpodepsaný záznam o přijetí běhu (Business)
get_evidencedoklady běhu nebo releasu pro vaše vlastní dokumenty: stav přijetí a podpisu, kritéria tak, jak se procházela, s odkazy na požadavky, výsledky, otisky snímků, rozhodnutí, podpisy, auditní stopa a matice dohledatelnosti (Business)
get_healthkondice běhu, nejnovějšího běhu scénáře nebo vývoj projektu: nálezy podle závažnosti, packu a kroku a co přibylo nebo se spravilo od minulého běhu; jen radí, verdikt nemění
get_health_aggregatekondice běhu (nebo nejnovějšího běhu scénáře) sečtená pro dashboard: po jazycích, krocích, kontrolách nebo packech, kolik výsledků prošlo, selhalo nebo je nejistých, nejvíc zasažené stránky a kolik je nových či opravených od minulého běhu; smí ho volat i token read:health
get_health_diffpo stránkách, jazycích a kontrolách co je nového, opraveného nebo pořád otevřeného od minulého běhu, s během, který to viděl poprvé; smí ho volat i token read:health
list_findingsotevřené výsledky scénáře seskupené do nálezů podle kontroly, webu, jazyka a kroku: závažnost, počet zasažených stránek, ukázkové stránky s odkazem do CMS, první a poslední výskyt, stav (otevřený, potvrzený, ignorovaný s důvodem, opravený) a issue v trackeru; jen čte, smí ho volat i token read:health
adopt_health_checkudělá z kontroly kondice u kroku (HC103) kritérium přijetí AC103 scénáře, beze změny nebo s novým textem (Developer / Tester); do souboru scénáře ho zapíše kaloko health pull
get_affected_stepske kterým krokům scénáře změněné soubory dosáhnou, a proč
list_notificationsschránka majitele tokenu

Připomínky a úkoly

NástrojCo dělá
get_feedbackverdikt běhu, schválené kroky, otevřená vrácení a komentáře
list_commentsotevřená vlákna v celé organizaci s odpověďmi, špendlíky a nakreslenými oblastmi
add_commentkomentář ke kroku, běhu nebo celému flow, nebo odpověď
resolve_commentuzavře vlákno s poznámkou, co se změnilo
reopen_comment, edit_comment, delete_commentznovu otevře vlákno; upraví nebo smaže vlastní komentář
get_findingsnálezy experimentálního třídění v běhu (druh problému na každé obrazovce) a odpovědi lidí na ně
answer_findingoznačí nález jako správný, jako ne-problém, nebo jako převedený na komentář
get_triage_reportjak se třídění daří ve vaší organizaci: užitečné nálezy podle druhu, jak sedí jeho pravděpodobnosti, nálezy převedené na komentář, čas do prvního posouzení s nálezy a bez nich
list_ignore_regionsoblasti, které lidé nakreslili, aby se vynechaly z porovnání pixelů
add_ignore_regionnavrhne takovou oblast
create_issueúkol v Jiře nebo Linearu z kroku, se screenshotem, kritériem a poznámkami
list_issuesúkoly vytvořené z kroků a jejich stav
list_schedules, run_schedulehostované běhy a jejich limit stránek; jeden spustí hned

Design

NástrojCo dělá
get_draftkterou revizi ukazuje každý krok společného konceptu a kdo ji změnil
get_steppředání kroku: živé soubory, tokeny, struktura stránky, otevřené komentáře; u každého snímku stav kroku a režim tokenů
get_step_specco se má u kroku postavit podle schváleného návrhu: prvky, styly převedené na tokeny, stavy, kontrast; state pro prázdný, chybový nebo jiný stav kroku
get_step_driftčím se běh implementace liší od reference designu, v jednom stavu kroku (state)
get_step_historyverze a revize kroku s autory
list_step_changeskroky, které se změnily mezi dvěma referencemi nebo od posledního přijatého běhu
get_references, get_tokensreference designu a baseline; sada tokenů projektu
get_draft_feedbackkomentáře ke konceptu
get_version_notes, set_version_notespřečte nebo přepíše, co se ve verzi změnilo
publish_version, set_reference, set_step_status, add_draft_commentpublikuje koncept jako verzi, nastaví referenci, nastaví stav kroku, okomentuje koncept

Obrazovky, changelog, dokumentace a produkty

NástrojCo dělá
search_screensknihovna obrazovek: nejnovější screenshot každého kroku, hledání podle slov, projektu, produktu, jazyka nebo stavu
list_productsprodukty, které čtete, s nejnovějším vydáním, dokumentací a čtenáři
get_changelogvizuální changelog produktu, volitelně i s obrázky
draft_changelog_entryco přijaté běhy od posledního vydání ukazují jinak, jako koncept záznamu s odkazy na kroky před a po
resolve_step_imagejeden odkaz na krok (kaloko:<scénář>/<krok>) jako adresa obrázku
get_docspublikovaná dokumentace produktu: verze, jazyky, postranní menu, nebo jedna stránka
docs_checkco v publikované dokumentaci chce pozornost: rozbité odkazy, zastaralé části, chybějící překlady

Chyby se vracejí jako výsledek nástroje označený jako chyba (neznámý běh, chybějící argument). Neplatný token dostane HTTP 401; organizace v plánu nižším než Team se dozví, že MCP server její plán nemá.

Kaloko · latest · 2026-11-21