download_for_offlineJedna statická binárka — do ľubovoľného git projektu na GitHube, Bitbucket Cloude alebo GitLabe

Inštalácia AI vývojára mcptask_runner

Vyberte si operačný systém, framework a kódovacie CLI — každý príkaz na tejto stránke sa prepíše na ten, ktorý skutočne napíšete.

verified30 dní zadarmo. Bez kreditnej karty. Kedykoľvek zrušíte.

forward_to_inbox

Nie ste vývojár? Prepošlite stránku svojmu tímu

Inštaláciu urobí ten, kto sa u vás stará o projekt a vývojové stroje. Prepošlite mu túto stránku; pre vás je určený biznis pohľad bez kódu.

payments

Čo budete platiť

Dve predplatné, nič iné.

mcptask.online

Starter $19 mesačne za dvoch používateľov, Professional $14 za používateľa mesačne. Človek aj runner sú používatelia za rovnakú cenu: každý runner zaberá vlastné miesto, takže vy a jeden runner ste dve miesta.

Programovacie CLI

Predplatné platíte priamo jeho poskytovateľovi – pri Claude Code aspoň Pro. Beh bez dozoru spotrebuje viac než ručná práca.

30 dní zdarma, bez platobnej karty.

Celý cenník

Vyberte svoj systém, svoj framework/platformu a svoje kódovacie CLI

Všetko nižšie je potom napísané presne pre túto kombináciu — žiadne vetvenie, ktoré by ste museli riešiť v hlave.

Operačný systém

Čo potrebujete pred začiatkom

Tri veci — a takmer iste ich už máte. Karty aj kontroly nižšie sa riadia kódovacím CLI, ktoré ste vybrali hore; kontroly navyše menujú všetkých troch hostiteľov, na ktorých runner otvára pull requesty: GitHub, Bitbucket Cloud a GitLab.

description

Projekt

Váš projekt musí byť git repozitár s originom na GitHube, Bitbucket Cloude alebo GitLabe — a musí sa z neho dať commitovať a otvárať pull requesty zo stroja, kde runner beží. To znamená funkčný prístup: ssh kľúč, ktorý smie pushovať, právo zápisu do repozitára a prihlasovací údaj hostiteľa pre samotný pull request — kontrola PR hostiteľa nižšie ukáže, aký potrebuje ten váš. Runner pracuje pod vašou identitou — čo nepushnete vy, nepushne ani on.

terminal

Claude Code

Rozbehnite si Claude Code tak, ako by ste ho chceli používať sami: nainštalované, prihlásené a s tarifom, ktorý unesie celý pracovný deň — aspoň Pro; beh bez dozoru spotrebuje viac než ručné pýtanie sa. V repozitári nechajte CLAUDE.md — runner si z neho berie kontext o projekte. Kontrola prihlásenia je nižšie.

vpn_key

Účet na mcptask.online

Účet na mcptask.online aspoň s jedným projektom a osobný API token z používateľského menu. Token autentizuje runner ako vás, aby mohol čítať vaše úlohy, zapisovať postup a pridávať správy vaším menom. Bez tokenu nie je runner — inštalačný krok sa naň pýta, pretože ho inštalátor potrebuje na zapojenie vášho .mcp.json.

Teraz si to overte, ne predpokladajte

Karty hore vysvetľujú; tento blok kontroluje. Každý príkaz spustite a porovnajte, čo vypíše, s očakávanou odpoveďou — ak sa líši, napravte to skôr, než sa pustíte do inštalátora.

account_tree

git a origin na GitHube, Bitbucket Cloude alebo GitLabe

Runner otvára pull requesty, takže váš projekt musí byť git repozitár, ktorého origin smeruje na GitHub, Bitbucket Cloud alebo GitLab — gitlab.com aj self-managed inštancie platia obe. Menom odmietaný host je teraz GitHub Enterprise: rozpozná sa podľa presného hostname a runner ho odmietne so správou, ktorá to hovorí, nikdy ho potichu neberie ako github.com.

codePríkaz v shelli
git remote get-url origin
git@github.com:org/vas-projekt.git

git@bitbucket.org:workspace/vas-projekt.git aj git@gitlab.com:skupina/vas-projekt.git sú rovnako dobré odpovede. SSH alias, mirror alebo self-managed GitLab, ktorý hostiteľa skryje, je presne to, na čo je init --git-host bitbucket alebo init --git-host gitlab.

local_cafe

Homebrew len macOS

Inštalačný kanál pre macOS vedie cez Homebrew — na Linuxe alebo Windowse tu nie je čo kontrolovať a môžete ďalej.

codePríkaz v shelli
brew --version
Homebrew 4.6.7

Na verzii nezáleží — pointa je, že sa nejaká verzia vôbec vypíše.

smart_toy

Claude Code — nainštalovaný a prihlásený

Všetky ostatné predpoklady na tejto stránke zlyhajú hlasito a hneď. Tento zlyhá zdvorilo, o hodiny neskôr, niekde, kde sa nikto nepozerá: stroj s nainštalovaným, ale neprihláseným Claude Code vyzerá úplne zdravo. O 08:00 naštartuje naplánovaná úloha, potomok sa nedokáže prihlásiť a deň skončí bez jedinej hotovej úlohy — jedinou stopou je log, o ktorom zatiaľ neviete, že existuje. Je to najdrahšie opomenutie, aké táto stránka ponúka, preto dostáva najviac priestoru. Prihláseniu venujte rovnakú pozornosť ako inštalácii.

Nainštalujte

