Automatizácia Agendy

Automatizáciou Agendy si môžete vytvoriť veľmi účinné pracovné postupy, a to buď na vyššej úrovni napríklad pomocou skratiek Siri či aplikácie Skratky, alebo na nižšej úrovni napríklad cez podporu x-callback-url. Možnosti sú nekonečné!

Skratky aplikácií

Od Agendy 15 sú skratky aplikácií spôsobom, ako rýchlo vybaviť jednu alebo viac úloh v Agende prostredníctvom aplikácie Skratky. Kombinovaním viacerých skratiek Agendy, prípadne aj so skratkami z iných aplikácií, si môžete vytvoriť a zautomatizovať vlastné pracovné postupy. Od jednoduchého otvorenia konkrétnej poznámky z plochy iPadu cez spustenie novej poznámky po dvojitom ťuknutí na zadnú stranu telefónu až po zložité postupy, ktoré z rôznych aplikácií pozbierajú všetko, čo dnes potrebujete urobiť, a jedným ťuknutím vytvoria nový projekt.

Agenda pre iOS podporuje aj skratky Siri pre bežné úkony, ako je otvorenie určitej poznámky, projektu alebo prehľadu.

Vyhľadávanie poznámok v Skratkách

V aplikácii Skratky môžete použiť akciu Vyhľadať poznámky a nájsť poznámky zodpovedajúce konkrétnym kritériám. Dostupná je aj cez x-callback-url. Vyhľadávacie dopyty podporujú syntax akcií ako \color, \done, \pinned a ďalšie, takže vo svojich automatizáciách máte rovnaké možnosti ako pri vyhľadávaní priamo v aplikácii.

Siri

Siri môžete použiť na prehľadávanie poznámok a prácu s Agendou. Stačí napríklad požiadať Siri, aby niečo vyhľadala v Agende, a výsledky si môžete rovno prezrieť. Siri podporuje aj bohatšiu výmenu údajov medzi Agendou a inými aplikáciami.

Ovládacie centrum

V systéme iOS ponúka Agenda tlačidlá v Ovládacom centre, vďaka ktorým rýchlo prejdete na prehľady Dnes alebo V Agende bez toho, aby ste najprv museli otvoriť aplikáciu. Tieto tlačidlá si pridáte v nastaveniach Ovládacieho centra na svojom zariadení.

Podpora x-callback-url

Agenda podporuje aj adresy x-callback-url. Umožňujú prepájať pracovné postupy medzi aplikáciami a automatizovať určité akcie v rámci Agendy. Podporuje ich aj aplikácia Skratky od Apple.

Krátky úvod do adries x-callback-url:

• Schéma URL je agenda alebo agenda-notes
• Príkazy momentálne zahŕňajú on-the-agenda, today, open-project a ďalšie.
• Pri príkazoch „open-project“ a „open-note“ môžete cieľ určiť parametrom title.
• Ako obvykle môžete zadať spätné adresy URL cez voliteľné parametre x-success a x-error.

Ak chcete napríklad otvoriť Agendu na poznámke s názvom „Meeting With Peta“, môžete použiť túto adresu URL: agenda://x-callback-url/open-note?title=Meeting%20With%20Peta

Novinka v Agende 23: akcia move-note umožňuje presunúť poznámku medzi projektmi z inej aplikácie alebo skratky: agenda://x-callback-url/move-note?title=Meeting%20With%20Peta&project-title=Archive

Integrácia MCP (Model Context Protocol)

Agenda obsahuje v systéme macOS vstavaný server MCP, ktorý umožňuje asistentom s umelou inteligenciou pracovať s vašimi poznámkami, projektmi a kategóriami. MCP je otvorený protokol, ktorý na komunikáciu s aplikáciami používajú nástroje ako Claude Code, Claude Desktop, Cursor a Codex.

Zapnutie servera MCP

