MCP-доступ (AI-агенты)

Что нового

MCP теперь полностью доступен на iPhone (помимо веб-приложения). Экран на iPhone повторяет веб-версию и содержит те же сниппеты настройки для всех поддерживаемых AI-клиентов.

План Pro и выше

MCP-доступ требует план Pro или Ultra. Оба плана дают полный доступ на чтение + запись (27 инструментов) и могут переключаться в режим только для чтения, если это нужно.

MCP (Model Context Protocol) позволяет подключить AI-ассистентов и инструменты автоматизации напрямую к твоим данным TellDone. После подключения AI-агент может читать твои заметки, задачи, события, отчеты, теги и историю изменений, а также создавать, обновлять, удалять и восстанавливать элементы. Всего 27 инструментов: 10 для чтения и 17 для записи.

Доступно и в приложении на iPhone (Настройки → Integrations → AI Agents), и в веб-приложении (Настройки → AI Agents).

Два способа подключения

AI-клиент можно авторизовать двумя способами, и оба поддерживаются полностью:

OAuth 2.1 (рекомендуем) - стандартный флоу согласия "Вход через TellDone". Именно его используют интерфейс коннекторов Claude Desktop и Claude.ai. Токены копировать не нужно: ты входишь в свой аккаунт TellDone и подтверждаешь права, которые запрашивает клиент.
Bearer-токен - скопируй личный токен доступа из настроек и вставь его в конфиг клиента. Самый простой вариант для скриптов, CLI и клиентов без встроенного OAuth.

Клиент	Что рекомендуем
Claude Desktop / Cowork	OAuth - добавь кастомный коннектор с MCP-адресом и войди в аккаунт
Claude Code (CLI)	Любой способ - `claude mcp add` проведет тебя через OAuth в браузере, либо добавь заголовок `Bearer` для варианта с токеном
Скрипты или собственный код	Bearer-токен - проще всего автоматизировать
Клиент, который умеет выбирать только из каталога готовых коннекторов	Пока используй Bearer-токен или мост `mcp-remote` - TellDone еще нет ни в одном каталоге коннекторов

Требования по плану

План	MCP
Free	Заблокировано
Basic	Заблокировано
Pro	Чтение + запись (27 инструментов) - можно переключиться в режим только для чтения
Ultra	Чтение + запись (27 инструментов) - можно переключиться в режим только для чтения

Экран в приложении

Экран AI Agents имеет три состояния, в зависимости от твоего плана и того, включен ли MCP.

Заблокировано (Free и Basic)

Если у тебя план Free или Basic, экран рассказывает, что такое MCP, и показывает кнопку Upgrade. По нажатию открывается paywall, где можно перейти на Pro или Ultra.

Выключено (Pro и Ultra, функция отключена)

Если у тебя Pro или Ultra, но MCP пока не включен, экран показывает краткую сводку возможностей твоего плана (количество инструментов, режим доступа, квоты) и кнопку Enable. Нажми ее, чтобы сгенерировать токен подключения и запустить интеграцию.

Включено

Когда MCP включен, экран содержит все, что нужно для подключения AI-клиента:

Переключатель режима - на Ultra можно переключаться между Только чтение и Чтение + запись. На Pro режим зафиксирован на Чтение + запись.
Строка Access Token с кнопкой-глазом, чтобы показать или скрыть токен, и кнопкой копирования.
Setup-пикер с вкладками Claude Code, Cursor, Windsurf и Other. Соответствующий сниппет появляется под вкладками - его нужно просто скопировать и вставить в конфиг твоего AI-клиента.
Кнопка Regenerate - мгновенно меняет токен и обрывает все активные сессии, которые использовали старый.
Кнопка Disable - выключает MCP и удаляет токен. Включить заново можно позже, но будет выдан новый токен.

подсказка

Храни токен подключения в секрете. Любой, кто его получит, сможет получить доступ к твоим данным TellDone. Если есть подозрение, что токен утек, нажми Regenerate.

Как включить

Настроить MCP можно с любой платформы:

iPhone: Настройки → Integrations → AI Agents (MCP)
Веб: app.telldone.app → Настройки → AI Agents

Шаги:

Нажми Enable.
Выбери режим доступа (только на Ultra - на Pro всегда Чтение + запись).
Покажи и скопируй токен иконками глаза и копирования.
Выбери свой инструмент в разделе Setup (Claude Code, Cursor, Windsurf или Other).
Вставь сниппет в конфиг своего AI-клиента.

Подключение через OAuth

OAuth - рекомендуемый способ для Claude Desktop, Claude.ai, Cowork и Claude Code: ты входишь в свой аккаунт TellDone вместо того, чтобы копировать токен туда-сюда.

MCP-адрес для OAuth: https://api.telldone.app/mcp/user (без /mcp в конце - это другой адрес, он нужен только для варианта с Bearer-токеном ниже)

Claude Desktop / Cowork