codePríkaz v shelli
curl -fsSL https://claude.ai/install.sh | bash

macOS a Linux — na Windowse použite natívny inštalátor: irm https://claude.ai/install.ps1 | iex.

Prihláste sa

codePríkaz v shelli
claude

Prvé spustenie otvorí prihlásenie v prehliadači. Dokončite ho — až ďalší krok potvrdí, že k nemu došlo.

Overte prihlásenie

codePríkaz v shelli
claude -p "Odpovedzte presne jedným slovom: pong"
pong

Čokoľvek iné než pong — predovšetkým chyba prihlásenia — znamená, že treba opraviť prihlásenie, nie inštalátor.

merge_type

PR hostiteľ — prihlásený tam, kde sa pull request otvára

Na push vetvy stačí git. Otvorenie pull requestu je samostatné volanie hostiteľa, ktoré robí mcptask_runner pr — jediný príkaz, ktorým runner pull requesty otvára, kontroluje a merguje — a každý hostiteľ chce vlastný prihlasovací údaj. Skontrolujte ten, na ktorý smeruje váš origin.

GitHub

Overte, že je gh prihlásené

codePríkaz v shelli
gh auth status
✓ Logged in to github.com account your-name

Na GitHube ide mcptask_runner pr cez gh a jeho vlastné prihlásenie — ssh kľúč vetvu pushne, ale pull request neotvorí. Not logged in znamená, že ďalším krokom je gh auth login.

Bitbucket Cloud

Dajte údaj do prostredia ešte pred init

codePríkaz v shelli
export BITBUCKET_ACCESS_TOKEN=<your-access-token>

Access token (Bearer) pre stroj. Pre človeka namiesto toho BITBUCKET_EMAIL a BITBUCKET_API_TOKEN (Basic) — nikdy oboje. App passwords sa odmietajú: Atlassian ich ukončil 2026-06-09. V PowerShelli: $env:BITBUCKET_ACCESS_TOKEN = "<your-access-token>".

Čo s ním init urobí

codePríkaz v shelli
ls -l ~/.mcptask_env.d/bitbucket_credentials
-rw------- 1 you staff … bitbucket_credentials

init údaj zapíše do tohto súboru s právami 0600 — nikdy ho neprepíše prázdnotou a nikdy ho nevypíše. Na Windowse sa kontrola práv preskakuje.

GitLab

Overte, že je glab prihlásené

codePríkaz v shelli
glab auth status
✓ Logged in to gitlab.com as your-name

Na GitLabe ide mcptask_runner pr cez CLI glab, ktoré si drží vlastné prihlásenie — runner si žiadny GitLab credential neukladá. Neprihlásené glab znamená, že ďalším krokom je glab auth login. To, čo tam pr create otvorí, je merge request.

Self-managed: povedzte to raz

codePríkaz v shelli
mcptask_runner init --git-host gitlab

Self-managed inštancia to potrebuje, pretože jej origin URL nie je gitlab.com. Runner od vás URL inštancie nikdy nepýta — glab už vie, kam je prihlásený.

  • settingsKódovacie CLI sa menuje raz na stroj a projekt: mcptask_runner init --cli claude, codex alebo opencode. Predvolené nie je žiadne — projekt, ktorý žiadne neuviedol, runner odmietne menom, namiesto toho, aby potichu predpokladal Claude Code.
  • settingslauncher.command len prepíše argv CLI, ktoré ste uviedli; iné CLI ním podstrčiť nejde.
Oboje je popísané na stránke Runnerarrow_forward

Potom toolchain samotného frameworku

Kontroly vyššie sú pre každý projekt rovnaké. Tieto rovnaké nie sú — hore si vyberte framework a na stránke zostane len jeho blok.

check_circle

Bez frameworku

Nič nad rámec kontrol vyššie. To je celá odpoveď, nie blok, ktorý sa nenačítal: projekt stavaný Makefilom, shellovým skriptom alebo ničím nemá žiadny frameworkový toolchain na kontrolu, takže git s originom na GitHube, Bitbucket Cloude alebo GitLabe a prihlásené kódovacie CLI sú celý zoznam.

info

bin/ci je konvencia, nie požiadavka. Keď ho projekt má, runner ho spustí; keď nie, ten krok sa preskočí. Nič na inštaláciu, nič na písanie — pokračujte na ďalšiu obrazovku.

Nainštalujte runner a spustite init

Dva kroky: A) runner na tento stroj, B) init, ktorý v projekte založí všetko ostatné — token, MCP záznam (pri Claude Code v .mcp.json), sekciu v CLAUDE.md, skills aj naplánovaný beh. Init sa na API token opýta; nájdete ho na mcptask.online → vaše meno (vpravo hore) → Zobraziť → Rozšírené informácie → API Token. Ručne nepíšete nič; komu sa binárka nehodí, má postup bez nej dole na stránke.

A

Nainštalujte runner

Jeden príkaz, ktorý za vás vybralo to, čo ste zvolili hore. Šesť frameworkov dostane správcu balíkov svojho operačného systému, Ruby on Rails namiesto neho wrapper gem a Node.js s Reactom k nemu navyše npm.

zshHomebrew
cask, nie formula — runner je jedna statická binárka, nie niečo, čo sa prekladá zo zdrojákov
brew install jchsoft/tap/mcptask_runner
výstup:==> Installing Cask mcptask_runner
výstup:🍺 mcptask_runner was successfully installed!

