download_for_offlineRails postup

Autonomní vývojář na vašem stroji za dvě minuty

Instalace mcptask_runner do Rails projektu — jeden příkaz. Běží lokálně proti vaší reálné databázi, s modelem podle vaší volby (Claude, Kimi, DeepSeek nebo lokální ollama), a ráno usedáte k hotovým PR. Večer zadáte dobře specifikované úkoly — ráno čekají PR.

Zahájit zkušební provoz
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

Proč je tahle instalace jiná

Jiné AI agent setupy nechají uživatele skládat dílky ručně. mcptask_runner doručí celý balík jedním příkazem — a nechá vaše reálné prostředí ve smyčce.

bolt

Nulová konfigurace

Jeden rake task nakopíruje bundled skills, výchozí oprávnění, MCPTASK_TOKEN, .mcp.json záznam i macOS LaunchAgent. U jiných řešení tohle skládáte ručně.

tune

Model si vyberete vy

Runner běží nad Claude Code s jakýmkoli modelem, který nakonfigurujete. Copilot a Codex vás zamknou na svůj prémiový model; my vám necháme volbu — Claude, Kimi, DeepSeek nebo lokální ollama.

storage

Vaše reálná infrastruktura

Agent běží na vašem stroji proti vaší reálné PostgreSQL, vašim reálným system testům a vašim reálným screenshotům. Ne osekaný cloud sandbox s mockovanými daty.

check_circle

Opravdu to dokončí

Když se agent zasekne, dojde mu kontext nebo ho něco přeruší, harness se zotaví a úkol skončí v PR. Když narazí na cizí bug, založí si vlastní sledovaný úkol, opraví ho a vrátí se k vaší práci.

PR je teprve začátek

Stejný nástroj, který bere práci, ji i uzavře: od PR přes merge a automatický výkaz práce až po fakturu, kterou váš klient zaplatí. Jeden workflow od zadání po zaplacení.

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

Co potřebujete před začátkem

Tři věci — a téměř jistě je už máte.

code

Existující Rails projekt

Ruby on Rails 7+ aplikace, kterou reálně vyvíjíte. Instalátor vloží pár souborů do kořene projektu a vašeho domovského adresáře; nic dalšího nezmění.

terminal

Ruby + Bundler

Ruby 3.0+ s nainstalovaným Bundlerem. Gem mcptask_runner se napojí na váš stávající toolchain — žádné další systémové balíčky nejsou potřeba.

ruby -v && bundle -v
smart_toy

Claude Code CLI

Claude Code nainstalovaný a přihlášený v terminálu. Runner s Claude Code komunikuje; bez něj je instalace poloviční. Claude Code je harness — model pod ním si vyberete sami (Anthropic, Kimi, DeepSeek, lokální ollama…), viz konfigurace runneru.

Pět kroků k funkčnímu runneru

Každý krok je jeden krátký příkaz. Pokud chcete jen rychlý souhrn, přeskočte na rekapitulaci níže.

1

Přidejte gem mcptask_runner do Gemfile

V kořenu Rails projektu otevřete Gemfile a přidejte řádek níže. Gem je malý a cílený — nepřidá do aplikace žádné další runtime závislosti.

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

infoDáváme to do skupiny :development, protože runner je nástroj vývojářského stroje, ne serverová závislost. Produkční bundle nezatíží.

2

Spusťte bundle install

Gem se nainstaluje. Ve výstupu byste měli vidět "Installing mcptask_runner".

codeshell
bundle install
3

Spusťte instalátor

Tohle je hlavní bod. Instalátor za vás udělá nudnou přípravu: nakopíruje bundled Claude Code skills, sloučí výchozí oprávnění, vygeneruje MCPTASK_TOKEN a zapíše .mcp.json. Na macOS navíc nabídne naplánování LaunchAgentu na 08:00 ve všední dny.

codeshell
bundle exec rake mcptask_runner:install

Co se právě stalo

