download_for_offlineRails postup

Autonómny vývojár na vašom stroji za dve minúty

Inštalácia mcptask_runner do Rails projektu — jeden príkaz. Beží lokálne proti vašej reálnej databáze, s modelom podľa vášho výberu (Claude, Kimi, DeepSeek alebo lokálny ollama), a ráno si sadáte k hotovým PR. Večer zadáte dobre špecifikované úlohy — ráno čakajú PR.

Spustiť skúšobnú prevádzku
terminal
mcptask_runner installer$ rake mcptask_runner:install
→ Installing skills into./.claude/skills/
→ Checking required helpers✓ ok
→ Merging permissions into.claude/settings.local.json
→ ProvisioningMCPTASK_TOKEN
→ Writing.mcp.json✓
→ macOS LaunchAgent scheduled (weekdays 08:00)✓
1 lineto install
~2 minto first task

Prečo je táto inštalácia iná

Iné AI agent setupy nechajú používateľa skladať dieliky ručne. mcptask_runner doručí celý balík jedným príkazom — a nechá vaše reálne prostredie v slučke.

bolt

Nulová konfigurácia

Jeden rake task nakopíruje bundled skills, východiskové oprávnenia, MCPTASK_TOKEN, .mcp.json záznam aj macOS LaunchAgent. Pri iných riešeniach toto skladáte ručne.

tune

Model si vyberiete vy

Runner beží nad Claude Code s akýmkoľvek modelom, ktorý nakonfigurujete. Copilot a Codex vás zamknú na svoj prémiový model; my vám necháme voľbu — Claude, Kimi, DeepSeek alebo lokálny ollama.

storage

Vaša reálna infraštruktúra

Agent beží na vašom stroji proti vašej reálnej PostgreSQL, vašim reálnym system testom a vašim reálnym screenshotom. Nie osekaný cloud sandbox s mockovanými dátami.

check_circle

Naozaj to dokončí

Keď sa agent zasekne, minie kontext alebo ho niečo preruší, harness sa zotaví a úloha skončí v PR. Keď narazí na cudzí bug, založí si vlastný sledovaný úkol, opraví ho a vráti sa k vašej práci.

PR je len začiatok

Rovnaký nástroj, ktorý berie prácu, ju aj uzavrie: od PR cez merge a automatický výkaz práce až po faktúru, ktorú váš klient zaplatí. Jeden workflow od zadania po zaplatenie.

terminal
PR ready
receipt_long
Timesheet logged
merge
Auto-merged
handshake
Invoice sent
paid
Paid

Čo potrebujete pred začiatkom

Tri veci — a takmer iste ich už máte.

code

Existujúci Rails projekt

Ruby on Rails 7+ aplikácia, ktorú reálne vyvíjate. Inštalátor vloží pár súborov do koreňa projektu a vášho domovského adresára; nič iné nezmení.

terminal

Ruby + Bundler

Ruby 3.0+ s nainštalovaným Bundlerom. Gem mcptask_runner sa napojí na váš existujúci toolchain — žiadne ďalšie systémové balíčky nie sú potrebné.

ruby -v && bundle -v
smart_toy

Claude Code CLI

Claude Code nainštalovaný a prihlásený v termináli. Runner s Claude Code komunikuje; bez neho je inštalácia polovičná. Claude Code je harness — model pod ním si vyberiete sami (Anthropic, Kimi, DeepSeek, lokálny ollama…), viz konfigurácia runneru.

Päť krokov k funkčnému runneru

Každý krok je jeden krátky príkaz. Ak chcete len rýchly súhrn, preskočte na rekapituláciu nižšie.

1

Pridajte gem mcptask_runner do Gemfile

V koreni Rails projektu otvorte Gemfile a pridajte riadok nižšie. Gem je malý a cielený — nepridá do aplikácie žiadne ďalšie runtime závislosti.

codeshell
# Gemfile
group :development do
  gem "mcptask_runner", github: "jchsoft/mcptask_runner"
end

infoDávame to do skupiny :development, pretože runner je nástroj vývojárskeho stroja, nie serverová závislosť. Produkčný bundle nezaťaží.

