Agenti a MCP

Co jsou agenti a MCP

AI agent je asistent, třeba Claude Desktop nebo Claude Code, který pro tebe umí něco udělat, nejen odpovídat v chatu. MCP (Model Context Protocol) je otevřený standard, přes který se agent připojí k jiné aplikaci a pracuje s jejími daty. Letos má vlastní MCP server zabudovaný v desktopové aplikaci.

Díky tomu se agenta můžeš ptát normálně: „Co mám tenhle týden na stole?“, „Rozděl mi cíl na kroky.“, „Na který nepřečtený e-mail musím odpovědět?“ Agent si v Letos přečte úkoly, cíle, kalendář a poštu. Když mu to dovolíš, založí úkol nebo uloží koncept e-mailu.

• Server běží jen na tvém počítači: poslouchá na adrese 127.0.0.1 (výchozí port 47800, cesta /mcp). Z jiného počítače ani z internetu se k němu nedá připojit.
• Agent pracuje nad stejnou lokální databází jako aplikace. Nic neprochází naším serverem.
• Číst smí hned po přidání. Zápisy jsou ve výchozím stavu vypnuté.
• Nic se nikdy nemaže a e-mail se odešle až po tvém potvrzení v aplikaci.

Lokální MCP je v desktopové aplikaci. Na iPhonu není.

Rychlý start: Claude Desktop a Claude Code

1. Otevři Nastavení → Agenti.
2. Zapni Povolit agenty (MCP). Poprvé se ukáže souhlas Odeslat data mimo zařízení: co agenti uvidí (pošta, úkoly, cíle, kalendář, poznámky) a že to agent může poslat svému poskytovateli. Server naběhne až po Povolit.
3. V sekci Agenti s přístupem klikni na Přidat agenta. Zadej název (třeba „Claude Desktop“) a vyber Čtení, Zápis nebo Čtení i zápis. Začni se Čtením.
4. Zkopíruj token a nastavení klienta, které se ukážou. Uvidíš je jen jednou.
5. Připoj klienta (viz níže), restartuj ho a zkus jednoduchý pokyn: „Vypiš moje dnešní úkoly.“

Letos musí běžet a agenti musí být povolení. Vypnutím přepínače souhlas odvoláš a server se hned zastaví. Totéž jde v Nastavení → Soukromí.

Claude Code

Claude Code se připojí přímo přes HTTP. Klikni na Kopírovat příkaz Claude Code a spusť ho v terminálu:

claude mcp add --transport http letos http://127.0.0.1:47800/mcp --header "Authorization: Bearer <token agenta>"

Příkaz s tokenem ber jako tajný. Když agentovi vydáš nový token, spusť příkaz znovu. Pokud jsi změnil port, uprav ho v adrese.

Claude Desktop

Claude Desktop spouští příkaz letos mcp, který jen přeposílá komunikaci do běžící aplikace. Token dostane v proměnné LETOS_MCP_TOKEN. Vlož tento blok do souboru claude_desktop_config.json (na macOS v ~/Library/Application Support/Claude/), nebo klikni na Kopírovat nastavení Claude Desktop, které cestu pro tvůj počítač doplní samo:

{
  "mcpServers": {
    "letos": {
      "command": "/Applications/Letos.app/Contents/MacOS/letos",
      "args": ["mcp"],
      "env": { "LETOS_MCP_TOKEN": "<token agenta>" }
    }
  }
}

Pak Claude Desktop restartuj. Bez LETOS_MCP_TOKEN si letos mcp vezme původní sdílený token ze souboru, pokud existuje.

Jiní klienti

Jakýkoli MCP klient, který umí HTTP transport, se připojí na adresu z Nastavení → Agenti s hlavičkou Authorization: Bearer <token agenta>.

Připojení přes internet

Připravujeme Připojení přes internet zatím není dostupné. Dokud nevyjde přihlašovací konektor (OAuth), používej místní připojení výše.

Plán: agenti, kteří běží v cloudu (třeba Claude na webu), se připojí k tvému webovému účtu s plánem Plus nebo vyšším. Omezená varianta už existuje: cloudový koncový bod s vlastním tokenem (začíná na lmcp_), který vidí jen úkoly, cíle a kalendář. Nemá poštu ani vyhledávání a zatím není otevřený všem. Limity má stejné nebo vyšší než místní. Až bude hotový, napíšeme to sem i do Nastavení.

Agenti v cloudu

Agenta můžeš připojit i k Letos na webu — bez ohledu na to, na kterém počítači zrovna jsi. Nepoužívá se k tomu žádná aplikace v počítači: agent se připojí přímo na adresu https://app.letos.app/api/mcp a ověří se tokenem, který si vytvoříš v Nastavení.