Budete dotázáni, který režim na macOS naplánovat: Auto squash-merge dnešních úkolů, nebo Manual dnes. Vyberte si — později lze změnit. MCPTASK_TOKEN si předem vyžádejte v Uživatel → Rozšířené informace → API Token na mcptask.online (instalátor se vás na něj také zeptá).

4

(macOS) Aktivujte plán

Instalátor na konci vypíše příkaz launchctl bootstrap. Spusťte jej jednou a runner se bude spouštět ve všední dny v 08:00. Ověříte pomocí launchctl list | grep mcptask.

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

infoUživatelé na Linuxu / serveru: instalátor stále zapíše .mcp.json a nainstaluje skills, ale NEVYTVOŘÍ LaunchAgent. Použijte cron nebo systemd. Výchozí ranní běh: 0 8 * * 1-5 cd /cesta/k/vasemu/rails && /usr/local/bin/bundle exec rake mcptask_runner:auto:squash:today >> ~/mcptask.log 2>&1. Pro večerní běh změň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

Co se právě stalo

Změna času spouštění na macOS: upravte hodnoty Hour/Minute uvnitř StartCalendarInterval v ~/Library/LaunchAgents/online.mcptask.runner-<slug>.plist, pak agenta zastavte a znovu 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ázvem adresáře vašeho projektu (podtržítka se mění na pomlčky); přesný název najdete přes ls ~/Library/LaunchAgents/ | grep mcptask-runner.

5

Vyzkoušejte jeden úkol ručně

Pro oveření funkčnosti, spusťte runner jednou ručně. Vezme nejdůležitější úkol z fronty, zpracuje ho a otevře PR. Sledujete terminál — žádný daemon, žádný odpojený proces.

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

Řekněte AI, na kterém projektu má pracovat

Claude Code magicky neví, který mcptask.online projekt nebo účet je váš. Přidejte krátkou sekci do CLAUDE.md vašeho projektu, aby od začátku četl ten správný projekt.

  • check_circleBez toho AI neví, odkud má úkoly číst ani kam je zapisovat.
  • check_circleDoplňte hodnoty VAŠÍMI údaji — název projektu, id a account code najdete v URL projektu na mcptask.online.
  • check_circleNechte to krátké — níže uvedený úryvek je vše, co runner potřebuje, aby se od prvního dne choval správně.
codeCLAUDE.md
## mcptask.online
- Project name: <název vašeho projektu>
- project_relative_id=<id vašeho projektu>
- account_code: `<váš account code>`

## Poznámky k použití
- Přistupujte k mcptask.online přes MCP server (klíč: `mcptask-online`).
- Vše je **piece** — URI nikdy nepoužívají `/tasks/` ani `/stories/`.
- V URL / odkazech vždy používejte `relative_id`, nikdy interní `id`.
- Čtení: mcptask://pieces/{account_code}/{piece_id}
- Aktuální uživatel: mcptask://user
- Pieces vytvářejte přes write nástroje; **obsah anglicky**.

Každodenní příkazy

Tyto příkazy pokrývají typický každodenní postup. Spouštíte je z kořene Rails projektu přes Bundler.

play_arrow

Vyzkoušejte jeden úkol pod dohledem

Vezme nejdůležitější dostupný úkol, zpracuje ho a otevře PR. Sledujete. Učíte se.

bundle exec rake mcptask_runner:manual:once

Nejlepší pro první běh, ladění a jednorázovou práci.

today

Pracujte na den ručně

Bere úkoly jeden za druhým, dokud nedosáhne denní kvóty. Vytváří PR, ale nechává je otevřená k vašemu posouzení.

bundle exec rake mcptask_runner:manual:today

Vhodné pro kontrolovanou denní dávku, kdy mergujete sami.

account_tree

Plný postup: recenze, pak úkoly

Nejprve zpracuje otevřené recenze PR, pak pracuje na dnešní frontě. PR zůstávají otevřená k recenzi.

bundle exec rake mcptask_runner:manual:workflow

Nejlepší pro dny s aktivní zpětnou vazbou z recenzí.

task_alt

Spusťte konkrétní úkol