2

Spustite bundle install

Gem sa nainštaluje. Vo výstupe by ste mali vidieť "Installing mcptask_runner".

codeshell
bundle install
3

Spustite inštalátor

Toto je hlavný bod. Inštalátor za vás urobí nudnú prípravu: nakopíruje bundled Claude Code skills, zlúči východiskové oprávnenia, vygeneruje MCPTASK_TOKEN a zapíše .mcp.json. Na macOS navyše ponúkne naplánovanie LaunchAgentu na 08:00 vo všedné dni.

codeshell
bundle exec rake mcptask_runner:install

Čo sa práve stalo

Budete dotázaní, ktorý režim na macOS naplánovať: Auto squash-merge dnešných úloh, alebo Manual dnes. Vyberte si — neskôr sa dá zmeniť. MCPTASK_TOKEN si vopred vyžiadajte v Používateľ → Rozšírené informácie → API Token na mcptask.online (inštalátor sa vás naň tiež opýta).

4

(macOS) Aktivujte plán

Inštalátor na konci vypíše príkaz launchctl bootstrap. Spustite ho raz a runner sa bude spúšťať vo všedné dni o 08:00. Overíte pomocou launchctl list | grep mcptask.

codeshell
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/online.mcptask.runner-<slug>.plist

infoPoužívatelia na Linuxe / serveri: inštalátor stále zapíše .mcp.json a nainštaluje skills, ale NEVYTVORÍ LaunchAgent. Použite cron alebo systemd. Predvolený ranný beh: 0 8 * * 1-5 cd /cesta/k/vasemu/rails && /usr/local/bin/bundle exec rake mcptask_runner:auto:squash:today >> ~/mcptask.log 2>&1. Pre večerný beh zmeňte cron výraz: 0 22 * * 1-5 cd /cesta/k/vasemu/rails && /usr/local/bin/bundle exec rake mcptask_runner:auto:squash:today >> ~/mcptask.log 2>&1

Čo sa práve stalo

Zmena času spúšťania na macOS: upravte hodnoty Hour/Minute vo vnútri StartCalendarInterval v ~/Library/LaunchAgents/online.mcptask.runner-<slug>.plist, potom agenta zastavte a znova nahrajte: launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/online.mcptask.runner-<slug>.plist && launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/online.mcptask.runner-<slug>.plist. <slug> nahraďte názvom adresára vášho projektu (podčiarkovníky sa menia na pomlčky); presný názov nájdete cez ls ~/Library/LaunchAgents/ | grep mcptask-runner.

5

Vyskúšajte jednu úlohu ručne

Pre overenie funkčnosti, spustite runner raz ručne. Zoberie najdôležitejšiu úlohu z fronty, spracuje ju a otvorí PR. Sledujete terminál — žiadny daemon, žiadny odpojený proces.

codeshell
bundle exec rake mcptask_runner:manual:once
descriptionPovinný krok

Povedzte AI, na ktorom projekte má pracovať

Claude Code magicky nevie, ktorý mcptask.online projekt alebo účet je váš. Pridajte krátku sekciu do CLAUDE.md vášho projektu, aby od začiatku čítal ten správny projekt.

  • check_circleBez toho AI nevie, odkiaľ má úlohy čítať ani kam ich zapisovať.
  • check_circleDoplňte hodnoty VAŠIMI údajmi — názov projektu, id a account code nájdete v URL projektu na mcptask.online.
  • check_circleNechajte to krátke — nižšie uvedený úryvok je všetko, čo runner potrebuje, aby sa od prvého dňa správal správne.
codeCLAUDE.md
## mcptask.online
- Project name: <názov vášho projektu>
- project_relative_id=<id vášho projektu>
- account_code: `<váš account code>`

## Poznámky k použitiu
- Pristupujte k mcptask.online cez MCP server (kľúč: `mcptask-online`).
- Všetko je **piece** — URI nikdy nepoužívajú `/tasks/` ani `/stories/`.
- V URL / odkazoch vždy používajte `relative_id`, nikdy interné `id`.
- Čítanie: mcptask://pieces/{account_code}/{piece_id}
- Aktuálny používateľ: mcptask://user
- Pieces vytvárajte cez write nástroje; **obsah anglicky**.