Binárka zatiaľ nie je podpísaná ani notarizovaná u Applu, a preto k nej Gatekeeper po stiahnutí pripne atribút com.apple.quarantine. Cask ho zmaže; bez toho by prvé spustenie skončilo bez akéhokoľvek výpisu a vyzeralo ako rozbitá binárka. Pravosť stiahnutia si overíte kontrolným súčtom SHA-256 proti checksums.txt z vydania, postup je nižšie.

Nech je kanál akýkoľvek: tých istých šesť release archívov na tag — darwin/amd64, darwin/arm64, linux/amd64, linux/arm64, windows/amd64, windows/arm64 — a to isté overenie SHA-256 proti tomu istému checksums.txt predtým, než sa čokoľvek rozbalí. Neexistuje zvláštna „windowsová reťaz dôvery“, ktorá by bola slabšia alebo silnejšia než ostatné.

B

Spustite init s voľbami, ktoré chcete

Jeden príkaz nainštaluje runner do tohto projektu. Vypísaný s voľbami, nie holý — pretože práve voľby rozhodujú, kam pôjdu automaticky založené chyby, aký režim naplánovaná úloha spúšťa a kedy.

zshinit, zodpovedaný vopred
--cli: kódovacie CLI, ktorým tento stroj poháňa projekt — claude, codex alebo opencode; povinné pri prvom init, predvolené žiadne nie je
--epic-id: Epic, do ktorého padajú chyby, ktoré runner sám založí; 0 ich nechá v koreni projektu
--epic-name: zobrazovaný názov zapísaný vedľa toho čísla, aby config hovoril, ktorý Epic to je
--mode: akú pracovnú slučku naplánovaná úloha spúšťa
--at: denný čas, kedy sa spustí; hodnota, ktorá nie je denný čas, sa odmietne, nikdy nezaokrúhli
--until: koniec vášho pracovného dňa, zapísaný do configu, kde sa dá neskôr upraviť
mcptask_runner init --cli claude --epic-id 42001 --epic-name Auto-bugs --mode today_auto_squash --at 06:30 --until 19:00

Ktorúkoľvek z nich vynechajte a init sa opýta — je to predovšetkým interaktívny inštalátor. Čo však neurobí, je hádať: --cli nemá predvolenú hodnotu, takže projekt, ktorý svoje kódovacie CLI nikdy neuviedol, sa odmietne menom, namiesto toho, aby sa predpokladal Claude Code; a neinteraktívna inštalácia (rúra, provisioning skript, na druhom konci žiadny terminál) bez --mode plánovanie ÚPLNE PRESKOČÍ, namiesto toho, aby režim zvolila za vás. --at má predvolenú hodnotu 08:00. --until nemá predvolenú hodnotu žiadnu: keď ju vynecháte, koniec dňa jednoducho nie je a runner pracuje, kým nevyčerpá kvótu.

Ďalších sedem volieb

--git-host HOSTITEĽ
Pevne určí PR hostiteľa — github, bitbucket alebo gitlab — keď sa to z URL originu vyčítať nedá: SSH alias, mirror, self-managed GitLab. Bez nej sa odvodí z git remote get-url origin. GitHub Enterprise sa odmietne menom.
--schedule
Pregeneruje naplánovanú úlohu a nič viac — skills, oprávnenia, token a sekcie v configu zostanú presne tak, ako sú.
--force
Prepíše to, čo na tomto stroji už je: skills, sekcie configu a naplánovanú úlohu.
--helper-bin-dir CESTA
Kam sa zapíšu pomocné skripty pre CI a testy. Predvolené ~/.claude/bin.
--home-dir CESTA
Presmeruje adresár s tokenom, rc súbor shellu a naplánovanú úlohu. Predvolený je vlastný domovský adresár používateľa.
--verbose
Vypisuje každý riadok streamu namiesto filtrovaného pohľadu. Sedí na koreňovom príkaze, takže platí pre každý podpríkaz.
--ignore-quota
Preskočí každú kontrolu kvóty. Tiež voľba koreňového príkazu.

Tri z nich sú to, čím je tento príkaz použiteľný z provisioning skriptu: --force, aby opakované spustenie nebola otázka, a --helper-bin-dir s --home-dir, aby build agent mohol písať inam než do domovského adresára skutočného používateľa.

Čo init nechal na disku

