download_for_offlineRails postup

Nainštalujte mcptask_runner do svojho Rails projektu

Existujúci Ruby on Rails projekt. Jeden gem. Jeden príkaz. Zhruba dve minúty k tomu, aby si AI agent zobral prvú úlohu. Nižšie nájdete ľudsky priateľský návod — žiadny prompt pre AI, žiadne kopírovanie.

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

Č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á.

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 Nastaveniach → API Access 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/com.mcptask.runner.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 — príklad: 0 8 * * 1-5 cd /cesta/k/vasemu/rails && /usr/local/bin/bundle exec rake mcptask_runner:auto:squash:today >> ~/mcptask.log 2>&1

5

Vyskúšajte jednu úlohu ručne

Skôr než plánu dôverujete, 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

Tri príkazy pokryjú 95 % času. 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.

smart_toy

Pracujte na deň autonómne

Berie úlohy jednu za druhou, kým nedosiahne dennú kvótu. Squashne a mergne každé PR po zelenom CI. Zastaví sa pri chybe alebo dosiahnutí kvóty.

bundle exec rake mcptask_runner:auto:squash:today

Navrhnuté na spúšťanie LaunchAgentom (alebo cronom) každý všedný deň ráno.

visibility

Auto režim bez auto-merge

Rovnaké ako auto, ale NESQUASHUJE ani nemerguje. Každé PR si sami skontrolujete.

bundle exec rake mcptask_runner:auto:no_merge:today

Zvoľte, keď chcete plnú kontrolu človeka v každom kroku.

Č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ť.

Plain-language definitions

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 Nastavenia → API Access a kliknite na 'Generate 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 → Nastavenia → API Access → Generate 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.

Ask your agent
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.

Ask your agent
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.

Ask your agent
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?

Nastavenia → API Access 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. Beží vo vašom Rails projekte, s vašimi oprávneniami. Má kvótový systém, otvára PR (každá zmena je reviewovateľná) a zastaví sa pri chybe. Nič sa nezlúči bez zeleného CI, ak ste zvolili režim auto:squash:today.

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í.

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.