Řekněte runneru přesně, který piece má zpracovat. Užitečné, když chcete známý úkol udělat jako další.

bundle exec rake mcptask_runner:manual:task[task_id]

task_id nahraďte relative_id z URL.

folder_open

Spusťte všechny úkoly v příběhu

Zpracuje každý dostupný úkol pod jedním příběhem podle priority. PR zůstávají otevřená k recenzi.

bundle exec rake mcptask_runner:manual:story[story_id]

story_id nahraďte relative_id příběhu.

Co se právě stalo po instalaci

Krátký kontrolní seznam toho, co `rake mcptask_runner:install` za vás nastavil. Pokud něco chybí, spusťte instalátor znovu — je idempotentní.

check

Skills nainstalovány do .claude/skills/

Bundled Claude Code skills (commit, pr, worktree, …) jsou zkopírovány lokálně, aby je runner mohl používat i offline.

check

Zapsán .mcp.json

Přidán MCP server entry mířící na https://mcptask.online/mcp/sse s Authorization: Bearer ${MCPTASK_TOKEN}.

check

MCPTASK_TOKEN připraven

Váš přístupový token je uložený jako proměnná prostředí, připravený pro runner i Claude Code.

check

Oprávnění sloučena do .claude/settings.local.json

Baseline Claude Code oprávnění (bezpečná sada) jsou sloučena, aby se runner nemusel ptát na každý Bash.

check

macOS LaunchAgent naplánován (08:00 ve všední dny)

Na macOS se vygeneruje LaunchAgent plist. Po spuštění vytištěného launchctl bootstrap se runner spouští automaticky každý všední den ráno.

check

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

Na Linuxu instalátor LaunchAgent přeskočí. Runner, .mcp.json a skills jsou na místě — napojte si to sami do cronu nebo systemd.

publicLibovolný systém

Nepoužíváte Rails? Připojte libovolný AI agent přes MCP

mcptask.online není jen pro Ruby on Rails. Libovolný MCP-kompatibilní AI agent — Claude Code, Claude Desktop nebo jakýkoli kompatibilní klient — může číst a zpracovávat vaše úkoly přímo. Žádný gem. Žádný Ruby. Jen malý konfigurační soubor.

Pokud váš AI klient podporuje MCP (Model Context Protocol), připojení trvá asi dvě minuty: získejte token, přidejte jeden záznam serveru a řekněte agentovi, na kterém projektu má pracovat.

Vysvětlení lidskou řečí

MCP (Model Context Protocol)

Otevřený standard, který AI klienti používají ke komunikaci s externími nástroji. Představte si to jako USB-C kabel mezi vaším AI agentem a mcptask.online — jeden standard, mnoho zařízení.

SSE (Server-Sent Events)

Streamovací transport, který mcptask.online používá k posílání aktualizací vaší AI. Jedno otevřené HTTP spojení; server posílá změny, jakmile nastanou.

Agent

Váš připojený AI klient — Claude Code, Claude Desktop nebo jakýkoli MCP-kompatibilní asistent. Agent je ten, kdo odvádí práci; mcptask.online mu dodává další úkol.

Které klienty to podporují?

Cokoli, co mluví MCP. K dnešnímu dni:

Claude Code (CLI)

Funguje

Nejlepší volba. Přidejte server do .mcp.json a Claude Code umí číst, vypisovat i vytvářet úkoly.

Claude Desktop

Funguje

Přidejte stejný záznam serveru do MCP nastavení Claude Desktopu. Stejný token, stejný endpoint.

Další MCP klienti

Funguje

Jakýkoli klient, který akceptuje standardní MCP server config (VS Code Continue, Cursor s povoleným MCP, vlastní agenti) funguje stejně.

GitHub Copilot / nástroje bez MCP

Omezeně

Copilot MCP nativně nemluví. Použijte ho jako editor kódu vedle MCP-kompatibilního agenta, nebo si vyberte klienta výše.

mcptask_runner gem je VOLITELNÝ. Je to pohodlný wrapper pro plně autonomní denní smyčku v Rails projektu. Holé MCP čtení/zápis funguje bez něj na libovolném stacku.