Každodenné príkazy

Tieto príkazy pokrývajú typický každodenný postup. Spúšťate ich z koreňa Rails projektu cez Bundler.

play_arrow

Vyskúšajte jednu úlohu pod dohľadom

Zoberie najdôležitejšiu dostupnú úlohu, spracuje ju a otvorí PR. Sledujete. Učíte sa.

bundle exec rake mcptask_runner:manual:once

Najlepšie pre prvý beh, ladenie a jednorazovú prácu.

today

Pracujte na deň ručne

Berie úlohy jednu za druhou, kým nedosiahne dennú kvótu. Vytvára PR, ale necháva ich otvorené na vaše posúdenie.

bundle exec rake mcptask_runner:manual:today

Vhodné pre kontrolovanú dennú dávku, keď mergujete sami.

account_tree

Plný postup: recenzie, potom úlohy

Najprv spracuje otvorené recenzie PR, potom pracuje na dnešnej fronte. PR zostávajú otvorené na recenziu.

bundle exec rake mcptask_runner:manual:workflow

Najlepšie pre dni s aktívnou spätnou väzbou z recenzií.

task_alt

Spustite konkrétnu úlohu

Povedzte runnerovi presne, ktorý piece má spracovať. Užitočné, keď chcete známu úlohu urobiť ako ďalšiu.

bundle exec rake mcptask_runner:manual:task[task_id]

task_id nahraďte relative_id z URL.

folder_open

Spustite všetky úlohy v príbehu

Spracuje každú dostupnú úlohu pod jedným príbehom podľa priority. PR zostávajú otvorené na recenziu.

bundle exec rake mcptask_runner:manual:story[story_id]

story_id nahraďte relative_id príbehu.

Čo sa práve stalo po inštalácii

Krátky kontrolný zoznam toho, čo `rake mcptask_runner:install` za vás nastavil. Ak niečo chýba, spustite inštalátor znova — je idempotentný.

check

Skills nainštalované do .claude/skills/

Bundled Claude Code skills (commit, pr, worktree, …) sú skopírované lokálne, aby ich runner mohol používať aj offline.

check

Zapísaný .mcp.json

Pridaný MCP server entry smerujúci na https://mcptask.online/mcp/sse s Authorization: Bearer ${MCPTASK_TOKEN}.

check

MCPTASK_TOKEN pripravený

Váš prístupový token je uložený ako premenná prostredia, pripravený pre runner aj Claude Code.

check

Oprávnenia zlúčené do .claude/settings.local.json

Baseline Claude Code oprávnenia (bezpečná sada) sú zlúčené, aby sa runner nemusel pýtať na každý Bash.

check

macOS LaunchAgent naplánovaný (08:00 vo všedné dni)

Na macOS sa vygeneruje LaunchAgent plist. Po spustení vytlačeného launchctl bootstrap sa runner spúšťa automaticky každý všedný deň ráno.

check

Linux/server: bez plánovača, ale runner funguje

Na Linuxe inštalátor LaunchAgent preskočí. Runner, .mcp.json a skills sú na mieste — napojte si to sami do cronu alebo systemd.

publicĽubovoľný systém

Nepoužívate Rails? Pripojte ľubovoľný AI agent cez MCP

mcptask.online nie je len pre Ruby on Rails. Ľubovoľný MCP-kompatibilný AI agent — Claude Code, Claude Desktop alebo akýkoľvek kompatibilný klient — môže čítať a spracovávať vaše úlohy priamo. Žiadny gem. Žiadny Ruby. Len malý konfiguračný súbor.

Ak váš AI klient podporuje MCP (Model Context Protocol), pripojenie trvá asi dve minúty: získajte token, pridajte jeden záznam serveru a povedzte agentovi, na ktorom projekte má pracovať.

Vysvetlenie ľudskou rečou

MCP (Model Context Protocol)

Otvorený štandard, ktorý AI klienti používajú na komunikáciu s externými nástrojmi. Predstavte si to ako USB-C kábel medzi vaším AI agentom a mcptask.online — jeden štandard, mnoho zariadení.

