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:

Wyszukiwanie i czytanie

• search_notes — Przeszukuje Twoje notatki według tekstu, tagów, dat i innych kryteriów
• get_note — Pobiera pełną treść konkretnej notatki
• get_selection — Pobiera notatkę lub projekt zaznaczony w Agendzie, dzięki czemu możesz powiedzieć „ta notatka”
• list_projects — Wyświetla listę wszystkich projektów, opcjonalnie z zarchiwizowanymi
• list_categories — Wyświetla listę wszystkich kategorii
• list_templates — Wyświetla listę Twoich szablonów notatek, aby utworzyć notatkę na podstawie jednego z nich
• list_overviews — Wyświetla listę Twoich zapisanych zestawień
• list_attachments — Wyświetla listę plików i rysunków w notatce (nowość w Agendzie 23.4)
• get_attachment — Pobiera oryginalny plik załącznika (nowość w Agendzie 23.4)

Pokazywanie w Agendzie

• open_note — Otwiera konkretną notatkę w Agendzie
• open — Przenosi Agendę na pierwszy plan i przechodzi do widoku Dzisiaj, Na Agendzie, wyszukiwania, projektu lub zapisanego zestawienia

Tworzenie i zmienianie

• 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
• move_note — Przenosi istniejącą notatkę do innego projektu
• trash_note — Przenosi notatkę do kosza
• untrash_note — Przywraca notatkę z kosza
• create_project — Tworzy nowy projekt
• update_project — Zmienia nazwę projektu, przenosi go do innej kategorii, zmienia jego kolejność sortowania, archiwizuje go albo przenosi do kosza i z powrotem
• create_category — Tworzy nową kategorię
• update_category — Zmienia nazwę kategorii, zmienia jej kolor, zagnieżdża ją w innej kategorii albo przenosi z powrotem na najwyższy poziom

Eksport

• export_pdf — Zapisuje notatki lub cały projekt jako jeden plik PDF

Przez MCP nie da się niczego trwale usunąć. Notatka lub projekt, które asystent przeniesie do kosza, pozostają tam, dopóki nie opróżnisz kosza, a kategorii nie da się usunąć wcale.

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.

Pobieranie plików z notatki (nowość w Agendzie 23.4)

Asystent może też wyjąć plik z notatki, na przykład aby przeczytać dołączony przez Ciebie PDF albo przesłać go gdzie indziej. Narzędzie list_attachments wyświetla listę plików i rysunków w notatce. Narzędzie get_attachment tworzy następnie kopię oryginalnego pliku tylko do odczytu, z nazwą widoczną w Agendzie, i podaje asystentowi jej lokalizację. Kopia jest tymczasowa: Agenda usuwa ją przy następnym uruchomieniu.

Jeśli Twoje narzędzie AI nie może odczytywać plików z folderu Agendy, może zamiast tego poprosić bezpośrednio o zawartość pliku (do 100 MB, tylko pliki). Folder lub pakiet jest przekazywany jako folder, a rysunek jako jego obraz podglądu. Załączniki w zablokowanych notatkach nie są dostępne.

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.”
• „Weź PDF z fakturą z mojej notatki »Rozliczenia marzec« i podaj mi łączną kwotę.”

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.