Čtyři kroky, bez Ruby

Vyberte si libovolný MCP-kompatibilní AI klient, projděte čtyři kroky níže a jste připojeni. Každý krok je krátký a připravený ke copy-paste.

1

Získejte MCPTASK_TOKEN

Přihlaste se na mcptask.online, otevřete Uživatel → Rozšířené informace → API Token. Zkopírujte dlouhý řetězec. To je váš MCPTASK_TOKEN. Zacházejte s ním jako s heslem — kdokoli ho má, může jednat jako vy na mcptask.online.

Kde ho najdete
codeKde ho najdete
mcptask.online → Uživatel → Rozšířené informace → API Token
Shell
codeshell
export MCPTASK_TOKEN=mcptask_xxxxxxxxxxxxxxxxxxxxxxxxxxxx

Co se právě stalo

Přidejte řádek s exportem do svého shell profilu (~/.zshrc, ~/.bashrc), aby byl token dostupný pro všechny MCP klienty, které spustíte.

2

Přidejte server mcptask-online do MCP konfigurace

Otevřete MCP konfigurační soubor vašeho klienta (např. .mcp.json v kořeni projektu pro Claude Code, nebo developer nastavení Claude Desktopu) a přidejte záznam serveru níže. Endpoint, transport i auth hlavička jsou úplně stejné, jaké zapisuje Rails instalátor — žádná překvapení.

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

infoPro Claude Desktop vložte stejný záznam do Settings → Developer → Edit Config. Přesná cesta k souboru závisí na vašem OS — Claude Desktop ji ukáže v tom samém dialogu.

3

Řekněte agentovi, na kterém projektu má pracovat

Otevřete CLAUDE.md vašeho projektu (nebo ekvivalentní kontextový soubor, který váš AI klient čte) a přidejte krátkou sekci s identitou mcptask.online. Bez ní agent neví, který projekt a účet má číst a zapisovat. Toto je lidsky čitelný způsob, jak agent získá orientaci.

Přidejte do CLAUDE.md vašeho projektu
codePřidejte do CLAUDE.md vašeho projektu
## mcptask.online
- Project name: <název vašeho projektu>
- project_relative_id=<id vašeho projektu>
- account_code: `<kód vašeho účtu>`

## Usage notes
- Přistupujte k mcptask.online přes MCP server (klíč: `mcptask-online`).
- Vše je **piece** — URI nikdy nepoužívají `/tasks/` ani `/stories/`.
- Vždy používejte `relative_id` v URL / odkazech, nikdy interní `id`.
- Čtení: mcptask://pieces/{account_code}/{piece_id}
- Aktuální uživatel: mcptask://user
- Pieces vytvářejte přes write nástroje; **obsah anglicky**.
- Pracovní smyčka: načti nejdůležitější úkol → pracuj na něm → zkontroluj denní kvótu → opakuj.

Co se právě stalo

project_relative_id a account_code najdete v URL, když otevřete svůj projekt na mcptask.online (např. mcptask.online/p/<relative_id>) a v přepínači projektů. account_code je krátký kód pod názvem účtu.

4

Ověřte spojení

Restartujte svého AI klienta (nebo znovu načtěte jeho MCP config). Položte agentovi jednu lidskou otázku, abyste ověřili, že se na mcptask.online dostane. Pokud vrátí piece, jste připojeni. Pokud vyhodí chybu, skočte do FAQ níže.

Zeptejte se svého agenta
codeZeptejte se svého agenta
Vypiš mi další otevřený úkol z mého mcptask.online projektu.
Shell
codeshell
mcptask://pieces/{account_code}/@next

Co se právě stalo

Toto URI je kanonický vstupní bod pro čtení. Pokud ho agent umí načíst a vrátí jeden úkol, fungují i všechna ostatní piece URI.

Jak ověřit, že to funguje

Tři rychlé kontroly, v pořadí za sebou. Pokud všechny tři projdou, spojení je v pořádku. Pokud některá selže, FAQ níže uvádí nejčastější příčinu.