Cloudové agenty mají plán Plus a Unlimited. Free vidí jen nabídku ke změně plánu.

• Agent pracuje s úkoly, cíli a kalendářem. Poštu web nemá, takže k ní agent v cloudu nemá přístup vůbec.
• Zápisy jsou ve výchozím stavu vypnuté a každý nový token smí jen číst. Zápis povolíš u konkrétního tokenu.
• Data tečou mezi agentem a naším serverem, ne mezi tvým počítačem a agentem. Co s nimi agent udělá dál, řídí podmínky jeho poskytovatele.

Založení tokenu

1. Otevři Nastavení → Agenti.
2. V sekci Přístupové tokeny zadej Název tokenu (např. „Claude Code na notebooku“) a klikni na Vytvořit token.
3. Zkopíruj token, který se ukáže — uvidíš ho jen jednou. Letos si ukládá jen jeho otisk.
4. Vlož ho do nastavení agenta. Pro Claude Code:

claude mcp add --transport http letos https://app.letos.app/api/mcp --header "Authorization: Bearer <token>"

Oprávnění tokenu

Každý token má vlastní oprávnění, které můžeš kdykoli změnit tlačítkem Upravit oprávnění:

Oprávnění	Co smí
Čtení	Jen čte úkoly, cíle a kalendář. Výchozí stav nového tokenu.
Zápis	Jen zakládá a upravuje (nikdy nemaže) — nesmí číst: nástroje pro čtení má token zakázané a nevidí je. Pokud agent potřebuje i vyhledávat, zvol Čtení i zápis.
Čtení i zápis	Obojí.

Pod Rozšířené… navíc omezíš token na vybrané moduly (Úkoly, Cíle, Kalendář). Agent pak ostatní moduly vůbec neuvidí — ani je nemůže zavolat. Změna platí od dalšího požadavku agenta.

Zápisy navíc potřebují zapnutý přepínač Povolit zápisy. Dokud je vypnutý, nezapisuje žádný token: token Čtení i zápis pak jen čte a token Zápis nemůže nic.

Zrušení tokenu

Zrušit token okamžitě odpojí daného agenta — jeho další požadavek skončí chybou 401. Token se zobrazuje i s datem vytvoření a posledního použití, takže poznáš, který je nepoužívaný.

Když token ztratíš nebo ho omylem zveřejníš, prostě ho zruš a vytvoř nový.

Limity a záznam

Limit	Plus	Unlimited
Čtení	nejvýše 60 za minutu	nejvýše 120 za minutu
Zápisy	nejvýše 10 za minutu a 200 za den	nejvýše 20 za minutu a 1000 za den
Změny synchronizované do ostatních zařízení	nejvýše 60 za hodinu	nejvýše 120 za hodinu

V Nastavení → Agenti → Záznam aktivity vidíš každé volání cloudového agenta: čas, klienta, nástroj a výsledek — i odmítnutá volání. Záznam se drží 30 dní (nejvýše 5000 řádků) a argumenty jsou v něm zkrácené, bez obsahu úkolů a poznámek.

Co smí agent, limity a souhlasy

Smí

• Číst úkoly, cíle, události v kalendáři a poštu (jako text, přílohy jen jako název, typ a velikost).
• S oprávněním k zápisu a zapnutým Povolit zápisy: zakládat a upravovat úkoly, dokončit úkol, přidat krok k cíli, založit událost v tvém kalendáři (bez hostů), archivovat nebo odložit vlákno pošty, uložit koncept.
• Požádat o odeslání konceptu. Odejde až po tvém potvrzení.

Nesmí

• Nic mazat, dělat hromadné operace, měnit nastavení, účty, synchronizaci ani tokeny jiných agentů.
• Zvát hosty ani nic odeslat bez tvého potvrzení.
• Měnit kategorii cíle ani vazby úkolů na cíl.

Souhlasy a vypínače

Nastavení	Co dělá
Povolit agenty (MCP)	Hlavní vypínač a souhlas. Vypnuto = server neběží, žádný přístup.
Oprávnění agenta	Čtení / Zápis / Čtení i zápis, volitelně jen vybrané moduly z Pošta, Kalendář, Úkoly, Cíle (pod Rozšířené…).
Povolit zápisy	Vypnuto (výchozí) = žádný agent nezapisuje, ani s oprávněním k zápisu.
Odvolat / Nový token	Okamžitě odpojí jednoho agenta. Nový token zneplatní starý.