В клиенте выбери Add custom connector.
Укажи адрес сервера: https://api.telldone.app/mcp/user
Клиент откроет страницу согласия TellDone в браузере. Там будет видно, какое приложение запрашивает доступ, какие именно права ему нужны, и форма входа.
Войди с почтой и паролем от аккаунта TellDone и нажми Allow.
Клиент автоматически получит токен доступа и подключится - копировать ничего не надо.

примечание

Вход на странице согласия работает по почте и паролю от аккаунта TellDone. Если у тебя вход только через Apple или Google (пароль не задан), пока используй способ с Bearer-токеном ниже.

Claude Code

OAuth (открывает вход в браузере):

claude mcp add --transport http telldone https://api.telldone.app/mcp/user

Claude Code сам находит OAuth-флоу, но при первом вызове в аккаунт не входит: запусти /mcp внутри Claude Code и выбери Authenticate, чтобы открыть вход в браузере. Дальше он будет обновлять токен доступа за тебя - поддерживать ничего не нужно.

Bearer-токен (без браузера, удобно для серверных установок):

claude mcp add telldone --transport http \
  https://api.telldone.app/mcp/user/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Свой YOUR_TOKEN возьми в приложении: Настройки → Integrations → AI Agents → Copy token (см. Как включить выше).

Подключение по Bearer-токену

Для клиентов без встроенной поддержки OAuth - Cursor, Windsurf и других - вставь личный токен доступа прямо в конфиг клиента. Замени YOUR_TOKEN на свой токен из настроек во всех примерах ниже.

Cursor

Добавь в .cursor/mcp.json:

{
  "mcpServers": {
    "telldone": {
      "url": "https://api.telldone.app/mcp/user/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Windsurf

Добавь в .codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "telldone": {
      "serverUrl": "https://api.telldone.app/mcp/user/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Other

Используй эти сниппеты для клиентов, которые пикер в приложении объединяет под Other.

Codex

Добавь в codex.json:

{
  "mcpServers": {
    "telldone": {
      "type": "http",
      "url": "https://api.telldone.app/mcp/user/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

OpenClaw

Settings > MCP Servers > Add:

Name: TellDone
URL: https://api.telldone.app/mcp/user/mcp
Auth: Bearer YOUR_TOKEN

Другие MCP-клиенты

Любой инструмент с поддержкой MCP через HTTP может подключиться. Используй эндпоинт https://api.telldone.app/mcp/user/mcp с заголовком авторизации Bearer YOUR_TOKEN.

Альтернативный заголовок авторизации

Если твой клиент или прокси использует заголовок Authorization для своих целей (например, некоторые шлюзы типа Smithery), отправь токен в X-MCP-Token: YOUR_TOKEN. Работают оба заголовка; если заданы оба, приоритет у Authorization.

Проверка подключения

Проверь, что токен работает, простой командой cURL:

curl -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

Успешный ответ содержит список всех доступных инструментов.

Права доступа (scopes)

У OAuth-подключений есть права доступа: при входе ты видишь, что именно запрашивает клиент, и подтверждаешь это явно.

Право	Что разрешает приложению
`notes:read`	Читать заметки, искать по ним, открывать подробности заметки
`notes:write`	Создавать, изменять, удалять заметки (и запускать обработку голосовых заметок)
`tasks:read` / `tasks:write`	Читать / создавать, изменять, выполнять и удалять задачи
`events:read` / `events:write`	Читать / создавать, изменять и удалять события
`reports:read`	Читать ежедневные, еженедельные, ежемесячные и годовые отчеты
`tags:read` / `tags:write`	Смотреть список тегов / создавать и переименовывать теги
`profile:read`	Читать данные профиля и подписки
`offline_access`	Оставаться подключенным, когда тебя нет рядом (выдает refresh-токен, чтобы не входить заново каждую сессию)

Права доступа - это потолок, а не гарантия: подключение только с notes:read не сможет вызвать инструмент записи, что бы ты у него ни попросил. Твой план - второй фильтр поверх прав доступа.

У подключений по Bearer-токену отдельных прав доступа нет - они ограничены только режимом чтения/записи из твоего плана.

Что можно делать

Инструменты чтения (10) - Pro и Ultra

Инструмент	Что делает
get_notes	Список заметок с фильтрами (теги, диапазон дат, текстовый поиск)
get_note	Просмотр отдельной заметки с задачами, событиями и полной транскрипцией
get_notes_full	Получить несколько заметок с задачами и событиями за один запрос
get_tasks	Список задач с фильтрацией по статусу (к выполнению, выполнено, все), тегам или датам
get_events	Список событий календаря, фильтр по диапазону дат
get_reports	Чтение ежедневных, еженедельных, ежемесячных и годовых отчетов (полный markdown)
get_tags	Просмотр всех тегов, отсортированных по использованию
get_profile	Информация об аккаунте и статистика использования
search	Поиск по заметкам, задачам и событиям (текст + семантический поиск для заметок)
get_change_log	Посмотреть историю изменений заметки, задачи или события и понять, было ли каждое изменение отменено

подсказка

Инструмент search поддерживает семантический поиск по заметкам - находит результаты по смыслу, а не только по ключевым словам. Например, поиск "встречи по бюджету" найдет заметки о финансовых обсуждениях, даже если они не содержат слово "бюджет."

Инструменты записи (17) - Pro и Ultra

Инструмент	Что делает
process_note	Полный AI-анализ - отправь текст или аудио, получи заметку с задачами, событиями и тегами
create_note	Добавить текстовую заметку (без AI-анализа)
create_task	Добавить задачу с приоритетом, дедлайном, напоминанием и тегами
create_event	Добавить событие календаря с датой, временем, местом, напоминаниями, участниками и повторением
update_note	Изменить заголовок, резюме, тип, теги, приоритет или статус заметки
update_task	Изменить заголовок, описание, приоритет, дедлайн, напоминание, теги или статус задачи
complete_task	Отметить задачу как выполненную
update_event	Изменить детали, время, место, напоминания, участников, повторение, теги или статус события
delete_note	Удалить заметку и все связанные задачи и события
delete_task	Удалить задачу
delete_event	Удалить событие
undo_change_log_entry	Отменить одно отслеженное изменение - сделанное AI или тобой самим - вернув предыдущее значение поля
restore_entity	Вернуть удаленную или заархивированную заметку, задачу или событие
create_tag	Создать новый тег или сделать автоматически предложенный тег постоянным
set_tag_pinned	Закрепить или открепить тег, чтобы он поднимался наверх
delete_tag	Удалить тег (можно восстановить через restore_tag)
restore_tag	Вернуть удаленный тег

Все операции записи и удаления мгновенно отображаются на подключенных устройствах (телефон, веб-приложение) через синхронизацию в реальном времени.

Справочник инструментов

get_notes

Список заметок с опциональной фильтрацией. Фильтры по дате используют recorded_at (когда ты записал голосовую заметку), а не created_at.

Параметр	Тип	По умолчанию	Описание
`limit`	int	20	Количество заметок (макс. 50)
`offset`	int	0	Пропустить указанное количество заметок (для пагинации, макс. 10000)
`tags`	string	-	Фильтр по тегам, через запятую (совпадение по любому)
`search`	string	-	Текстовый поиск по заголовку и резюме
`date_from`	string	-	Начальная дата, YYYY-MM-DD (включительно)
`date_to`	string	-	Конечная дата, YYYY-MM-DD (не включительно)
`standalone_only`	bool	false	Если true, скрывает заметки-дополнения (заметки, привязанные к родительской заметке, задаче или событию) и возвращает только самостоятельные заметки

Возвращает: список заметок с id, title, summary, type, tags, priority, status, recorded_at, created_at.

get_note

Получить одну заметку с полной транскрипцией и всеми связанными задачами и событиями.

Параметр	Тип	Описание
`note_id`	string	UUID заметки

Возвращает: заметку с title, summary, transcript, type, tags, priority, status, metadata, created_at, а также массивы tasks[] и events[].

Также возвращает transcript_speakers (реплики транскрипции с метками говорящих - для встреч с несколькими участниками, иначе null), speaker_count (null, если запись не была разбита по говорящим) и parent_note_id/parent_task_id/parent_event_id (заполняются, когда эта заметка - продолжение-правка другого элемента). Каждый элемент tasks[]/events[] также содержит reminders_at/recurrence_rule (для задач) или reminder_minutes/attendees/recurrence_rule (для событий).

get_notes_full

Получить несколько заметок с задачами и событиями за один запрос. Те же фильтры, что и у get_notes, но каждая заметка включает вложенные tasks[] и events[].

Параметр	Тип	По умолчанию	Описание
`limit`	int	10	Количество заметок (макс. 20)
`offset`	int	0	Пропустить указанное количество заметок
`tags`	string	-	Фильтр по тегам
`date_from`	string	-	Начальная дата, YYYY-MM-DD
`date_to`	string	-	Конечная дата, YYYY-MM-DD
`standalone_only`	bool	false	Если true, скрывает заметки-дополнения (заметки, привязанные к родительской заметке, задаче или событию) и возвращает только самостоятельные заметки

get_tasks

Список задач с фильтрацией.

Параметр	Тип	По умолчанию	Описание
`status`	string	"todo"	Фильтр: `todo`, `done` или `all`
`limit`	int	30	Количество задач (макс. 100)
`offset`	int	0	Пропустить указанное количество задач
`tags`	string	-	Фильтр по тегам, через запятую
`date_from`	string	-	Начальная дата, YYYY-MM-DD (фильтрует по дедлайну; задачи без дедлайна исключаются)
`date_to`	string	-	Конечная дата, YYYY-MM-DD (фильтрует по дедлайну; задачи без дедлайна исключаются)

Возвращает: список задач с id, title, description, status, priority, tags, deadline, reminder_at, reminders_at, completed_at, completed_by, source, created_at. reminder_at дублирует первый элемент reminders_at для обратной совместимости - используй reminders_at, чтобы увидеть все напоминания задачи.

get_events

Список событий календаря с фильтрацией по диапазону дат.

Параметр	Тип	По умолчанию	Описание
`limit`	int	30	Количество событий (макс. 100)
`offset`	int	0	Пропустить указанное количество событий
`date_from`	string	-	Начальная дата, YYYY-MM-DD (фильтрует по времени начала события)
`date_to`	string	-	Конечная дата, YYYY-MM-DD

Возвращает: список событий с id, title, description, status, start_at, end_at, location, is_all_day, tags, note_id, reminder_minutes, attendees, recurrence_rule, created_at.

get_reports

Получить AI-сгенерированные отчеты с полным содержимым в формате markdown.

Параметр	Тип	По умолчанию	Описание
`report_type`	string	"daily"	Тип: `daily`, `weekly`, `monthly` или `yearly`
`limit`	int	5	Количество отчетов (макс. 10)

Возвращает: список отчетов с id, type, period_start, period_end, content_md, created_at.

примечание

Ежемесячные отчеты могут содержать 3 000-5 000 слов. Используй limit=1, если у твоего AI-инструмента ограниченное контекстное окно.

get_tags

Получить все теги, отсортированные: сначала закрепленные, затем по количеству использований.

Без параметров. Возвращает до 100 тегов, каждый с tag, usage_count, is_pinned, is_manual.

get_profile

Получить информацию об аккаунте и статистику использования.

Без параметров. Возвращает email, display_name, locale, transcription_locale, timezone, subscription, mcp_mode, created_at и stats (количество заметок/задач/событий).

search

Поиск по заметкам, задачам и событиям одновременно. Для заметок поддерживается как текстовый, так и семантический поиск (находит результаты по смыслу с помощью AI-эмбеддингов).

Параметр	Тип	По умолчанию	Описание
`query`	string	обязательный	Текст поиска (макс. 500 символов)
`limit`	int	20	Макс. результатов на тип (макс. 20)
`semantic`	bool	true	Включить семантический поиск для заметок

Возвращает результаты, сгруппированные по типу: notes[], tasks[], events[]. Каждый результат содержит id, type, title, detail, created_at.

Установи semantic=false для более быстрого текстового поиска.

get_change_log

Посмотреть историю изменений заметки, задачи или события - каждую AI-правку из продолжений и каждую твою ручную правку, начиная с самых свежих.

Параметр	Тип	По умолчанию	Описание
`entity`	string	обязательный	`notes`, `tasks` или `events`
`entity_id`	string	обязательный	UUID элемента
`include_manual`	bool	false	Также включать твои ручные правки, а не только сделанные AI

Возвращает: список записей об изменениях с id (используй его как entry_id для отмены), field_name, old_value, new_value, source (follow_up, smart_context или manual), origin_note_id, edited_at и reverted_at (заполняется после отмены).

process_note (Pro и Ultra)

Полный AI-анализ - работает так же, как запись в приложении. Отправь текст или аудио, и TellDone транскрибирует, проанализирует с помощью AI и создаст структурированную заметку с извлеченными задачами, событиями, тегами и эмбеддингами.

Этот инструмент асинхронный: возвращает результат сразу с audio_id и обрабатывает в фоне. Результаты приходят через синхронизацию в реальном времени на подключенные устройства, или можно проверить через get_notes().

Параметр	Тип	Описание
`text`	string	Текст для анализа (пропускает транскрипцию, если аудио не указано)
`audio_base64`	string	Аудиофайл в кодировке Base64 (до 50 МБ, запускает транскрипцию)
`audio_format`	string	`m4a`, `ogg`, `wav`, `mp3`, `aac` или `webm` (по умолчанию: m4a)
`parent_task_id`	string	UUID задачи, к которой это продолжение
`parent_note_id`	string	UUID заметки, к которой это продолжение
`parent_event_id`	string	UUID события, к которому это продолжение

Необходимо указать text или audio_base64 (или оба - аудио имеет приоритет для транскрипции).

Возвращает: {"audio_id": "...", "status": "processing", "mode": "text-only"} или "mode": "audio+stt", если указано аудио.

примечание

process_note подчиняется квотам твоего плана (загрузки в день, заметки в месяц, макс. длина текста). Используй get_profile для проверки текущего использования.

create_note (Pro и Ultra)

Создать текстовую заметку мгновенно. Не запускает AI-анализ - задачи и события не извлекаются. Для полного AI-анализа с извлечением задач/событий используй process_note.

Параметр	Тип	Лимит	Описание
`title`	string	200 символов	Обязательный
`summary`	string	1000 символов	Необязательный. Короткое резюме (1-3 предложения). Используется в промптах отчетов, поэтому держи его кратким
`transcript`	string	зависит от плана	Необязательный. Полный текст, который показывается при подробном просмотре заметки. В отчеты не попадает. Лимиты: Free 2 000 / Basic 8 000 / Pro 20 000 / Ultra 50 000 символов
`type`	string	-	Необязательный. `task`, `idea`, `info` (по умолчанию), `status`, `meeting`, `event` или `reflection`
`tags`	string	20 тегов	Через запятую, необязательный

create_task (Pro и Ultra)

Создать новую задачу.

Параметр	Тип	Лимит	Описание
`title`	string	200 символов	Обязательный
`description`	string	2000 символов	Необязательный
`priority`	string	-	`low`, `medium` (по умолчанию) или `high`
`deadline`	string	-	YYYY-MM-DD, необязательный
`reminder_at`	string	-	Дата-время ISO 8601 (напр. `2026-04-15T09:00:00Z`), необязательный
`tags`	string	20 тегов	Через запятую, необязательный
`note_id`	string	-	UUID для привязки задачи к родительской заметке, необязательный

create_event (Pro и Ultra)

Создать событие календаря.

Параметр	Тип	Лимит	Описание
`title`	string	200 символов	Обязательный
`start_at`	string	-	Дата-время в формате ISO 8601, обязательный
`end_at`	string	-	Дата-время в формате ISO 8601 (по умолчанию: начало + 1 час)
`description`	string	2000 символов	Необязательный
`location`	string	200 символов	Необязательный
`is_all_day`	bool	-	По умолчанию: false
`tags`	string	20 тегов	Через запятую, необязательный
`reminder_minutes`	string	-	Минуты до события через запятую (напр. `15,60`), необязательный
`attendees`	string	-	Имена или email через запятую, необязательный
`recurrence_rule`	string	-	Строка RRULE (напр. `FREQ=WEEKLY;BYDAY=MO,WE,FR`), необязательный
`note_id`	string	-	UUID для привязки события к родительской заметке, необязательный

update_note (Pro и Ultra)

Обновить одно или несколько полей существующей заметки. Изменяются только те поля, которые ты передашь.

Параметр	Тип	Описание
`note_id`	string	Обязательный, UUID заметки
`title`	string	Новый заголовок (макс. 200 символов)
`summary`	string	Новое резюме (макс. 1000 символов, передай пробел `" "` для очистки)
`transcript`	string	Новый полный текст (лимит зависит от плана, передай пробел `" "` для очистки)
`type`	string	`task`, `idea`, `info`, `status`, `meeting`, `event` или `reflection`
`tags`	string	Теги через запятую (заменяет все существующие, макс. 20)
`priority`	string	`low`, `medium` или `high`
`status`	string	`active` или `archived`

предупреждение

Для голосовых заметок transcript - это исходный результат распознавания речи. Перезапись заменит канонический источник - если хочешь сохранить оригинал, лучше допиши в конец, а не заменяй.

update_task (Pro и Ultra)

Обновить одно или несколько полей существующей задачи. Изменяются только те поля, которые ты передашь.

Параметр	Тип	Описание
`task_id`	string	Обязательный, UUID задачи
`title`	string	Новый заголовок
`description`	string	Новое описание (передай пробел `" "` для очистки)
`priority`	string	`low`, `medium` или `high`
`deadline`	string	YYYY-MM-DD (передай пробел для очистки)
`status`	string	`todo` или `done`
`tags`	string	Теги через запятую (заменяет все существующие, макс. 20)
`reminder_at`	string	Дата-время ISO 8601 (передай пробел для очистки)

Установка status в done также фиксирует когда и как задача была выполнена.

complete_task (Pro и Ultra)

Быстрый способ отметить задачу как выполненную.

Параметр	Тип	Описание
`task_id`	string	Обязательный, UUID задачи

Возвращает ошибку, если задача не существует или уже выполнена.

update_event (Pro и Ultra)

Обновить одно или несколько полей существующего события. Изменяются только те поля, которые ты передашь.

Параметр	Тип	Описание
`event_id`	string	Обязательный, UUID события
`title`	string	Новый заголовок
`description`	string	Новое описание (передай пробел для очистки)
`start_at`	string	Новое время начала (ISO 8601)
`end_at`	string	Новое время окончания (ISO 8601)
`location`	string	Новое место (передай пробел для очистки)
`status`	string	`confirmed`, `tentative` или `cancelled`
`tags`	string	Теги через запятую (заменяет все существующие, макс. 20)
`is_all_day`	string	`"true"` или `"false"`
`reminder_minutes`	string	Минуты до события через запятую (напр. `15,60`)
`attendees`	string	Имена или email через запятую
`recurrence_rule`	string	Строка RRULE (передай пробел для очистки)

delete_note (Pro и Ultra)

Удалить заметку. Также удаляет все задачи и события, созданные из этой заметки.

Параметр	Тип	Описание
`note_id`	string	Обязательный, UUID заметки

delete_task (Pro и Ultra)

Удалить задачу.

Параметр	Тип	Описание
`task_id`	string	Обязательный, UUID задачи

delete_event (Pro и Ultra)

Удалить событие.

Параметр	Тип	Описание
`event_id`	string	Обязательный, UUID события

undo_change_log_entry (Pro и Ultra)

Отменить одно отслеженное изменение - возвращает поле к значению до этой правки, независимо от того, сделал ли ее AI (из продолжающей записи) или ты сам.

Параметр	Тип	Описание
`entity`	string	Обязательный, `notes`, `tasks` или `events`
`entity_id`	string	Обязательный, UUID элемента
`entry_id`	string	Обязательный, `id` записи изменения из `get_change_log`

Возвращает: {"entry_id", "entity_type", "entity_id", "field_name", "restored_value", "reverted_at"}. Повторная отмена той же записи вернет ошибку - она уже отменена.

restore_entity (Pro и Ultra)

Вернуть удаленную или заархивированную заметку, задачу или событие.

Параметр	Тип	Описание
`entity`	string	Обязательный, `notes`, `tasks` или `events`
`entity_id`	string	Обязательный, UUID элемента

Возвращает: восстановленный элемент в формате JSON.

create_tag (Pro и Ultra)

Создать новый тег или сделать существующий автоматически предложенный тег постоянным.

Параметр	Тип	Описание
`tag`	string	Обязательный, 1-50 символов (хранится в нижнем регистре)
`category`	string	Необязательный

set_tag_pinned (Pro и Ultra)

Закрепить или открепить тег, чтобы он поднимался наверх твоего списка тегов.

Параметр	Тип	Описание
`tag`	string	Обязательный
`pinned`	bool	Обязательный

Теги, содержащие символ /, закрепить нельзя.

delete_tag (Pro и Ultra)

Удалить тег. Можно вернуть через restore_tag.

Параметр	Тип	Описание
`tag`	string	Обязательный

restore_tag (Pro и Ultra)

Вернуть удаленный тег.

Параметр	Тип	Описание
`tag`	string	Обязательный

Лимиты ввода

Поле	Макс. длина	Используется в
title	200 символов	создание/обновление заметки, задачи, события
description	2 000 символов	создание/обновление задачи, события
summary	1 000 символов (жесткий лимит)	создание/обновление заметки. Попадает в промпты отчетов, держится коротким для контроля расхода токенов
transcript	зависит от плана: Free 2 000 / Basic 8 000 / Pro 20 000 / Ultra 50 000	создание/обновление заметки. Длинный текст, в отчеты не идет
location	200 символов	создание/обновление события
tags	20 тегов	создание/обновление заметки, задачи, события
search query	500 символов	search
audio_base64 (декодированный)	50 МБ	process_note

Если ты превысишь лимит, инструмент вернет сообщение об ошибке вида "title too long (max 200 chars, got 250)".

Обработка ошибок

Все инструменты возвращают JSON. Ошибки имеют такой формат:

{"error": "description of what went wrong"}

Частые ошибки:

Ошибка	Когда возникает
`"MCP access is read-only..."`	Вызван инструмент записи в режиме только чтение
`"Invalid note_id format"`	Передана строка, не являющаяся UUID
`"Note not found"`	ID не существует или принадлежит другому пользователю
`"Task not found or already completed"`	`complete_task` для несуществующей или уже выполненной задачи
`"title too long (max 200 chars, got N)"`	Превышен лимит ввода
`"Too many tags (max 20)"`	Передано больше 20 тегов

Ошибки на уровне HTTP:

Код	Значение
401	Недействительный или отсутствующий Bearer-токен
403	MCP отключен или план не поддерживает MCP
429	Превышен лимит скорости (5 запр/с, всплеск до 20)

Примеры использования

Все примеры используют cURL с протоколом MCP JSON-RPC. Замени YOUR_TOKEN на свой токен подключения.

Чтение данных

# Get your profile and stats
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"get_profile"}}'

# List recent notes (limit 5, from April 2026)
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"get_notes","arguments":{"limit":5,"date_from":"2026-04-01"}}}'

# Search notes (hybrid text + semantic)
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call",
       "params":{"name":"search","arguments":{"query":"project deadline","limit":5}}}'

Запись данных (Pro и Ultra)

# Process a note through full AI pipeline (extracts tasks + events)
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":10,"method":"tools/call",
       "params":{"name":"process_note","arguments":{"text":"Need to buy groceries tomorrow. Meeting with Katie at 3pm at the cafe to discuss the project."}}}'

# Create a task with deadline and reminder
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":11,"method":"tools/call",
       "params":{"name":"create_task","arguments":{"title":"Review PR","priority":"high","deadline":"2026-04-15","reminder_at":"2026-04-15T09:00:00Z","tags":"dev"}}}'