check_circle

Agent vypíše vaše projekty

Požádejte agenta, aby vypsal vaše projekty. Měl by vrátit alespoň jeden řádek s názvem projektu a project_relative_id. Pokud nevrátí nic, token je špatně nebo v CLAUDE.md chybí account_code.

Zeptejte se svého agenta
Jaké projekty mám na mcptask.online?
check_circle

Agent načte další otevřený úkol

Požádejte o další úkol. Měl by vrátit jeden piece s názvem, popisem a obtížností. Pokud nemáte žádné otevřené úkoly, vrátí 'no available task' — to je v pořádku, spojení funguje.

Zeptejte se svého agenta
Načti mi další otevřený úkol.
check_circle

Agent umí přečíst konkrétní úkol podle URI

Dejte mu přesné URI z webového UI (otevřete libovolný úkol, zkopírujte relative_id z URL). Agent by měl vrátit plné detaily tohoto úkolu. Toto je nejspolehlivější end-to-end kontrola.

Zeptejte se svého agenta
Přečti mcptask://pieces/<account_code>/<task_id> a shrň mi to.

Časté otázky, srozumitelně

help_outline

Co je MCP, lidsky řečeno?

MCP (Model Context Protocol) je standard, jak AI asistent komunikuje s dalšími nástroji. Představte si to jako USB kabel mezi Claude Code a mcptask.online — runner připojí Claude Code k vaší frontě úkolů, takže AI může přímo číst, pracovat a logovat úkoly.

help_outline

Odkud se bere MCPTASK_TOKEN?

Uživatel → Rozšířené informace → API Token na mcptask.online. Je to dlouhý osobní přístupový token, který ověří runner jako vás. Instalátor se vás na něj během setupu zeptá a uloží ho jako proměnnou prostředí.

help_outline

Funguje to i na Linuxu / Windows / serveru?

Ano — runner, .mcp.json a skills fungují všude. Jen macOS-only je plánovač LaunchAgent: na Linuxu nebo serveru napojte stejný příkaz do cronu nebo systemd (na této stránce najdete one-liner). Na Windows použijte Task Scheduler.

help_outline

Je bezpečné nechat runner běžet přes noc?

Ano — dobře specifikovaný úkol skončí v PR. Runner běží na vašem stroji proti vaší reálné databázi, takže testuje, dělá screenshoty a pushuje commity stejně jako vy. Když se agent zasekne, dojde mu kontext nebo ho něco přeruší, harness se ZOTAVÍ a úkol skončí v PR — nezůstane viset v půlce. A pokud runner narazí na cizí bug, založí si na něj vlastní sledovaný úkol, opraví ho, sloučí a vrátí se k vaší původní práci.

help_outline

Mohu instalaci vrátit zpět?

Ano. Smažte .claude/skills/ (jen ty začínající mcptask_), odeberte mcptask-online záznam z .mcp.json a na macOS spusťte launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/com.mcptask.runner.plist. Pak odeberte gem z Gemfile. Nic dalšího to nezmění.

forward_to_inbox

Nejste vývojář? Pošlete to svému týmu

Setup zabere asi dvě minuty tomu, kdo provozuje projekt. Přepošlete tuhle stránku svému tech leadovi a autonomního vývojáře bude mít nasazeného dřív, než si udělá kafe.

arrow_forwardByznysový pohled (bez kódu)

PR je teprve začátek

Stejný nástroj, který bere práci, ji i uzavře: od PR přes merge a automatický výkaz práce až po fakturu, kterou váš klient zaplatí. Jeden workflow od zadání po zaplacení.

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

Vezměte si token a spusťte instalátor

Za dvě minuty můžete mít AI agenta, který si vyzvedne váš nejdůležitější úkol. Založte si free účet, získejte MCPTASK_TOKEN a můžete začít.

Zahájit zkušební provozRunner na GitHubu

verified_user30 dní zdarma. Bez kreditní karty. Kdykoli zrušíte. Runner je open source.