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

Что нового

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

План Pro и выше

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

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

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

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

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

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

Экран 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-клиента.

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

Четыре вкладки в Setup-пикере внутри приложения (Claude Code, Cursor, Windsurf, Other) совпадают с разделами ниже. Замени YOUR_TOKEN на свой токен из настроек во всех примерах.

Claude Code

Выполни команду в терминале:

claude mcp add telldone --transport http \
  https://api.telldone.app/mcp/user/mcp \
  --header "Authorization: Bearer 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}'

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

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

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

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

подсказка

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

Инструменты записи (11) - 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	Удалить событие

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

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

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 (не включительно)

Возвращает: список заметок с 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[].

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

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, completed_at, completed_by, source, created_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, created_at.

примечание

get_events не возвращает attendees, reminder_minutes и recurrence_rule. Эти поля можно записывать через create_event/update_event, но в ответ списка они не включаются. Если они нужны - запроси родительскую заметку через get_note.

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 для более быстрого текстового поиска.

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 события

Лимиты ввода

Поле	Макс. длина	Используется в
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 запр/с)

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

Все примеры используют 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 запросов в секунду. Для массовых операций делай паузы между запросами.

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

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

Смотри также

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

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

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

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

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

Включено​

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

Подключение AI-инструмента​

Claude Code​

Cursor​

Windsurf​

Other​

Codex​

OpenClaw​

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

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

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

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

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

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

get_notes​

get_note​

get_notes_full​

get_tasks​

get_events​

get_reports​

get_tags​

get_profile​

search​

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)​

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

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

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

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

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

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

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

Важно знать​

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

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

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

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

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

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

Включено

Как включить

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

Claude Code

Cursor

Windsurf

Other

Codex

OpenClaw

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

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

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

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

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

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

get_notes

get_note

get_notes_full

get_tasks

get_events

get_reports

get_tags

get_profile

search

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)

Лимиты ввода

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

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

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

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

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

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

Важно знать

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

Смотри также