Limity (pevné, nejdou zvýšit)

Limit	Hodnota
Čtení	nejvýše 60 za minutu
Zápisy	nejvýše 10 za minutu a 200 za 24 hodin, vždy jen jeden najednou
Změny synchronizované do tvých dalších zařízení	nejvýše 60 za hodinu (jeden zápis může znamenat víc změn, např. dokončení kroku cíle)
Odeslání e-mailu	nejvýše 20 za 24 hodin, každé až po tvém potvrzení
Velikost požadavku	nejvýše 256 KB
Položek na stránku výsledků	výchozí 25, nejvýše 50

Když agent limit překročí, server odpoví chybou 429 a řekne mu, za kolik sekund to může zkusit znovu.

Odeslání e-mailu agentem

Když agent chce poslat e-mail, Letos ukáže okno Agent chce odeslat e-mail s odesílatelem, příjemci, předmětem, začátkem zprávy, délkou a názvy příloh. Máš 120 sekund na Odeslat nebo Zamítnout. Bez odpovědi se e-mail neodešle.

Správa agentů

• Každý agent má vlastní token a oprávnění. Bez platného tokenu server každý požadavek odmítne.
• Upravit změní oprávnění a moduly od dalšího požadavku agenta. Nový token vydá nový a starý přestane fungovat. Odvolat agenta odpojí. Obojí se potvrzuje.
• Seznam ukazuje, kdy byl agent vytvořen a kdy se naposledy připojil.
• Pokud jsi agenty používal před zavedením vlastních tokenů, starý token ze souboru mcp/token se převedl na agenta s tímto názvem a plným přístupem.
• Tokeny mají 64 znaků, nevyprší a nesynchronizují se na tvoje další zařízení.

Bezpečnost

• Jen tento počítač. Server přijme jen požadavky adresované na 127.0.0.1:<port> nebo localhost:<port> a odmítne každý požadavek z webového prohlížeče. Webová stránka na něj tedy nedosáhne ani oklikou.
• Token je povinný a porovnává se tak, aby z odpovědi nešlo nic odhadnout.
• Seznam povolených akcí. Každý nástroj smí volat jen předem dané vnitřní funkce aplikace. Mazání, hromadné operace, nastavení a účty mezi nimi nejsou.
• Bezpečné výchozí hodnoty. Zápisy jsou vypnuté. Kdyby se uložené nastavení poškodilo, server ho bere jako vypnuté.
• Záznam aktivity. V Nastavení → Agenti → Záznam aktivity vidíš každé volání: čas, klienta, nástroj a výsledek. Drží se 30 dní (nejvýše 5000 řádků). Argumenty se ukládají zkrácené a bez obsahu e-mailů, poznámek a hledaných výrazů.
• Pozor na vložené pokyny (prompt injection). Agent čte i texty od jiných lidí, třeba e-maily a poznámky. Mohou v nich být skryté pokyny, které se agenta snaží navést k nežádoucí akci. Zápisy zapínej, jen když víš, k čemu je potřebuješ, a připojuj jen agenty, kterým důvěřuješ.
• Kam data jdou. Letos dává data jen agentovi na tvém počítači. Co s nimi agent udělá dál (třeba je pošle svému poskytovateli AI), řídí podmínky toho agenta.

Další podrobnosti o datech najdeš v Soukromí a bezpečnost.

Recepty: ukázkové pokyny

Piš tak, jak bys psal asistentovi. Začni pokyny, které jen čtou.

Čtení (stačí oprávnění Čtení)

• „Co mám tenhle týden na stole? Projdi úkoly a kalendář a řekni mi, co je navíc.“
• „Na které nepřečtené e-maily z posledních tří dnů musím odpovědět?“
• „Jak jsem na tom s cílem Uběhnout půlmaraton? Jsem pozadu?“
• „Najdi e-maily od účetní s přílohou ze září.“

Plánování (potřebuje oprávnění k zápisu)

• „Sestav mi plán na příští týden z otevřených úkolů a kalendáře. Nejdřív mi ho ukaž, nic zatím nezakládej.“
• „Rozděl cíl Naučit se španělsky na kroky na další čtvrtletí. Ukaž mi seznam a kroky přidej, až budu souhlasit.“
• „Přesuň úkoly, které dnes nestihnu, na čtvrtek.“

Pošta

• „Archivuj newslettery z tohoto týdne. Nejdřív mi ukaž seznam.“
• „Připrav koncept odpovědi na poslední zprávu od Jany. Neodesílej ho.“
• „Odlož toto vlákno na pondělí ráno.“

