Автоматизация Agenda

Вы можете создавать мощные рабочие процессы, автоматизируя Agenda, — как на высоком уровне, например с помощью команд Siri или приложения «Быстрые команды», так и на низком уровне, например через поддержку x-callback-url. Возможности безграничны!

Быстрые команды приложения

Начиная с Agenda 15 быстрые команды приложения — это способ быстро выполнить одну или несколько задач в Agenda через приложение «Быстрые команды». Комбинируя несколько команд Agenda, при желании вместе с командами из других приложений, вы можете создавать и автоматизировать свои рабочие процессы. От простого открытия конкретной заметки с экрана «Домой» вашего iPad или создания новой заметки по двойному касанию задней панели телефона — до сложных сценариев, которые собирают все дела на сегодня из разных приложений и создают новый проект одним касанием.

Agenda для iOS также поддерживает команды Siri для распространённых действий, таких как открытие определённой заметки, проекта или обзора.

Поиск заметок в «Быстрых командах»

Вы можете использовать действие «Найти заметки» в приложении «Быстрые команды», чтобы находить заметки, соответствующие определённым критериям. Это также доступно через x-callback-url. Поисковые запросы поддерживают синтаксис действий, такой как \color, \done, \pinned и другие, давая вам в автоматизациях те же возможности, что и поиск внутри приложения.

Siri

Вы можете использовать Siri для поиска по заметкам и взаимодействия с Agenda. Например, просто попросите Siri найти что-нибудь в Agenda, и вы сможете просмотреть результаты прямо на месте. Siri также поддерживает более богатый обмен данными между Agenda и другими приложениями.

Пункт управления

В iOS Agenda предоставляет кнопки для Пункта управления, которые позволяют быстро перейти к обзорам «Сегодня» или «На Повестке», не открывая сначала приложение. Эти кнопки можно добавить в настройках Пункта управления вашего устройства.

Поддержка x-callback-url

Agenda также поддерживает x-callback-адреса. Они позволяют связывать рабочие процессы между приложениями и/или автоматизировать определённые действия внутри Agenda. Это также поддерживается приложением Apple «Быстрые команды».

Краткое введение в x-callback-url:

Схема URL — agenda или agenda-notes
Команды в настоящее время включают on-the-agenda, today, open-project и другие.
Для «open-project» и «open-note» вы можете указать цель с помощью параметра title.
Как обычно, вы можете задать URL обратного вызова через необязательные параметры x-success и x-error.

Например, чтобы открыть в Agenda заметку под названием «Meeting With Peta», можно использовать такой URL: agenda://x-callback-url/open-note?title=Meeting%20With%20Peta

Новое в Agenda 23: действие move-note позволяет перемещать заметку между проектами из другого приложения или быстрой команды: agenda://x-callback-url/move-note?title=Meeting%20With%20Peta&project-title=Archive

Интеграция с MCP (Model Context Protocol)

В Agenda для macOS встроен MCP-сервер, который позволяет ИИ-ассистентам взаимодействовать с вашими заметками, проектами и категориями. MCP — это открытый протокол, который такие инструменты, как Claude Code, Claude Desktop, Cursor и Codex, используют для связи с приложениями.

Включение MCP-сервера

MCP-сервер по умолчанию выключен. Чтобы включить его, откройте меню Agenda и выберите Интеграции > Включить MCP. Сервер работает локально на вашем Mac по адресу http://127.0.0.1:16106/mcp и доступен только с вашего собственного компьютера.

Меню «Интеграции» также предоставляет возможность скопировать команды конфигурации для подключения различных ИИ-инструментов, а также плагин для Claude Desktop, который можно загрузить и установить напрямую.

Доступные инструменты

MCP-сервер предоставляет ИИ-ассистентам следующие инструменты:

search_notes — поиск по вашим заметкам по тексту, тегам, датам и другим критериям
get_note — получение полного содержимого конкретной заметки
list_projects — список всех проектов, при желании включая архивные
list_categories — список всех категорий
open_note — открытие конкретной заметки в Agenda
create_note — создание новой заметки в проекте, при желании с файловыми вложениями
append_to_note — добавление содержимого и/или файловых вложений в существующую заметку
edit_note — изменение содержимого существующей заметки, при желании с файловыми вложениями
create_project — создание нового проекта
create_category — создание новой категории
move_note — перемещение существующей заметки в другой проект (новое в Agenda 23)

Подключение ИИ-инструментов

Чтобы подключить ИИ-инструмент к MCP-серверу Agenda, используйте команду конфигурации из меню «Интеграции» или настройте подключение вручную:

Claude Code:

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

Claude Desktop / Cursor: Используйте npx mcp-remote http://localhost:16106/mcp в качестве команды в вашей конфигурации MCP. Как вариант, установите плагин для Claude Desktop прямо из меню «Интеграции».

Codex: Добавьте следующее в ~/.codex/config.toml:

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

Вложения

Инструменты create_note, append_to_note и edit_note поддерживают добавление файловых вложений в заметки. Вложения передаются в виде данных в кодировке base64, поэтому ИИ-ассистент может прочитать файл с вашего Mac, закодировать его и приложить к заметке за один шаг. Например, вы можете попросить своего ИИ-ассистента «приложить этот PDF к моим заметкам со встречи», и он сделает всё остальное.

Для каждого вложения требуется filename (с расширением, чтобы Agenda знала тип файла) и файл data в кодировке base64. При желании вы можете управлять тем, как отображается вложение, с помощью displayStyle (inline, thumbnail, thumbnail-with-details или full-width) и displaySize (small, medium или large).

Ограничения: до 20 вложений на запрос при общем максимуме в 100 МБ файловых данных.

Справочные ресурсы

MCP-сервер также предоставляет справочные ресурсы по распространённым темам из документации Agenda, чтобы ИИ-ассистенты могли посмотреть, как работают функции, и давать более качественные ответы об Agenda.

О чём можно попросить

После подключения вашего ИИ-инструмента он может читать и изменять ваши заметки по запросу. Несколько примеров того, что работает хорошо:

«Сведи мои заметки со встреч за эту неделю в новую заметку в проекте Weekly Reviews.»
«Найди всё с тегом #followup, где упоминается Анна, и составь список.»
«Добавь пункты действий из этого PDF в конец моей заметки Project Kickoff.» (ИИ также может прикреплять файлы)
«Перемести заметку «Q2 Planning» из Drafts в проект Strategy.»
«Создай новый проект под названием Holiday и наполни его списком вещей в дорогу.»

Поскольку MCP-сервер работает локально на вашем Mac, ваши заметки на пути к ИИ-инструменту никогда не покидают ваш компьютер — через него передаётся только тот конкретный текст, который ассистент читает или записывает.

Устранение неполадок

Если ваш ИИ-инструмент не видит Agenda:

Включён ли MCP? Проверьте Agenda > Интеграции > Включить MCP. Когда сервер запущен, пункт меню меняется на Отключить MCP.
Запущена ли Agenda? Сервер работает внутри приложения Agenda — если Agenda завершает работу, сервер останавливается вместе с ней.
Переподключился ли ИИ-инструмент после включения MCP? Некоторые клиенты кешируют подключение при запуске. Перезапустите ИИ-инструмент, если он был запущен до того, как вы включили MCP.
Не занят ли порт 16106 чем-то ещё? Быстрая проверка из Терминала: curl http://127.0.0.1:16106/mcp должен вернуть ответ (а не «connection refused»).

Примечание: MCP-сервер доступен только в macOS.