Server MCP je predvolene vypnutý. Zapnete ho tak, že prejdete do ponuky Agenda a zvolíte Integrácie > Zapnúť MCP. Server beží lokálne na vašom Macu na adrese http://127.0.0.1:16106/mcp a je prístupný len z vášho vlastného počítača.

Ponuka Integrácie tiež ponúka možnosti skopírovať konfiguračné príkazy na pripojenie rôznych nástrojov s umelou inteligenciou, ako aj doplnok pre Claude Desktop, ktorý si možno stiahnuť a priamo nainštalovať.

Dostupné nástroje

Server MCP poskytuje asistentom s umelou inteligenciou tieto nástroje:

Nájsť a čítať

• search_notes – Vyhľadávanie v poznámkach podľa textu, štítkov, dátumov a ďalších kritérií
• get_note – Načítanie celého obsahu konkrétnej poznámky
• get_selection – Získanie poznámky alebo projektu, ktorý máte vybraný v Agende, aby ste mohli povedať „táto poznámka“
• list_projects – Zoznam všetkých projektov, voliteľne aj archivovaných
• list_categories – Zoznam všetkých kategórií
• list_templates – Zoznam vašich šablón poznámok, aby ste podľa niektorej z nich mohli vytvoriť poznámku
• list_overviews – Zoznam vašich uložených prehľadov
• list_attachments – Zoznam súborov a kresieb v poznámke (novinka v Agende 23.4)
• get_attachment – Získanie pôvodného súboru prílohy (novinka v Agende 23.4)

Zobraziť v Agende

• open_note – Otvorenie konkrétnej poznámky v Agende
• open – Presunutie Agendy do popredia a prechod na Dnes, V Agende, vyhľadávanie, projekt alebo uložený prehľad

Vytvoriť a meniť

• create_note – Vytvorenie novej poznámky v projekte, voliteľne s prílohami
• append_to_note – Pridanie obsahu a/alebo príloh k existujúcej poznámke
• edit_note – Úprava obsahu existujúcej poznámky, voliteľne s prílohami
• move_note – Presun existujúcej poznámky do iného projektu
• trash_note – Presun poznámky do koša
• untrash_note – Obnovenie poznámky z koša
• create_project – Vytvorenie nového projektu
• update_project – Premenovanie projektu, presun do inej kategórie, zmena poradia triedenia, archivácia alebo presun do koša a späť
• create_category – Vytvorenie novej kategórie
• update_category – Premenovanie kategórie, zmena jej farby, vnorenie pod inú kategóriu alebo presun späť na najvyššiu úroveň

Export

• export_pdf – Uloženie poznámok alebo celého projektu ako jedného súboru PDF

Cez MCP nemožno nič natrvalo vymazať. Poznámka alebo projekt, ktorý asistent presunie do koša, tam zostane, kým kôš nevyprázdnite, a kategórie nemožno vymazať vôbec.

Pripojenie nástrojov s umelou inteligenciou

Ak chcete nástroj s umelou inteligenciou pripojiť k serveru MCP v Agende, použite konfiguračný príkaz z ponuky Integrácie alebo ho nastavte ručne:

Claude Code:

claude mcp add --transport http agenda http://localhost:16106/mcp

Claude Desktop / Cursor: Ako príkaz vo svojej konfigurácii MCP použite npx mcp-remote http://localhost:16106/mcp. Prípadne si nainštalujte doplnok pre Claude Desktop priamo z ponuky Integrácie.

Codex: Do súboru ~/.codex/config.toml pridajte toto:

[mcp_servers.agenda]
url = "http://127.0.0.1:16106/mcp"

Prílohy

Nástroje create_note, append_to_note a edit_note podporujú pridávanie príloh k poznámkam. Prílohy sa posielajú ako údaje zakódované v base64, takže asistent s umelou inteligenciou dokáže načítať súbor z vášho Macu, zakódovať ho a v jednom kroku ho pripojiť k poznámke. Môžete napríklad požiadať svojho asistenta, aby „pripojil toto PDF k mojim poznámkam zo stretnutia“, a o zvyšok sa postará sám.