Nie aby vás to upokojilo — aby ste to našli. Init môžete kedykoľvek spustiť znova: každý krok je idempotentný a to, čo ste upravili ručne, zostane.

  • Skills skopírované pre vaše CLI — dvanásť pri Claude Code, deväť pri Codex CLI a OpenCode

    Claude Code dostane dvanásť do .claude/skills/: ci-runner, ci-start, ci-wait, wait-unlock, test-runner, test-start, test-wait, discover, memory-search, mcptask-read, mcptask-write a pr. Codex CLI dostane deväť do .agents/skills/ a OpenCode deväť do .claude/skills/ — rovnaký zoznam bez discover, memory-search a mcptask-read, ktoré forkujú subagenta, akého vie spustiť len Claude Code. Ku každej sa do .mcptask_runner_manifest.json zapíše MD5 hash obsahu, aby neskorší mcptask_runner update rozpoznal dodaný súbor od toho, ktorý ste upravili.

  • Pribudne jediný MCP záznam — nič ďalšie

    Pridá sa iba server mcptask-online proti https://mcptask.online/mcp, čítajúci vašu token premennú — do .mcp.json pri Claude Code, do .codex/config.toml pri Codex CLI, do opencode.json pri OpenCode. Všetky ostatné MCP servery v tom súbore zostanú presne tak, ako boli. Pri Claude Code je záznam "type": "http": stroj, ktorý už na ňom je, sa nikdy nedegraduje späť na SSE, a .mcp.json, ktorý sa nedá naparsovať, sa odmietne namiesto prepísania — --force ho najprv odsunie do .mcp.json.bak.

  • Token exportovaný pod názvom, ktorý deklaruje vaša MCP konfigurácia

    Token sa uloží pod názvom premennej, ktorý deklaruje MCP konfigurácia vášho projektu — nie pod natvrdo daným MCPTASK_TOKEN. Na Unixe sa zapíše do ~/.mcptask_env.d/ a ~/.zshenv (v bashi ~/.bash_profile a ~/.bashrc) sa naučí tento adresár sourcovať; na Windows sa uloží cez setx. Rovnakou cestou ide údaj pre Bitbucket, do ~/.mcptask_env.d/bitbucket_credentials s právami 0600 — nikdy sa neprepíše prázdnotou, nikdy sa nevypíše; na Windowse sa táto kontrola práv preskakuje. Na token, ktorý sa už podarí vyhodnotiť, sa inštalátor druhýkrát nepýta.

  • Oprávnenia nastavené pre vaše CLI, len pridávaním

    Pri Claude Code sa baseline oprávnenia zlučujú do .claude/settings.local.json striktne aditívne: allow a deny sa zjednotia s tým, čo tam už je, enableAllProjectMcpServers sa iba zapína, a všetky ostatné kľúče v súbore zostanú nedotknuté. Nič, čo ste ručne povolili alebo zakázali, sa nestratí. Tieto oprávnenia Claude Code platia len pre Claude Code: Codex CLI sa riadi súborom .codex/config.toml, ktorý init zapísal, a OpenCode súborom opencode.json s mapou oprávnení, ktorú runner vloží, pretože OpenCode nemá prepínač len na čítanie.

  • Vygenerovaný plánovaný beh, zapísané helpery a konfigurácia

    Plán sa vygeneruje pre OS, na ktorom ste — launchd LaunchAgent, systemd user timer, alebo Task Scheduler XML — aby spúšťal ~/.mcptask/bin/mcptask_runner vo všedné dni v čase, ktorý ste zvolili; príkaz na jeho aktiváciu sa vytlačí, aby ste ho spustili. Popri tom sa do ~/.claude/bin uloží deväť helper skriptov (ci_start, ci_wait, _ci_filter_tail, test_start, test_lock, check_test_lock, run_with_log, kill_tree a runner-log, ktorým sa číta log bežiaceho runnera) a do config/mcptask_runner.yml sa zapíše cieľ pre bugy a stratégia čakania.

Naplánovaná úloha sa vygeneruje a NEAKTIVUJE. Init zapíše LaunchAgent, systemd user timer alebo XML pre Task Scheduler, vypíše ten jeden príkaz, ktorý ju zapne — a tým skončí. Nič neminie ani kúsok kvóty, kým ten príkaz nespustí človek, o dve obrazovky nižšie.

Najprv sa pozrite, nič sa nezmení

once_dry je jediný režim, ktorý úplne preskočí triage: ukáže ďalšiu úlohu a skončí. Žiadna vetva, žiadny commit, žiadna kvóta — odpovedá na jedinú otázku, ktorú teraz máte: je token správny a vidí runner váš projekt?

zshúloha čaká
mcptask_runner run once_dry
výstup:TASKRUNNER_TASK_INFO:
výstup:ID: 11581
výstup:TITLE: Fix invoice numbering after the year end
výstup:DESCRIPTION: Numbering restarted at 1 instead of continuing the 2026 sequence…
výstup:END_TASK_INFO
a to je všetko — tu skončí
zshnič nečaká — tiež dobré
mcptask_runner run once_dry
výstup:TASKRUNNER_RESULT: {"status": "no_more_tasks"}

Prázdna fronta je úplne dobrý výsledok. Testujete spojenie, nehľadáte prácu — niečo priradíte neskôr, keď to bude mať zmysel.

Potom jedna úloha, vybraná vami

Stále bez rizika. --task-id osloví jednu konkrétnu položku priamo, namiesto aby prechádzal frontu — takže nezáleží na tom, komu je úloha priradená. Namierte runner na ľubovoľnú úlohu; v praxi si spravte skúšobnú a sledujte, čo sa stane.

zshmanuálny beh
mcptask_runner run task_manual --task-id 11581
výstup:[WorkLoop] Starting task #11581 — Fix invoice numbering after the year end
výstup:[WorkLoop] PR #482 opened for review: feature/11581-invoice-numbering
výstup:TASKRUNNER_RESULT: {"status": "success", "pr_number": 482, "branch_name": "feature/11581-invoice-numbering"}

--task-id je povinné pre task_manual a task_auto_squash — bez neho sa režim odmietne.

Na príkazovom riadku fungujú aj task, story a queue: sú to aliasy pre task_manual, story_manual a queue_manual, takže nikto nemusí hádať, ktorá podoba je správna.

Ako vyzerá „hotovo“: vetva, commity a pull request ponechaný otvorený na revíziu — otvorený cez mcptask_runner pr u toho hostiteľa, na ktorého smeruje origin — GitHubu, Bitbucket Cloudu alebo GitLabu. task_manual je manuálny režim — nič sa nemerguje; mergujú až varianty auto-squash, po zelenom CI. Úplná tabuľka režimov je na stránke Runner: Loop + goal

Toto je prvý príkaz na stránke, ktorý míňa skutočnú kvótu. Keď už je denná kvóta vyčerpaná, --ignore-quota kontrolu preskočí — prijatie znamená, že runner pracuje za hranicou, vedome a na váš pokyn.