# Create a recurring event with reminders and attendees
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":12,"method":"tools/call",
       "params":{"name":"create_event","arguments":{"title":"Team standup","start_at":"2026-04-12T10:00:00Z","reminder_minutes":"15","attendees":"Katie,John","recurrence_rule":"FREQ=DAILY;BYDAY=MO,TU,WE,TH,FR","tags":"meeting"}}}'

# Complete a task
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":13,"method":"tools/call",
       "params":{"name":"complete_task","arguments":{"task_id":"<task-uuid>"}}}'

Успешный ответ выглядит так:

{
  "jsonrpc": "2.0",
  "id": 10,
  "result": {
    "content": [{"type": "text", "text": "{\"id\":\"...\",\"title\":\"Review PR\",\"status\":\"todo\"}"}]
  }
}

примечание

Инструменты записи и обновления возвращают минимальные ответы - только id, title и status. Чтобы получить все поля (теги, приоритет, дедлайн и т.д.) после записи, сделай дополнительный запрос на чтение, например get_tasks или get_note.

Управление токеном

Действие	Как
Посмотреть токен	Настройки на iPhone → Integrations → AI Agents (или Настройки в вебе → AI Agents), нажми иконку глаза
Скопировать токен	Нажми иконку копирования рядом с токеном
Перегенерировать	Нажми Regenerate и подтверди. Старый токен сразу перестает работать, активные сессии обрываются
Сменить режим	Только Ultra - переключение между Только чтение и Чтение + запись. На Pro режим зафиксирован на Чтение + запись
Отключить	Нажми Disable и подтверди. Токен удаляется, все соединения прерываются. Можно включить снова позже (будет выдан новый токен)

