TODOčko
🇬🇧

Jak napojit Claude na své úkoly přes MCP server

Aktualizováno 22. 9. 2026 pro verzi 3.1.1

MCP (Model Context Protocol) je způsob, jak dát AI asistentovi přístup k vašim datům. Server pro TODOčko běží u vás na počítači a zpřístupní asistentovi 152 nástrojů: umí zakládat a měnit úkoly, číst projekty, zapisovat odpracovaný čas nebo procházet komentáře.

Prakticky to znamená, že místo klikání napíšete „založ mi úkol na opravu přihlašování, priorita vysoká" nebo „co mi zbývá do konce týdne". Server běží lokálně, takže data putují mezi vaším počítačem a asistentem, ne přes nás.

Než to spustíte: k čemu ta fráze je

Zálohovací fráze není heslo, které jde změnit. Je to soukromý klíč ke všem vašim datům. Kdo ji má, umí rozšifrovat každý váš úkol, projekt i komentář, a my s tím nezmůžeme nic, protože u nás žádná kopie klíče neleží.

Proto ji vkládejte jedině do konfiguračního souboru na svém počítači. Nikdy ji nedávejte do příkazové řádky, kde ji zachytí historie shellu a výpis běžících procesů, a nikdy ji neposílejte v chatu ani nikam nenahrávejte.

Server běží lokálně a mluví přímo s asistentem. Vaše data tedy neprocházejí přes naše servery ani při tomhle způsobu použití.

Co budete potřebovat

  • Node.js 24.20 nebo novější. Není to formalita: databázová vrstva stojí na rozhraních, která má Node nativně teprve od verze 24.
  • Účet v TODOčku a svou 24slovnou zálohovací frázi.
  • Claude Desktop nebo Claude Code. Návod popisuje obojí.

Postup

  1. Stáhněte server

    Naklonujte repozitář, nebo si stáhněte ZIP z přehledu vydání a rozbalte ho.

    git clone https://github.com/brnt-cz/todocko-mcp.git
cd todocko-mcp

  2. Spusťte instalátor

    Instalátor nainstaluje závislosti, sestaví projekt a zeptá se, jestli chcete nastavit Claude Desktop, Claude Code nebo obojí. Na Windows použijte skript pro PowerShell.

    Linux / macOS

    chmod +x install.sh
./install.sh

    Windows (PowerShell)

    .\install.ps1

  3. Doplňte zálohovací frázi

    Instalátor vytvoří konfigurační soubor se zástupným textem místo fráze. Otevřete ho a nahraďte jej svou 24slovnou frází. Bez ní server nemá čím data rozšifrovat.

    {
  "mcpServers": {
"todocko": {
  "command": "node",
  "args": ["/cesta/k/todocko-mcp/dist/index.js"],
  "env": {
    "TODOCKO_MNEMONIC": "sem patří vaše 24slovná fráze"
  }
}
  }
}

  4. Restartujte Claude

    Konfigurace se načítá při startu, takže se změna projeví až po restartu aplikace.

  5. Ověřte, že to běží

    Zeptejte se asistenta, jaké máte projekty. Pokud odpoví seznamem z vašeho TODOčka, je hotovo.

Ruční instalace

Pokud instalátor nechcete spouštět, stačí nainstalovat závislosti, sestavit projekt a přidat server do konfigurace ručně.

npm install
npm run build

Claude Desktop hledá konfiguraci na Linuxu v adresáři s nastavením aplikace, na macOS v knihovně podpory aplikací. Claude Code čte nastavení ze svého konfiguračního souboru v domovském adresáři.

Co s tím jde dělat

Pár věcí, které se osvědčily v praxi:

  • Založit úkol z popisu, aniž byste přepínali okno.
  • Zeptat se, co je po termínu nebo co zbývá do konce sprintu.
  • Nechat si sepsat, co se za týden udělalo, podle worklogů.
  • Převést poznámky z porady na několik úkolů naráz.
  • Propojit úkoly mezi sebou, když se ukáže, že jeden blokuje druhý.

Když to nenaběhne

  • Server odmítne nastartovat a stěžuje si na neshodu mnemonicu. V databázi jsou data jiného účtu, zašifrovaná klíčem, který ten současný nemá. Smažte lokální databázi v domovském adresáři a nechte si data stáhnout znovu.
  • Asistent server nevidí. Zkontrolujte, že cesta v konfiguraci míří na sestavený soubor, ne na zdrojový, a že jste Claude po úpravě restartovali.
  • Druhá instance se odmítne spustit. To je záměr. Dvě instance nad jednou databází si navzájem berou zámek, takže druhá raději skončí, než aby rozbila tu první.

Zdrojový kód a podrobná dokumentace na GitHubu

Ještě nemáte účet?

TODOčko běží v prohlížeči, funguje offline a data si šifruje u vás. Založení je zdarma a bez karty.

Otevřít aplikaci