Teraz naozaj: úloha na rozvrhu

Povoľte naplánovanú úlohu, raz ju spustite ručne a sledujte log. Toto je prvá obrazovka, na ktorej runner beží bez vás.

<slug> je basename adresára projektu s podčiarknutiami nahradenými pomlčkami — objavuje sa v labeli plistu, v názvoch systemd jednotiek, v názve Windows úlohy, vo wrapper skripte aj v názve logu, takže zástupný text čítate všade rovnako.

Príklad, pretože samotný zástupný text sa ľahko prečíta zle: projekt leží v ~/Projects/my_shop, basename je teda my_shop, podčiarknutie sa zmení na pomlčku a slug je my-shop. Každý riadok na tejto obrazovke čítajte s my-shop všade, kde stojí <slug>:

zshpríklad — projekt ~/Projects/my_shop, slug my-shop
príklad, nie vaše príkazy — váš slug vznikne z názvu vášho adresára:
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/online.mcptask.runner-my-shop.plist
~/.claude/bin/mcptask-runner-my-shop
a log je ~/logs/mcptask_runner/my-shop.log

Tento príklad je len informatívny — ručne nič skladať nemusíte. mcptask_runner init na konci vypíše hotové príkazy pre váš projekt, slug už doplnený a farebne zvýraznený, pripravené na skopírovanie. Obrazovky tu sú preto, aby ste spoznali, čo vám init vypísal, a vedeli, ako úlohu zase vypnúť.

zshpovoliť naplánovanú úlohu
macOS — funguje len cesta k plistu, launchctl bootout používa label:
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/online.mcptask.runner-<slug>.plist
zastaviť ju možno labelom (cesta zlyhá aj so sudo):
launchctl bootout gui/$(id -u)/online.mcptask.runner-<slug>
zshspustiť hneď, nečakať na zajtra
RunAtLoad=false a Persistent=false sú zámer — povolením úlohy sa nič nespustí. Zavolajte launcher wrapper priamo (rovnaký skript, rovnaký log, rovnaké riešenie tokenu):
~/.claude/bin/mcptask-runner-<slug>
zshsledujte log cez runner-log
runner-log sleduje najnovší beh a automaticky prepne, keď runner otvorí nový súbor — obyčajný tail -F pri prepnutí stíchne a vyzerá ako zaseknutie:
runner-log
vypísať všetky projekty a ich najnovší log:
runner-log --list
sledovať jeden projekt:
runner-log <projekt>
vypísať posledných 200 riadkov namiesto sledovania:
runner-log <projekt> -n 200
~/.claude/bin defaultne nie je v PATH — volajte absolútnou cestou (~/.../runner-log) alebo adresár pridajte do PATH. Log leží v ~/logs/mcptask_runner/<slug>.log na všetkých OS; MCPTASK_RUNNER_LOG_DIR ho presúva.

Naplánovaná úloha nikdy nenačítava váš shell profil. Token sa číta z premennej, ktorú deklaruje .mcp.json (predvolená MCPTASK_TOKEN), a v čase inštalácie sa vloží priamo do úlohy. Keď sa nič nevyhodnotí, zapíše sa doslova reťazec SET_MCPTASK_TOKEN_HERE a runner odmietne naštartovať, namiesto toho, aby bežal ako nobody.

webWeb UI

Webové rozhranie, od zajtra ďalej

Skôr než runner začne sám vyberať prácu, musia sa v prehliadači stať dve veci: zapnúť zobrazenie runneru a priradiť tickety používateľovi, ktorého API token je v .mcp.json. Prvá sprístupní grid, druhá naplní frontu.

Doteraz ste runner skúšali z terminálu: voľný pohľad, jedna úloha podľa id a potom beh bez dozoru. Webové rozhranie na to potrebné nebolo a nič sa nemuselo priraďovať, pretože --task-id oslovuje úlohu priamo. Tu prechádzate od „chcem vidieť, čo to robí“ k „takto to budem používať“.

dashboard_customize

Zapnite zobrazenie runneru

Grid runneru je za per-používateľským prvkom domovskej stránky. Bez neho sa sekcia na domovskej stránke jednoducho nezobrazí a runner vyzerá, akoby tam nebol, hoci je pripojený a čaká.

1

Otvorte Používatelia, potom Upraviť pri používateľovi, pod ktorým sa runner autentizuje.

2

Na karte Elementy na úvodnej stránke zaškrtnite v sekcii Zobraziť voľbu „Aktivita runnerov".

3

Uložte. Grid runneru sa na domovskej stránke daného používateľa objaví — prázdny, kým sa niečo nepripojí.

Grid je prázdny zámerne. Vnútri sa nič nevykreslí, kým sa runner skutočne nepripojí; „žiadna karta" na čerstvej inštalácii je očakávaný stav, nie porucha.

person

Priraďte prácu používateľovi, pod ktorým sa runner autentizuje

Fronta ponúka výhradne priradenú prácu. Nepriradený ticket je pre @next neviditeľný — nie menej prioritný, neviditeľný. Od tejto chvíle runner vyberá prácu sám a môže vybrať len to, čo mu bolo odovzdané, takže assignee ticketu musí byť používateľ, ktorého API token je v .mcp.json.

warning

Reč je o používateľovi, ktorého token je v .mcp.json — nie nutne o čitateľovi, a na zdieľanom stroji to býva často niekto iný. Keď priradíte prácu sebe, ale runner drží token kolegu, výsledkom je runner, ktorý sedí a nemá čo robiť.

