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. Screenshoty a soubory přes MCP necestují: odpovědi nesou jejich adresy, které stáhnete stejným tokenem.
Běhy a kontrola
| Nástroj | Co dělá |
|---|---|
get_started | kde organizace stojí, její ukázkový běh a další kroky |
add_sample_run | přidá ukázkový běh, nebo vrátí ten, který už existuje |
list_projects | projekty organizace s jejich zkratkami |
list_runs | sdílené běhy od nejnovějšího, s filtrem podle scénáře, projektu, verdiktu, autora, prostředí nebo větve |
get_run_summary | jeden 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 |
get_stack_items | stránky stack kroku s jejich stavem a nesplněnými kritérii |
get_step_assets | nejnovější snímek každého kroku scénáře na stálých adresách (Business) |
get_step_recording | video a záznam průběhu kroku |
get_criteria_verdicts | verdikty kontrolujících u ručních nebo přepsaných kritérií |
get_review_queue | o čem v běhu ještě musí rozhodnout člověk, a odkaz na kontrolu, který mu předáte |
decide_step | vlastní schválení nebo vrácení kroku agentem; označí se jako agentovo a nikdy se nepočítá jako lidské |
revoke_carried_approval | zruší schválení převzaté u kroku, na který se má někdo podívat znovu |
get_signoff_record | podepsaný záznam o přijetí běhu (Business) |
get_affected_steps | ke kterým krokům scénáře změněné soubory dosáhnou, a proč |
list_notifications | schránka majitele tokenu |
Připomínky a úkoly
| Nástroj | Co dělá |
|---|---|
get_feedback | verdikt běhu, schválené kroky, otevřená vrácení a komentáře |
list_comments | otevřená vlákna v celé organizaci s odpověďmi, špendlíky a nakreslenými oblastmi |
add_comment | komentář ke kroku, běhu nebo celému flow, nebo odpověď |
resolve_comment | uzavře vlákno s poznámkou, co se změnilo |
reopen_comment, edit_comment, delete_comment | znovu otevře vlákno; upraví nebo smaže vlastní komentář |
list_ignore_regions | oblasti, které lidé nakreslili, aby se vynechaly z porovnání pixelů |
add_ignore_region | navrhne 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_schedule | hostované běhy a jejich limit stránek; jeden spustí hned |
Design
| Nástroj | Co dělá |
|---|---|
get_draft | kterou revizi ukazuje každý krok společného konceptu a kdo ji změnil |
get_step | předání kroku: živé soubory, tokeny, struktura stránky, otevřené komentáře |
get_step_spec | co se má u kroku postavit podle schváleného návrhu: prvky, styly převedené na tokeny, stavy, kontrast |
get_step_drift | čím se běh implementace liší od reference designu |
get_step_history | verze a revize kroku s autory |
list_step_changes | kroky, které se změnily mezi dvěma referencemi nebo od posledního přijatého běhu |
get_references, get_tokens | reference designu a baseline; sada tokenů projektu |
get_draft_feedback | komentáře ke konceptu |
get_version_notes, set_version_notes | přečte nebo přepíše, co se ve verzi změnilo |
publish_version, set_reference, set_step_status, add_draft_comment | publikuje koncept jako verzi, nastaví referenci, nastaví stav kroku, okomentuje koncept |
Obrazovky, changelog, dokumentace a produkty
| Nástroj | Co dělá |
|---|---|
search_screens | knihovna obrazovek: nejnovější screenshot každého kroku, hledání podle slov, projektu, produktu, jazyka nebo stavu |
list_products | produkty, které čtete, s nejnovějším vydáním, dokumentací a čtenáři |
get_changelog | vizuální changelog produktu, volitelně i s obrázky |
draft_changelog_entry | co 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_image | jeden odkaz na krok (kaloko:<scénář>/<krok>) jako adresa obrázku |
get_docs | publikovaná dokumentace produktu: verze, jazyky, postranní menu, nebo jedna stránka |
docs_check | co 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á.