Что можно спросить у AI-агента

После подключения проси AI-инструмент:

Обзор дня:

"Чем я занимался сегодня?"
"Покажи мои заметки за эту неделю"
"Какие задачи просрочены?"

Управление задачами:

"Создай задачу: проверить квартальный отчет, высокий приоритет, дедлайн пятница"
"Отметь задачу по Figma как выполненную"
"Над какими задачами я работаю?"

Поиск и анализ:

"Найди все заметки про маркетинговую стратегию"
"Какие события у меня на следующей неделе?"
"Резюмируй мои ежедневные отчеты за прошлую неделю"

Планирование:

"Создай событие: стендап команды завтра в 10 утра"
"Что у меня в календаре на этой неделе?"
"Покажи мои основные теги - на что я трачу больше всего времени?"

AI-агент имеет полный доступ к твоим заметкам, задачам, событиям и отчетам. Он может читать, создавать, обновлять и удалять данные, а также отвечать на сложные вопросы, комбинируя информацию из нескольких инструментов.

Важно знать

Два способа создать заметку - create_note создает текстовую заметку мгновенно (без AI-анализа). process_note запускает полный AI-анализ (как запись в приложении) - анализирует текст, извлекает задачи и события, генерирует теги и эмбеддинги. Используй process_note, когда хочешь, чтобы TellDone думал за тебя.
Без синхронизации интеграций - элементы, созданные или обновленные через MCP, не запускают вебхуки и синхронизацию интеграций (Todoist, Notion). Они появятся в приложениях при следующей синхронизации.
Семантический поиск зависит от инструмента - заметки, созданные через process_note, получают эмбеддинги и появляются в семантическом поиске. Заметки, созданные через create_note, не получают эмбеддинги и доступны только в текстовом поиске.
Ответы на запись минимальны - инструменты создания и обновления возвращают только id, title и status. Чтобы получить все поля после записи, сделай дополнительный запрос на чтение.
Фильтры дат используют UTC - параметры date_from/date_to сравниваются как метки времени UTC. Для пользователей в часовых поясах, отличных от UTC, граничные даты могут включать или исключать элементы из соседних дней.
Лимит скорости - 5 запросов в секунду, со всплесками до 20. Для массовых операций делай паузы между запросами.