visibility_off

Len priradené, nie menej prioritné

Neexistuje „nízka priorita pre nepriradené". Fronta je plochý zoznam ticketov priradených runnerovmu používateľovi; zvyšok sa v nej vôbec neobjaví. Dodatočné priradenie je oprava, nie zmena priority.

report

Tri veci, ktoré runner nezoberie

Každá z nich pri prvom kontakte vyzerá ako rozbitá inštalácia, pretože ticket existuje, je otvorený a nič sa nedeje. Spoločné vlákno: runner ticket spozná, ale považuje ho za nedozretý. Fronta robí, čo jej bolo povedané.

block
Typ ticketu: idea

Ideas runner nikdy neponúkne. Fronta runneru sú len tasky, stories a recurenty — idea sa musí najskôr povýšiť na task, aby ju runner mohol vziať.

block
Story bez subtaskov

Story, ktorá nemá žiadne tasky pod sebou, runner nikdy neponúkne. Otvorte story, pridajte aspoň jeden task a runner ju uvidí. Story s jedným subtaskom je story s jedným ticketom; to je najmenšia jednotka, ktorú fronta odošle.

block
Priradenie Story

Keď runnerovmu používateľovi priradíte story, fronta sa uzatvorí: jej subtasky opustia všeobecnú frontu a runner ide touto story. Účelné (jedna story, jeden PR, jeden squash), prekvapivé, ak ste čakali, že sa to bude správať ako task. Keď chcete, aby fronta tiekla ďalej, priraďujte task, nie story.

tips_and_updates

Nakŕmte ho niečím, čo stojí za to robiť

Runner je len taký dobrý, ako ticket, ktorý dostane. Prvý beh bez dozoru nad vágnymi ticketmi — otvorené kritériá prijatia, nedefinované „hotovo", task ktorého názov je celá feature — naučí zlú lekciu o produkte, pretože runner urobil presne to, čo ticket hovoril, a čo hovoril, nebolo nič užitočné. Napíšte ďalší task tak, ako by ste na deň jeden inštruovali nováčika.

visibilityOdmena

Sledujte to pracovať: živá karta runneru

Jediná obrazovka na tejto stránke, ktorá je obrázok — pretože vidieť kartu v pohybe je celá pointa. Všetko vyššie ste písali vy; toto je runner, ktorý odpovedá.

Mriežka runnerov na domovskej stránke mcptask.online so živou kartou runneru uprostred úlohy
Toto je mriežka runnerov na domovskej stránke. Karta je jedno živé WebSocket spojenie nesúce celé snapshoty — stav runneru, úlohu, na ktorej práve pracuje, a uplynulý čas — obnovované približne dvakrát za sekundu, kým runner beží.
schedule

Čo očakávať v čase

Medzera medzi spustením runneru a zobrazením karty je presne tam, kde väčšina ľudí usúdi, že je niečo pokazené. Nie je — karta má vlastný životný cyklus a vyzerá takto:

check_circle

Karta sa objaví behom pár sekúnd po štarte runneru. Keď je zobrazenie runnerov zapnuté a mriežka viditeľná, nič viac netreba.

check_circle

Podľa priebehu behu prechádza stavmi starting → triage → processing — stavový automat otvorene, nie schovaný za spinnerom.

check_circle

Keď slučka skončí, dokončená karta ešte 60 sekúnd zostane a potom zmizne. Karta, ktorá mizne, je runner, ktorý dobehol — nie pokazená mriežka.

check_circle

Runner spustený bez tokenu to povie — raz, nahlas, pri štarte. Nesklame potichu tým, že na mriežke proste chýba.

grid_off

Prázdna mriežka znamená jednu z dvoch vecí

Buď runner ešte nebeží — skontrolujte obrazovku s plánovačom vyššie — alebo naštartoval, ale nemohol sa pripojiť, čo by pri štarte povedal. Rozhodne to neznamená, že inštalácia zlyhala: dokončená inštalácia má mriežku na domovskej stránke, či práve niečo beží, alebo nie.

Zapojte to ručne — bez binárky

Ľubovoľný MCP-kompatibilný AI klient vie hovoriť s mcptask.online priamo. Štyri kroky, všetky len konfigurácia: získať token, deklarovať server, nasmerovať agenta na projekt, overiť.

1

Získajte svoj API token

Prihláste sa na mcptask.online, otvorte vaše meno (vpravo hore) → Zobraziť → Rozšírené informácie → API Token. Skopírujte reťazec presne tak, ako je zobrazený — je to nepriehľadné tajomstvo bez pevného prefixu aj dĺžky, takže ho nikdy neprepisujte z hlavy. Zaobchádzajte s ním ako s heslom: ktokoľvek ho má, koná za vás na mcptask.online.

Kde ho nájdete
codeKde ho nájdete
mcptask.online → vaše meno (vpravo hore) → Zobraziť → Rozšírené informácie → API Token
Príkaz v shelli
codeshell
export MCPTASK_TOKEN='<sem vložte svoj API token>'

infoNázov premennej je na vás — nič na našej strane ho nefixuje. Podstatné je, aby názov, ktorý tu exportujete, bol presne ten, ktorý váš .mcp.json dosadzuje v kroku 2. Keď sa tie dva rozídu — exportujete MCPTASK_KAMR_TOKEN, ale konfigurácia stále číta ${MCPTASK_TOKEN} — klient dosadí to, čo náhodou obsahuje tá druhá premenná, alebo prázdny reťazec. V prvom prípade sa agent prihlási ako iný používateľ a práca skončí na cudzom dashboarde; v druhom je jednoducho odmietnutý.

