download_for_offlineRails postup

Nainstalujte mcptask_runner do svého Rails projektu

Existující Ruby on Rails projekt. Jeden gem. Jeden příkaz. Zhruba dvě minuty k tomu, aby si AI agent vzal první úkol. Níže najdete lidsky přátelský návod — žádný prompt pro AI, žádné kopírování.

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

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

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 Nastavení → API Access 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/com.mcptask.runner.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 — pří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

Vyzkoušejte jeden úkol ručně

Než plánu důvěřujete, 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

Tři příkazy pokryjí 95 % času. 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.

smart_toy

Pracujte na den autonomně

Bere úkoly jeden za druhým, dokud nedosáhne denní kvóty. Squashne a mergne každé PR po zeleném CI. Zastaví se při chybě nebo dosažení kvóty.

bundle exec rake mcptask_runner:auto:squash:today

Navrženo pro spouštění LaunchAgentem (nebo cronem) každý všední den ráno.

visibility

Auto režim bez auto-merge

Stejné jako auto, ale NESQUASHUJE ani nemerguje. Každé PR si sami zkontrolujete.

bundle exec rake mcptask_runner:auto:no_merge:today

Zvolte, když chcete plnou kontrolu člověkem v každém kroku.

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.

Plain-language definitions

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 Nastavení → API Access a klikněte na 'Generate 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 → Nastavení → API Access → Generate 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.

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

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

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

Nastavení → API Access 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. Běží ve vašem Rails projektu, s vašimi oprávněními. Má kvótový systém, otevírá PR (každá změna je reviewovatelná) a zastaví se při chybě. Nic se nesloučí bez zeleného CI, pokud jste zvolili režim auto:squash:today.

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

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.