Automatyzacja Agendy

Automatyzując Agendę, możesz tworzyć potężne przepływy pracy — zarówno na wysokim poziomie, na przykład za pomocą skrótów Siri lub aplikacji Skróty, jak i na niskim poziomie, choćby dzięki obsłudze x-callback-url. Możliwości są nieograniczone!

Skróty aplikacji

Począwszy od Agendy 15 skróty aplikacji to sposoby na szybkie wykonanie jednego lub kilku zadań w Agendzie za pośrednictwem aplikacji Skróty. Łącząc wiele skrótów Agendy, opcjonalnie z tymi z innych aplikacji, możesz tworzyć i automatyzować swoje przepływy pracy. Od prostego otwarcia konkretnej notatki z ekranu początkowego iPada, przez wywołanie nowej notatki po dwukrotnym stuknięciu w tył telefonu, po złożone przepływy, które zbierają z różnych aplikacji wszystko, co musisz dziś zrobić, i tworzą nowy projekt jednym stuknięciem.

Agenda na iOS obsługuje też skróty Siri dla typowych czynności, takich jak otwarcie określonej notatki, projektu lub zestawienia.

Wyszukiwanie notatek w Skrótach

Możesz użyć akcji Szukaj notatek w aplikacji Skróty, aby znaleźć notatki spełniające określone kryteria. Jest ona dostępna także przez x-callback-url. Zapytania wyszukiwania obsługują składnię akcji, taką jak \color, \done, \pinned i inne, dając Ci w automatyzacjach tę samą moc co wyszukiwanie w aplikacji.

Siri

Możesz używać Siri do przeszukiwania swoich notatek i pracy z Agendą. Na przykład po prostu poproś Siri o wyszukanie czegoś w Agendzie, a wyniki obejrzysz od razu w podglądzie. Siri obsługuje też bogatszą wymianę danych między Agendą a innymi aplikacjami.

Centrum sterowania

Na iOS Agenda udostępnia przyciski w Centrum sterowania, które pozwalają szybko przejść do zestawień Dzisiaj lub Na Agendzie bez wcześniejszego otwierania aplikacji. Przyciski te możesz dodać w ustawieniach Centrum sterowania swojego urządzenia.

Obsługa x-callback-url

Agenda obsługuje także adresy x-callback url. Pozwalają one łączyć przepływy pracy między aplikacjami i/lub automatyzować określone działania wewnątrz Agendy. Obsługuje je również aplikacja Skróty firmy Apple.

Krótkie wprowadzenie do x-callback-url:

• Schemat URL to agenda lub agenda-notes
• Obecnie dostępne polecenia to m.in. on-the-agenda, today, open-project itd.
• W przypadku „open-project” i „open-note” cel możesz wskazać za pomocą parametru title.
• Jak zwykle możesz podać adresy zwrotne za pomocą opcjonalnych parametrów x-success i x-error.

Na przykład, aby otworzyć w Agendzie notatkę o nazwie „Meeting With Peta”, możesz użyć tego adresu URL: agenda://x-callback-url/open-note?title=Meeting%20With%20Peta

Nowość w Agendzie 23: akcja move-note pozwala przenieść notatkę między projektami z innej aplikacji lub skrótu: agenda://x-callback-url/move-note?title=Meeting%20With%20Peta&project-title=Archive

Integracja z MCP (Model Context Protocol)

Agenda zawiera wbudowany serwer MCP na macOS, który pozwala asystentom AI pracować z Twoimi notatkami, projektami i kategoriami. MCP to otwarty protokół, którego narzędzia takie jak Claude Code, Claude Desktop, Cursor i Codex używają do komunikacji z aplikacjami.

Włączanie serwera MCP

Serwer MCP jest domyślnie wyłączony. Aby go włączyć, przejdź do menu Agenda i wybierz Integracje > Włącz MCP. Serwer działa lokalnie na Twoim Macu pod adresem http://127.0.0.1:16106/mcp i jest dostępny wyłącznie z Twojej własnej maszyny.

Menu Integracje udostępnia także opcje kopiowania poleceń konfiguracyjnych do podłączenia różnych narzędzi AI, a także wtyczkę Claude Desktop, którą można pobrać i zainstalować bezpośrednio.

Dostępne narzędzia

Serwer MCP udostępnia asystentom AI następujące narzędzia:

• search_notes — Przeszukuje Twoje notatki według tekstu, tagów, dat i innych kryteriów
• get_note — Pobiera pełną treść konkretnej notatki
• list_projects — Wyświetla listę wszystkich projektów, opcjonalnie z zarchiwizowanymi
• list_categories — Wyświetla listę wszystkich kategorii
• open_note — Otwiera konkretną notatkę w Agendzie
• create_note — Tworzy nową notatkę w projekcie, opcjonalnie z załącznikami
• append_to_note — Dodaje treść i/lub załączniki do istniejącej notatki
• edit_note — Modyfikuje treść istniejącej notatki, opcjonalnie z załącznikami
• create_project — Tworzy nowy projekt
• create_category — Tworzy nową kategorię
• move_note — Przenosi istniejącą notatkę do innego projektu (nowość w Agendzie 23)

Podłączanie narzędzi AI

Aby podłączyć narzędzie AI do serwera MCP Agendy, użyj polecenia konfiguracyjnego z menu Integracje albo skonfiguruj je ręcznie:

Claude Code:

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

Claude Desktop / Cursor: Użyj npx mcp-remote http://localhost:16106/mcp jako polecenia w swojej konfiguracji MCP. Alternatywnie zainstaluj wtyczkę Claude Desktop bezpośrednio z menu Integracje.

Codex: Dodaj poniższe do ~/.codex/config.toml:

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

Załączniki

Narzędzia create_note, append_to_note i edit_note obsługują dodawanie załączników do notatek. Załączniki są przesyłane jako dane zakodowane w base64, dzięki czemu asystent AI może odczytać plik z Twojego Maca, zakodować go i dołączyć do notatki w jednym kroku. Możesz na przykład poprosić asystenta AI o „dołączenie tego PDF-a do moich Notatek ze spotkania”, a on zajmie się resztą.

Każdy załącznik wymaga nazwy pliku filename (z rozszerzeniem, aby Agenda znała typ pliku) oraz zakodowanych w base64 danych pliku data. Opcjonalnie możesz sterować sposobem wyświetlania załącznika za pomocą displayStyle (inline, thumbnail, thumbnail-with-details lub full-width) oraz displaySize (small, medium lub large).

Limity: do 20 załączników na żądanie, przy łącznym maksimum 100 MB danych plików.

Zasoby pomocy

Serwer MCP udostępnia także zasoby pomocy obejmujące typowe zagadnienia z dokumentacji Agendy, dzięki czemu asystenci AI mogą sprawdzać, jak działają funkcje, i udzielać lepszych odpowiedzi na temat Agendy.

O co możesz poprosić

Gdy Twoje narzędzie AI jest już podłączone, może na żądanie czytać i modyfikować Twoje notatki. Kilka przykładów tego, co sprawdza się dobrze:

• „Podsumuj moje notatki ze spotkań z tego tygodnia w nowej notatce w projekcie Przeglądy tygodniowe.”
• „Znajdź wszystko oznaczone #followup, co wspomina o Annie, i wypisz to.”
• „Dodaj zadania z tego PDF-a na dole mojej notatki Rozpoczęcie projektu.” (AI może też dołączać pliki)
• „Przenieś notatkę »Planowanie Q2« z Szkiców do projektu Strategia.”
• „Utwórz nowy projekt o nazwie Wakacje i wypełnij go listą rzeczy do spakowania.”

Ponieważ serwer MCP działa lokalnie na Twoim Macu, Twoje notatki w drodze do narzędzia AI nigdy nie opuszczają Twojej maszyny — przesyłany jest przez niego wyłącznie konkretny tekst, który asystent odczytuje lub zapisuje.

Rozwiązywanie problemów

Jeśli Twoje narzędzie AI nie widzi Agendy:

• Czy MCP jest włączone? Sprawdź Agenda > Integracje > Włącz MCP. Pozycja menu zmienia się na Wyłącz MCP, gdy serwer działa.
• Czy Agenda jest uruchomiona? Serwer żyje wewnątrz aplikacji Agenda — jeśli Agenda zostanie zamknięta, serwer zatrzyma się razem z nią.
• Czy narzędzie AI połączyło się ponownie po włączeniu MCP? Niektórzy klienci buforują połączenie przy uruchomieniu. Uruchom ponownie narzędzie AI, jeśli działało, zanim włączyłeś MCP.
• Czy port 16106 jest zajęty przez coś innego? Szybki test z Terminala: curl http://127.0.0.1:16106/mcp powinno zwrócić odpowiedź (a nie „connection refused”).

Uwaga: Serwer MCP jest dostępny wyłącznie na macOS.