Čo sa práve stalo

Pridajte riadok s exportom do svojho shell profilu, aby token videl každý MCP klient, ktorého spustíte — a zapíšte ho do súboru, ktorý číta aj login shell. Token len v ~/.zshrc alebo ~/.bashrc tam je, keď otvoríte terminál, a chýba, keď rovnakú prácu spustí launchd alebo systemd user timer; súbor, ktorý prežije oboje, je ~/.zprofile (na Linuxe ~/.bash_profile alebo ~/.profile). Na Windows platí $env:MCPTASK_TOKEN len počas otvoreného okna — do používateľského prostredia, z ktorého číta Plánovač úloh, ho zapíše až setx, alebo SetEnvironmentVariable so scope User.

2

Deklarujte server mcptask-online vo svojej MCP konfigurácii

Otvorte MCP konfiguračný súbor vášho klienta — .mcp.json v koreni projektu pre Claude Code, alebo developer nastavenia Claude Desktopu — a pridajte záznam nižšie. Hlavička Authorization dosadzuje presne tú premennú, ktorú ste exportovali v kroku 1, takže ich premenujte obe, alebo ani jednu.

.mcp.json
code.mcp.json
{
  "mcpServers": {
    "mcptask-online": {
      "type": "http",
      "url": "https://mcptask.online/mcp",
      "headers": {
        "Authorization": "Bearer ${MCPTASK_TOKEN}"
      }
    }
  }
}

infoNové konfigurácie píšte ako "type": "http" proti https://mcptask.online/mcp. Staršie konfigurácie používajú "type": "sse" proti https://mcptask.online/mcp/sse — server tento zápis stále prijíma, takže existujúci SSE záznam ďalej funguje, ale je to zastaraná forma. Pre Claude Desktop vložte rovnaký záznam do jeho vlastného MCP konfiguračného súboru claude_desktop_config.json — otvorte ho z nastavení Claude Desktopu, nie z cesty, ktorú by sme sem vypísali, pretože umiestnenie súboru aj pomenovanie tej obrazovky sa líšia podľa OS a verzie.

3

Povedzte agentovi, na ktorom projekte má pracovať

Otvorte CLAUDE.md svojho projektu (alebo ekvivalentný kontextový súbor, ktorý váš AI klient číta) a pridajte sekciu nižšie. Bez nej agent nevie, ktorý projekt a účet má čítať a zapisovať — je to ľudsky čitateľný spôsob, ako získa orientáciu. Vzor nižšie je na stránke jediný, druhá varianta neexistuje; riadok s pracovnou slučkou v ňom nechajte, je to on, čo drží agenta v behu — bez neho skončí po jednej úlohe.

CLAUDE.md
codeCLAUDE.md
## mcptask.online
- Project name: <your project name>
- project_relative_id=<your project id>
- account_code: `<your account code>`

## Usage notes
- Access mcptask.online via the MCP server (key: `mcptask-online`).
- Everything is a **piece** — URIs never use `/tasks/` or `/stories/`.
- Always use `relative_id` in URLs / references, never the internal `id`.
- Read with: mcptask://pieces/{account_code}/{piece_id}
- Current user: mcptask://user (a literal URI — it takes no account code)
- Create pieces via the write tools; **content in English**.
- The work loop: load the most important task → work on it → check the daily quota → repeat.

Čo sa práve stalo

project_relative_id a account_code si prečítajte z obrazovky, neodhadujte ich podľa názvu projektu: project_relative_id je číslo v URL, keď projekt na mcptask.online otvoríte, a account_code je krátky kód pod názvom účtu v prepínači účtov. Bez tých dvoch hodnôt runner odmietne naštartovať. Nie je to varovanie, ktoré vypíše a ide ďalej — nemá účet, ktorého by sa opýtal, ani projekt, na ktorý by sa pýtal, takže skončí.

4

Overte spojenie

Reštartujte svojho AI klienta (alebo znova načítajte jeho MCP config). Položte agentovi jednu ľudskú otázku, aby ste overili, že sa na mcptask.online dostane. Ak vráti piece, ste pripojení. Ak vyhodí chybu, skočte do FAQ nižšie.

Opýtajte sa svojho agenta
codeOpýtajte sa svojho agenta
Vypíš mi ďalšiu otvorenú úlohu z môjho mcptask.online projektu.
Príkaz v shelli
codeshell
mcptask://pieces/{account_code}/@next?project_relative_id={project_relative_id}&exclude_relative_ids={exclude_relative_ids}

Čo sa práve stalo

Toto URI je kanonický vstupný bod na čítanie. Query parameter project_relative_id k nemu patrí — discovery URI je celý ten reťazec, nie len časť pred otáznikom. Ak ho agent vie načítať a vráti jednu úlohu, fungujú aj všetky ostatné piece URI.

Ako overiť, že to funguje

Tri rýchle kontroly, v poradí za sebou. Ak všetky tri prejdú, spojenie je v poriadku. Ak niektorá zlyhá, FAQ nižšie uvádza najčastejšiu príčinu.

check_circle

Agent vypíše vaše projekty

Požiadajte agenta, aby vypísal vaše projekty. Mal by vrátiť aspoň jeden riadok s názvom projektu a project_relative_id. Ak nevráti nič, token je zlý alebo v CLAUDE.md chýba account_code.

Opýtajte sa svojho agenta
Aké projekty mám na mcptask.online?
check_circle

Agent načíta ďalšiu otvorenú úlohu

