AI agent

Součástí Noeta je MCP server: malý program, který dá AI asistentovi možnost pracovat s vaší nástěnkou. Zeptejte se Claudea, co máte přiřazené, nechte ho sepsat chybu jako kartu, nebo přesunout hotovou věc do Hotovo.

MCP — Model Context Protocol — je standard, kterým asistenti sahají po externích nástrojích. Kromě návodu níž o něm nemusíte vědět nic.

Co umí

Vidět nástěnky	vypsat je, přečíst celou jednu, přečíst kartu i s komentáři
Hledat	napříč všemi nástěnkami — podle textu, řešitele, štítku, priority, sloupce, termínu nebo po termínu
Zakládat a měnit karty	název, popis, řešitel, priorita, termín, štítky
Přesouvat karty	do jiného sloupce nebo v rámci jednoho
Komentovat	za vás
Vidět tým	kdo v něm je

Mluvit s ním můžete běžnými slovy. Jména fungují tam, kde jsou jednoznačná — přesuň to do Hotovo, přiřaď to Anně — a když jméno sedí na dvě věci, řekne to a vypíše je, místo aby hádal.

Co záměrně neumí

• Nic mazat. Ani kartu, ani sloupec, ani nástěnku. Karta ve špatném sloupci se dá vrátit, smazaná ne.
• Zakládat nástěnky, sloupce ani štítky. Postavit nástěnku je rozhodnutí a ne takové, které se svěřuje asistentovi pracujícímu podle jedné věty.
• Opustit svůj tým. Používá přístupový token, takže je uzavřený v jednom týmu a nevydá si další.
• Sahat na soubory. Vidí, že karta přílohy má; nahrát ani přečíst je neumí.

Nastavení

1. Vydejte si přístupový token. Nastavení → Přístupové tokeny → Vytvořit token. Zkopírujte secret. Kam dosáhne, je v přístupových tokenech.

2. Nainstalujte Docker, pokud ho nemáte. Docker Desktop na macOS nebo Windows.

3. Řekněte o něm asistentovi. V Claude Code přidejte tohle do ~/.claude.json nebo do .mcp.json v projektu:

{
  "mcpServers": {
    "noeto": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "NOETO_TOKEN", "-e", "NOETO_API_URL",
               "ghcr.io/noeto-tasks/noeto-mcp:latest"],
      "env": {
        "NOETO_TOKEN": "noeto_pat_...",
        "NOETO_API_URL": "https://api.noeto.online/api/v1"
      }
    }
  }
}

Místo noeto_pat_... vložte svůj token. Restartujte asistenta a zeptejte se ho, co máte na nástěnkách.

Nic dalšího se neinstaluje. Image se stáhne poprvé a běží jen, dokud s ním mluvíte.

Kde to běží

Server běží na vašem počítači, vedle asistenta. Váš token ho neopustí a s Noetem mluví přes stejné API jako webová aplikace.

To je zároveň jeho hranice: funguje s Claude Code a s desktopovou aplikací, které umí spustit program lokálně. Claude.ai v prohlížeči a aplikace v telefonu to neumí, takže se k vaší nástěnce touhle cestou nedostanou.

Když se něco pokazí

„Přístupový token byl odmítnut.“ Byl zrušený nebo vypršel. Vydejte nový a upravte konfiguraci.

Vůbec se nedostane na Noeto. Zkontrolujte NOETO_API_URL. Pokud míříte na Noeto běžící na vlastním stroji, pozor: localhost uvnitř kontejneru znamená kontejner — použijte host.docker.internal. Server to pozná a v chybě to napíše.

Asistent nástroje nevidí. Restartujte ho. Většina hostitelů čte konfiguraci MCP jen při startu.

Máte mu to dovolit?

Jedná za vás a všechno, co udělá, je vám přičitatelné a viditelné na nástěnce — každá karta, kterou založí, každý komentář, který napíše. Vaši práci smazat neumí a token mu zrušíte jedním kliknutím.

Poctivá výhrada: asistent pracující podle jedné věty tu větu může přečíst špatně. Čtení je bezpečné. U zápisu se hodí návyk, který byste měli u nového kolegy — nechte ho pracovat a pak se na nástěnku podívejte.