Безопасность

Каждый пользователь получает уникальный 384-битный токен подключения
Токен мгновенно аннулируется при отключении MCP или перегенерации
Все данные строго изолированы на уровне аккаунта - агент может получить доступ только к твоим данным
Каждый запрос привязан к твоему пользователю - у агента нет возможности получить доступ к данным другого пользователя
Соединение использует HTTPS с лимитом скорости (5 запр/с, всплеск до 20)
OAuth-подключения используют PKCE с одноразовыми кодами авторизации и короткоживущими токенами доступа - отозвать подключение можно в любой момент прямо из приложения

Если хочешь разобраться в технических деталях - эндпоинты discovery, время жизни токенов, полный OAuth-флоу - смотри наш открытый справочник по коннектору на github.com/exp78/telldone-mcp или запроси https://api.telldone.app/.well-known/oauth-protected-resource напрямую.

Приватность и передача данных

Твои данные передаются подключенному AI-инструменту только тогда, когда ты сам просишь его что-то сделать - например, прочитать или изменить твои заметки. Инструмент получает только ответы на те запросы, которые он делает, и только в рамках прав, которые ты подтвердил. Все под твоим контролем: меняй режим чтения/записи в своем плане, сужай права доступа OAuth при входе или перегенерируй и отключай Bearer-токен - все это в Настройках. Подробности смотри в Политике конфиденциальности, а с вопросами пиши на support@telldone.app.