Požiadajte o ďalšiu úlohu. Mal by vrátiť jeden piece s názvom, popisom a obťažnosťou (pole scrum_point). Ak nemáte žiadne otvorené úlohy, nevráti žiadny piece, ale krátku správu, že nie je čo robiť — presné znenie posiela server a môže sa líšiť. Aj tak je to v poriadku, spojenie funguje.

Opýtajte sa svojho agenta
Načítaj mi ďalšiu otvorenú úlohu.
check_circle

Agent vie prečítať konkrétnu úlohu podľa URI

Dajte mu presné URI z webového UI (otvorte ľubovoľnú úlohu, skopírujte relative_id z URL). Agent by mal vrátiť plné detaily tejto úlohy. Toto je najspoľahlivejšia end-to-end kontrola.

Opýtajte sa svojho agenta
Prečítaj mcptask://pieces/{account_code}/{piece_id} a zhrň mi to.

Časté otázky, zrozumiteľne

help_outline

Čo je MCP, ľudskou rečou?

Predstavte si MCP ako USB kábel medzi vaším kódovacím CLI a mcptask.online — runner pripojí Claude Code, Codex CLI alebo OpenCode k vašej fronte úloh, takže AI môže priamo čítať, pracovať a logovať úlohy. Samotná skratka je raz definovaná v slovníčku na stránke Integrácie pre vývojárov.

help_outline

Funguje to aj na Linuxe / Windows / serveri?

Áno — runner, .mcp.json a skills bežia na každom desktopovom OS. Plánovanie má tri reálne back-endy, nie len macOS: launchd LaunchAgent na macOS, systemd user timer na Linuxe a Task Scheduler na Windows. Na akomkoľvek inom systéme init vypíše Scheduling: skipped (no generator for ...) namiesto toho, aby hádal, a inštalácia dobehne bez plánu. Na serveri, kde nikto nie je prihlásený, systemd user timer sám nepobeží; init preto na Linuxe vypíše príkaz sudo loginctl enable-linger $USER, ktorý ho pustí aj bez prihlásenia. Iný plánovač, napríklad cron, runner nevytvára. Cesty k súborom a príkazy na zapnutie nájdete v obrazovke s behom na pozadí vyššie.

help_outline

Je bezpečné nechať runner bežať bez dozoru?

Áno, ak viete, čo ktorý režim smie. Runner beží na vašom stroji s vaším vývojovým prostredím a vývojovou databázou, takže testuje, robí screenshoty a pushuje commity ako vývojár; produkčné dáta vidí len vtedy, keď mu k nim sami dáte prístup. Zlučuje iba v režimoch *_auto_squash, a to až po prejdení lokálnych testov a CI; projekt bez CI zlúči po lokálnych testoch. Ručné režimy, napríklad queue_manual alebo task_manual, nezlúčia nikdy a iba otvoria PR na kontrolu. Keď sa agent zasekne, minie kontext alebo ho niečo preruší, harness sa zotaví a úloha skončí v PR, nezostane rozrobená. Ak runner narazí na cudziu chybu, založí na ňu vlastnú sledovanú úlohu a spracuje ju v rovnakom režime ako vašu prácu.

help_outline

Môžem inštaláciu vrátiť späť?

Áno, ale ručne — odinštalačný príkaz runner nemá. Toto všetko init zapíše:
V projekte zmažte skills — pri Claude Code dvanásť v .claude/skills/: ci-runner, ci-start, ci-wait, wait-unlock, test-runner, test-start, test-wait, discover, memory-search, mcptask-read, mcptask-write a pr; pri Codex CLI (.agents/skills/) a OpenCode (.claude/skills/) ich deväť bez discover, memory-search a mcptask-read. Ďalej .mcptask_runner_manifest.json, .claude/test-commands.json, záznam mcptask-online v .mcp.json, .codex/config.toml alebo opencode.json, oprávnenia runnera v .claude/settings.local.json a config/mcptask_runner.yml aj s jeho riadkom v .gitignore.
V domovskom adresári zmažte helper skripty a spúšťač mcptask-runner-<slug> v ~/.claude/bin, adresár ~/.mcptask_env.d/ a riadok, ktorý ho načítava, z ~/.zshenv (pri bashi z ~/.bash_profile a ~/.bashrc; na Windows premennú nastavenú cez setx).
Naplánovanú úlohu zrušíte na macOS príkazom launchctl bootout gui/$(id -u)/online.mcptask.runner-<slug> a zmazaním ~/Library/LaunchAgents/online.mcptask.runner-<slug>.plist, na Linuxe príkazom systemctl --user disable --now mcptask-runner-<slug>.timer a zmazaním .service a .timer v ~/.config/systemd/user/, na Windows príkazom schtasks /Delete /TN mcptask-runner-<slug> a zmazaním ~/.mcptask/mcptask-runner-<slug>.xml.
Binárka odíde tým istým kanálom, ktorým prišla: ručne pri install scripte, brew uninstall jchsoft/tap/mcptask_runner pre Homebrew, scoop uninstall mcptask_runner pre Scoop; npx globálne nič neinštaluje; pri Rails wrapper geme odoberte riadok mcptask-rails-runner z Gemfile a zmažte ~/.mcptask/bin.

rocket_launch

Zoberte si token a spustite inštalátor

Založte si účet na 30 dní zadarmo a získajte MCPTASK_TOKEN. Potom spustíte inštalátor a runner si vyzdvihne vašu najdôležitejšiu úlohu.

verified_user30 dní zadarmo. Bez kreditnej karty. Kedykoľvek zrušíte.