Každá príloha vyžaduje filename (s príponou, aby Agenda poznala typ súboru) a súborové údaje data zakódované v base64. Voliteľne môžete pomocou displayStyle (inline, thumbnail, thumbnail-with-details alebo full-width) a displaySize (small, medium alebo large) určiť, ako sa príloha zobrazí.

Obmedzenia: najviac 20 príloh na jednu požiadavku a celkovo maximálne 100 MB súborových údajov.

Získanie súborov z poznámky (novinka v Agende 23.4)

Asistent dokáže súbor z poznámky aj vybrať späť, napríklad aby si prečítal PDF, ktoré ste pripojili, alebo ho nahral inam. Nástroj list_attachments vypíše súbory a kresby v poznámke. Nástroj get_attachment potom vytvorí kópiu pôvodného súboru len na čítanie, s názvom, ktorý vidíte v Agende, a oznámi asistentovi jej umiestnenie. Kópia je dočasná: Agenda ju odstráni pri ďalšom spustení.

Ak váš nástroj s umelou inteligenciou nedokáže čítať súbory z priečinka Agendy, môže namiesto toho požiadať priamo o obsah súboru (najviac 100 MB, len súbory). Priečinok alebo balík sa odovzdá ako priečinok a kresba ako jej náhľadový obrázok. Prílohy v uzamknutých poznámkach nie sú k dispozícii.

Zdroje pomocníka

Server MCP sprístupňuje aj zdroje pomocníka pokrývajúce bežné témy z dokumentácie Agendy, takže asistenti s umelou inteligenciou si môžu vyhľadať, ako jednotlivé funkcie fungujú, a poskytnúť tak lepšie odpovede o Agende.

Na čo sa môžete opýtať

Keď je váš nástroj s umelou inteligenciou pripojený, dokáže na požiadanie čítať a upravovať vaše poznámky. Niekoľko príkladov, ktoré fungujú dobre:

• „Zhrň moje poznámky zo stretnutí z tohto týždňa do novej poznámky v projekte Weekly Reviews.“
• „Nájdi všetko so štítkom #followup, kde sa spomína Anna, a vypíš to.“
• „Pridaj úlohy z tohto PDF na koniec mojej poznámky Project Kickoff.“ (asistent dokáže pripájať aj súbory)
• „Presuň poznámku ‚Q2 Planning‘ z projektu Drafts do projektu Strategy.“
• „Vytvor nový projekt s názvom Holiday a naplň ho zoznamom vecí na zbalenie.“
• „Vezmi PDF s faktúrou z mojej poznámky ‚March Billing‘ a povedz mi celkovú sumu.“

Keďže server MCP beží lokálne na vašom Macu, vaše poznámky cestou k nástroju s umelou inteligenciou nikdy neopustia váš počítač – prechádza cezeň len ten konkrétny text, ktorý asistent číta alebo zapisuje.

Riešenie problémov

Ak váš nástroj s umelou inteligenciou Agendu nevidí:

• Je MCP zapnuté? Skontrolujte Agenda > Integrácie > Zapnúť MCP. Keď server beží, položka ponuky sa zmení na Vypnúť MCP.
• Beží Agenda? Server žije vnútri aplikácie Agenda – ak Agendu ukončíte, server sa ukončí s ňou.
• Pripojil sa nástroj s umelou inteligenciou znova po zapnutí MCP? Niektorí klienti si pripojenie uložia do vyrovnávacej pamäte pri spustení. Ak nástroj bežal ešte predtým, než ste zapli MCP, reštartujte ho.
• Nepoužíva port 16106 niečo iné? Rýchly test z Terminálu: curl http://127.0.0.1:16106/mcp by mal vrátiť odpoveď (nie „connection refused“).

Poznámka: Server MCP je dostupný len v systéme macOS.