Решение проблем

Симптом	Причина / что делать
Страница согласия OAuth пишет "Wrong email or password"	Используй почту и пароль от аккаунта TellDone (те же, с которыми ты входишь в приложение). Если у тебя вход только через Apple или Google и пароля нет, воспользуйся способом с Bearer-токеном.
Подключение есть, но AI ничего не создает и не меняет	Твой план или режим работает только на чтение, либо подключению не выдали права на запись - переподключись и подтверди их или проверь режим в Настройках.
Инструмент возвращает ошибку "Insufficient scope"	Этого права у OAuth-подключения нет. Переподключись и подтверди право, которое нужно инструменту.
Инструменты вообще не появляются	MCP не включен в твоем аккаунте (Настройки → AI Agents) либо твой план не включает MCP.
Мой клиент дает выбрать только из списка коннекторов, а TellDone в нем нет	TellDone пока нет ни в одном каталоге коннекторов - добавь его как кастомный коннектор с MCP-адресом или используй способ с Bearer-токеном.

Смотри также

Вебхук-автоматизации - автоматическая отправка данных во внешние сервисы
Todoist - выделенная двусторонняя синхронизация задач
Notion - выделенная интеграция для Notion

Два способа подключения​

Требования по плану​

Экран в приложении​

Заблокировано (Free и Basic)​