Tip: u série změn řekni agentovi, ať ti nejdřív ukáže plán. Skill níže to dělá ve výchozím stavu.

Řešení potíží

Potíž	Co udělat
Agent se nepřipojí	Letos musí běžet. Zkontroluj, že je zapnuté Povolit agenty (MCP) a že je ve Stavu napsáno Běží. Restartuj klienta.
401, chybí nebo je neplatný token	Token je špatný, odvolaný nebo starý. Klikni na Nový token a nastavení klienta proveď znovu.
403 ze serveru	Požadavek nepřišel z tvého počítače (jiná adresa nebo prohlížeč). Použij http://127.0.0.1:<port>/mcp.
Port je obsazený jinou aplikací	Ve Stavu zvol jiný port (od 1024 výš) a klikni na Změnit port. Pak uprav adresu v klientovi.
„Zápis odmítnut“	Agent potřebuje oprávnění Zápis a musí být zapnuté Povolit zápisy. Agent by měl říct, co z toho chybí.
429, příliš mnoho požadavků	Narazil jsi na limit. Odpověď říká, za kolik sekund to jde zkusit znovu, a agent má tak dlouho počkat. Čtení 60 za minutu, zápisy 10 za minutu a 200 za den.
Chybí poštovní nástroje	Jsi na cloudovém koncovém bodu, který má jen úkoly, cíle a kalendář. Pošta je v místním připojení.
plan_required	Cloudový koncový bod potřebuje plán Plus nebo vyšší.
not_available	Cloudový koncový bod zatím není pro tento účet otevřený.
E-mail neodešel	Do 120 sekund jsi nevybral Odeslat, nebo jsi dal Zamítnout. Agent nesmí předpokládat, že odešel.
Agent hlásí neplatný argument	Nástroje mají přísné parametry. Nech agenta zkontrolovat přehled nástrojů níže.

Co všechno agent udělal, najdeš v Nastavení → Agenti → Záznam aktivity.

Přehled nástrojů

Každý nástroj pracuje vždy jen s jednou položkou. Parametry všech nástrojů jsou v přehledu nástrojů MCP.

Čtení

Nástroj	Co dělá
tasks_list	Seznam úkolů s filtry (stav, sloupec, cíl, termín), po stránkách.
tasks_get	Detail úkolu (poznámka zkrácená na 4 KB, u příloh jen jejich údaje).
goals_list	Cíle s aktivním krokem, počtem kroků a tempem.
goals_get	Cíl i s jeho kroky.
events_list	Události v kalendáři, rozsah nejvýše 62 dní.
mail_threads_list	Seznam e-mailových vláken (doručené, archiv, spam, nepřečtené, odesílatel).
mail_threads_get	Zprávy vlákna jako prostý text (nejvýše 8 KB, nikdy HTML).
search	Fulltextové hledání v poště (from:, to:, has:attachment, is:unread, in:archive).

Zápisy (jen se zapnutým „Povolit zápisy“)

Nástroj	Co dělá
tasks_create	Založí úkol.
tasks_update	Upraví úkol (nemaže). U cíle jde měnit jen název, poznámku a termín.
tasks_complete	Dokončí úkol. U kroku cíle aktivuje další krok.
goals_add_step	Přidá krok k cíli.
events_create	Založí událost bez hostů a bez opakování, takže nikomu neodejde pozvánka.
mail_threads_archive	Archivuje vlákno.
mail_threads_snooze	Odloží vlákno.
mail_compose_draft	Uloží koncept e-mailu v prostém textu (nejvýše 10 příjemců).
mail_send_draft	Požádá o odeslání konceptu. Odešle se jen po tvém potvrzení (viz výše).

Pro pokročilé: skill pro agenta

Skill je krátký soubor s pokyny, který agenta naučí, jak s Letos zacházet: zjistit, k čemu je připojený, číst po stránkách, zapisovat po jedné položce a plán si nejdřív odsouhlasit s tebou, po chybě 429 chvíli počkat a text e-mailů brát jako data, ne jako příkazy.

• Složku stáhneš v Nastavení → Agenti → Stáhnout skill, nebo přímo: letos-mcp.zip. Obsahuje SKILL.md a references/MCP-TOOLS.md.
• V Claude Code ji rozbal do ~/.claude/skills/ (nebo .claude/skills/ v projektu). V jiných klientech se skilly přidávají způsobem, který popisuje ten klient.
• Skill agentovi nepřidá žádná oprávnění. Platí všechno výše.
• Soubory jsou i online: SKILL.md, MCP-TOOLS.md.