SSE (Server-Sent Events)

Streamovací transport, ktorý mcptask.online používa na posielanie aktualizácií vašej AI. Jedno otvorené HTTP spojenie; server posiela zmeny, hneď ako nastanú.

Agent

Váš pripojený AI klient — Claude Code, Claude Desktop alebo akýkoľvek MCP-kompatibilný asistent. Agent je ten, kto odvádza prácu; mcptask.online mu dodáva ďalšiu úlohu.

Ktoré klienty to podporujú?

Čokoľvek, čo hovorí MCP. K dnešnému dňu:

Claude Code (CLI)

Funguje

Najlepšia voľba. Pridajte server do .mcp.json a Claude Code vie čítať, vypisovať aj vytvárať úlohy.

Claude Desktop

Funguje

Pridajte rovnaký záznam serveru do MCP nastavení Claude Desktopu. Rovnaký token, rovnaký endpoint.

Ďalší MCP klienti

Funguje

Akýkoľvek klient, ktorý akceptuje štandardný MCP server config (VS Code Continue, Cursor s povoleným MCP, vlastní agenti) funguje rovnako.

GitHub Copilot / nástroje bez MCP

Obmedzene

Copilot MCP natívne nehovorí. Použite ho ako editor kódu vedľa MCP-kompatibilného agenta, alebo si vyberte klienta vyššie.

mcptask_runner gem je VOLITEĽNÝ. Je to pohodlný wrapper pre plne autonómnu dennú slučku v Rails projekte. Holé MCP čítanie/zápis funguje bez neho na ľubovoľnom stacku.

Štyri kroky, bez Ruby

Vyberte si ľubovoľný MCP-kompatibilný AI klient, prejdite štyri kroky nižšie a ste pripojení. Každý krok je krátky a pripravený na copy-paste.

1

Získajte MCPTASK_TOKEN

Prihláste sa na mcptask.online, otvorte Používateľ → Rozšírené informácie → API Token. Skopírujte dlhý reťazec. To je váš MCPTASK_TOKEN. Zaobchádzajte s ním ako s heslom — ktokoľvek ho má, môže konať ako vy na mcptask.online.

Kde ho nájdete
codeKde ho nájdete
mcptask.online → Používateľ → Rozšírené informácie → API Token
Shell
codeshell
export MCPTASK_TOKEN=mcptask_xxxxxxxxxxxxxxxxxxxxxxxxxxxx

Čo sa práve stalo

Pridajte riadok s exportom do svojho shell profilu (~/.zshrc, ~/.bashrc), aby bol token dostupný pre všetkých MCP klientov, ktorých spustíte.

2

Pridajte server mcptask-online do MCP konfigurácie

Otvorte MCP konfiguračný súbor vášho klienta (napr. .mcp.json v koreni projektu pre Claude Code, alebo developer nastavenia Claude Desktopu) a pridajte záznam serveru nižšie. Endpoint, transport aj auth hlavička sú úplne rovnaké, aké zapisuje Rails inštalátor — žiadne prekvapenia.

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

infoPre Claude Desktop vložte rovnaký záznam do Settings → Developer → Edit Config. Presná cesta k súboru závisí od vášho OS — Claude Desktop ju ukáže v tom istom dialógu.

3

Povedzte agentovi, na ktorom projekte má pracovať

Otvorte CLAUDE.md vášho projektu (alebo ekvivalentný kontextový súbor, ktorý váš AI klient číta) a pridajte krátku sekciu s identitou mcptask.online. Bez nej agent nevie, ktorý projekt a účet má čítať a zapisovať. Toto je ľudsky čitateľný spôsob, ako agent získa orientáciu.

Pridajte do CLAUDE.md vášho projektu
codePridajte do CLAUDE.md vášho projektu
## mcptask.online
- Project name: <názov vášho projektu>
- project_relative_id=<id vášho projektu>
- account_code: `<kód vášho účtu>`