Выключено (Pro и Ultra, функция отключена)​

Включено​

Как включить​

Подключение через OAuth​

Claude Desktop / Cowork​

Claude Code​

Подключение по Bearer-токену​

Cursor​

Windsurf​

Other​

Codex​

OpenClaw​

Другие MCP-клиенты​

Проверка подключения​

Права доступа (scopes)​

Что можно делать​

Инструменты чтения (10) - Pro и Ultra​

Инструменты записи (17) - Pro и Ultra​

Справочник инструментов​

get_notes​

get_note​

get_notes_full​

get_tasks​

get_events​

get_reports​

get_tags​

get_profile​

search​

get_change_log​

process_note (Pro и Ultra)​

create_note (Pro и Ultra)​

create_task (Pro и Ultra)​

create_event (Pro и Ultra)​

update_note (Pro и Ultra)​

update_task (Pro и Ultra)​

complete_task (Pro и Ultra)​

update_event (Pro и Ultra)​

delete_note (Pro и Ultra)​

delete_task (Pro и Ultra)​

delete_event (Pro и Ultra)​

undo_change_log_entry (Pro и Ultra)​

restore_entity (Pro и Ultra)​

create_tag (Pro и Ultra)​

set_tag_pinned (Pro и Ultra)​

delete_tag (Pro и Ultra)​

restore_tag (Pro и Ultra)​

Лимиты ввода​

Обработка ошибок​

Примеры использования​

Чтение данных​

Запись данных (Pro и Ultra)​

Управление токеном​

Что можно спросить у AI-агента​

Важно знать​

Безопасность​

Приватность и передача данных​

Решение проблем​

Смотри также​

Два способа подключения

Требования по плану

Экран в приложении

Заблокировано (Free и Basic)

Выключено (Pro и Ultra, функция отключена)

Включено

Как включить

Подключение через OAuth

Claude Desktop / Cowork

Claude Code

Подключение по Bearer-токену

Cursor

Windsurf

Other

Codex

OpenClaw

Другие MCP-клиенты

Проверка подключения

Права доступа (scopes)

Что можно делать

Инструменты чтения (10) - Pro и Ultra

Инструменты записи (17) - Pro и Ultra

Справочник инструментов

get_notes

get_note

get_notes_full

get_tasks

get_events

get_reports

get_tags

get_profile

search

get_change_log

process_note (Pro и Ultra)

create_note (Pro и Ultra)

create_task (Pro и Ultra)

create_event (Pro и Ultra)

update_note (Pro и Ultra)

update_task (Pro и Ultra)

complete_task (Pro и Ultra)

update_event (Pro и Ultra)

delete_note (Pro и Ultra)

delete_task (Pro и Ultra)

delete_event (Pro и Ultra)

undo_change_log_entry (Pro и Ultra)

restore_entity (Pro и Ultra)

create_tag (Pro и Ultra)

set_tag_pinned (Pro и Ultra)

delete_tag (Pro и Ultra)

restore_tag (Pro и Ultra)

Лимиты ввода

Обработка ошибок

Примеры использования

Чтение данных

Запись данных (Pro и Ultra)

Управление токеном

Что можно спросить у AI-агента

Важно знать

Безопасность

Приватность и передача данных

Решение проблем

Смотри также