## Usage notes
- Pristupujte k mcptask.online cez MCP server (kľúč: `mcptask-online`).
- Všetko je **piece** — URI nikdy nepoužívajú `/tasks/` ani `/stories/`.
- Vždy používajte `relative_id` v URL / odkazoch, nikdy interné `id`.
- Čítanie: mcptask://pieces/{account_code}/{piece_id}
- Aktuálny používateľ: mcptask://user
- Pieces vytvárajte cez write nástroje; **obsah anglicky**.
- Pracovná slučka: načítaj najdôležitejšiu úlohu → pracuj na nej → skontroluj dennú kvótu → opakuj.

Čo sa práve stalo

project_relative_id a account_code nájdete v URL, keď otvoríte svoj projekt na mcptask.online (napr. mcptask.online/p/<relative_id>) a v prepínači projektov. account_code je krátky kód pod názvom účtu.

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.
Shell
codeshell
mcptask://pieces/{account_code}/@next

Čo sa práve stalo

Toto URI je kanonický vstupný bod na čítanie. 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. Ak nemáte žiadne otvorené úlohy, vráti 'no available task' — to je 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>/<task_id> a zhrň mi to.

Časté otázky, zrozumiteľne

help_outline

Čo je MCP, ľudskou rečou?

MCP (Model Context Protocol) je štandard, ako AI asistent komunikuje s ďalšími nástrojmi. Predstavte si to ako USB kábel medzi Claude Code a mcptask.online — runner pripojí Claude Code k vašej fronte úloh, takže AI môže priamo čítať, pracovať a logovať úlohy.

help_outline

Odkiaľ sa berie MCPTASK_TOKEN?

Používateľ → Rozšírené informácie → API Token na mcptask.online. Je to dlhý osobný prístupový token, ktorý overí runner ako vás. Inštalátor sa vás naň počas setupu opýta a uloží ho ako premennú prostredia.

help_outline

Funguje to aj na Linuxe / Windows / serveri?

Áno — runner, .mcp.json a skills fungujú všade. Len macOS-only je plánovač LaunchAgent: na Linuxe alebo serveri napojte rovnaký príkaz do cronu alebo systemd (na tejto stránke nájdete one-liner). Na Windows použite Task Scheduler.

help_outline

Je bezpečné nechať runner bežať cez noc?

Áno — dobre špecifikovaná úloha skončí v PR. Runner beží na vašom stroji proti vašej reálnej databáze, takže testuje, robí screenshoty a pushuje commity rovnako ako vy. Keď sa agent zasekne, minie kontext alebo ho niečo preruší, harness sa ZOTAVÍ a úloha skončí v PR — nezostane visieť v polovici. A ak runner narazí na cudzí bug, založí si naň vlastný sledovaný úkol, opraví ho, zlúči a vráti sa k vašej pôvodnej práci.

help_outline

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

Áno. Zmažte .claude/skills/ (len tie začínajúce mcptask_), odoberte mcptask-online záznam z .mcp.json a na macOS spustite launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/com.mcptask.runner.plist. Potom odoberte gem z Gemfile. Nič iné to nezmení.

forward_to_inbox

Nie ste vývojár? Pošlite to svojmu tímu

Setup trvá asi dve minúty tomu, kto prevádzkuje projekt. Prepošlite túto stránku svojmu tech leadovi a autonómneho vývojára bude mať nasadeného skôr, než si urobí kávu.

arrow_forwardBiznis pohľad (bez kódu)

PR je len začiatok

Rovnaký nástroj, ktorý berie prácu, ju aj uzavrie: od PR cez merge a automatický výkaz práce až po faktúru, ktorú váš klient zaplatí. Jeden workflow od zadania po zaplatenie.

terminal
PR ready
receipt_long
Timesheet logged
merge
Auto-merged
handshake
Invoice sent
paid
Paid
rocket_launch

Zoberte si token a spustite inštalátor

O dve minúty môžete mať AI agenta, ktorý si vyzdvihne vašu najdôležitejšiu úlohu. Založte si free účet, získajte MCPTASK_TOKEN a môžete začať.

Spustiť skúšobnú prevádzkuRunner na GitHube

verified_user30 dní zadarmo. Bez kreditnej karty. Kedykoľvek zrušíte. Runner je open source.