Сервер Clean Notes MCP

Задачи канбан-доски и заметки по проектам для AI-клиентов с OAuth и отдельными правами на чтение и изменение для каждого проекта.

Clean Notes — рабочее пространство для небольших команд: канбан-доска с представлениями в виде списков и временной шкалы, заметки рядом с задачами, которые они поясняют, и обновления в реальном времени. Сервер MCP позволяет GitHub Copilot, ChatGPT, Claude и любому другому MCP-клиенту читать и изменять одобренные вами проекты — и никакие другие.

В этом репозитории описан размещённый сервер. Устанавливать или запускать что-либо локально не нужно: достаточно указать адрес сервера в клиенте и войти в систему.


Адрес сервера	`https://cleannotes.app/mcp`
Транспорт	Streamable HTTP, без состояния
Аутентификация	OAuth 2.1 с динамической регистрацией клиентов и PKCE. Не нужно копировать API-ключ или токен.
Инструменты	11: шесть для чтения, пять для изменения, без удаления
Имя в реестре	`app.cleannotes/clean-notes`

Для работы нужна учётная запись Clean Notes. Бесплатный тариф включает доступ для AI.

Настройка

VS Code с GitHub Copilot

Воспользуйтесь кнопкой установки выше или добавьте сервер в файл .vscode/mcp.json в рабочей области (либо в пользовательский файл mcp.json):

{
  "servers": {
    "clean-notes": {
      "type": "http",
      "url": "https://cleannotes.app/mcp"
    }
  }
}

Запустите сервер. Когда VS Code предложит войти в Clean Notes, разрешите это: в браузере откроется Clean Notes, где вы сможете войти в систему и выбрать проекты, к которым хотите предоставить доступ.

После этого инструменты появятся в Copilot Chat в режиме агента.

Claude Code

claude mcp add --transport http clean-notes --scope user https://cleannotes.app/mcp

Затем выполните /mcp в Claude Code и выберите Authenticate рядом с Clean Notes.

Claude (приложение и веб-версия)

Откройте Settings → Connectors → Add custom connector, вставьте

https://cleannotes.app/mcp и пройдите аутентификацию.

ChatGPT

Откройте плагин Clean Notes, подключите учётную запись и предоставьте доступ к нужным проектам.

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

Добавьте https://cleannotes.app/mcp как сервер Streamable HTTP и пройдите аутентификацию OAuth в браузере. Остальные сведения клиент получит по адресу https://cleannotes.app/.well-known/oauth-protected-resource.

Выберите, к каким данным сможет обращаться помощник

Вход в систему подтверждает вашу личность, но не открывает доступ ко всему рабочему пространству. Сразу после входа Clean Notes предложит выбрать проекты, к которым сможет обращаться это подключение, и указать для каждого из них, разрешено ли только чтение или также внесение изменений. Если ни для одного проекта не предоставлены права, подключение не сможет ничего прочитать.

Права предоставляются и отзываются в Clean Notes, в панели AI tools каждого проекта.
Владельцы проектов определяют, могут ли участники подключать собственные AI-инструменты.
Помощник не может удалять данные, изменять список участников, настройки или сведения об оплате.

Использование

Задавайте вопросы обычным языком, например:

«Какие задачи в моём проекте Launch просрочены или заблокированы и кто отвечает за каждую из них?»
«Создай задачи в моём проекте Launch по этим заметкам со встречи, назначив для каждой ответственного и срок выполнения».
«Отметь задачу о странице с ценами как выполненную и создай заметку по проекту с сегодняшними решениями».
«Что изменилось в проекте Website с понедельника?»

Инструменты

Инструмент	Доступ	Назначение
`clean_notes_list_projects`	чтение	Выводит список проектов, к которым может обращаться это подключение.
`clean_notes_get_project`	чтение	Возвращает проект, упорядоченные статусы и участников, которых можно назначать на задачи.
`clean_notes_list_tasks`	чтение	Выводит задачи с фильтрацией по статусу, исполнителю или времени последнего изменения; поддерживает курсор и ограничение количества результатов.
`clean_notes_get_task`	чтение	Возвращает задачу со всеми подробностями.
`clean_notes_list_notes`	чтение	Выводит заметки в виде кратких фрагментов; поддерживает курсор.
`clean_notes_get_note`	чтение	Возвращает полный текст заметки.
`clean_notes_create_task`	изменение	Создаёт задачу с названием, описанием, статусом, приоритетом, исполнителем и датами.
`clean_notes_update_task`	изменение	Изменяет поля задачи.
`clean_notes_complete_task`	изменение	Отмечает задачу как выполненную.
`clean_notes_create_note`	изменение	Создаёт заметку с названием и текстом; при необходимости закрепляет её.
`clean_notes_update_note`	изменение	Изменяет название, текст или состояние закрепления заметки.

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

Безопасный повтор запросов

Для каждой операции записи требуется ключ идемпотентности. Повторный запрос возвращает результат первой операции, а не создаёт дубликат задачи или заметки.
При обновлении и завершении задачи передаётся значение expectedUpdatedAt записи. Если другой пользователь успел внести изменения, запрос завершается конфликтом, а не перезаписывает его правки. После этого помощник повторно считывает запись и пробует снова.
Каждый инструмент работает только с данными в пределах разрешённого доступа: он читает и изменяет только авторизованные проекты и никогда не обращается к интернету.
В каждом проекте ведётся журнал действий AI с указанием клиента, инструмента, времени и результата. В журнале хранятся метаданные, но не содержимое запросов.

Стоимость

Доступ для AI включён во все тарифы. В месячную квоту входят только успешно выполненные изменения; чтение, конфликты и отклонённые запросы бесплатны.

Тариф	Стоимость	Изменения с помощью AI в месяц
Free	$0	50
Pro	$4.90 в месяц	5,000
Scale	$14.90 в месяц	25,000

Оплата зависит от проектов, которые вы создаёте, поэтому приглашённым пользователям не нужно платить за место в команде. Подробнее см. на странице тарифов.

Ссылки

Документация: cleannotes.app/en/ai/mcp
Сайт: cleannotes.app
Поддержка: cleannotes.app/en/support или hello@cleannotes.app
Политика конфиденциальности · Условия использования

Clean Notes — проприетарный размещённый сервис. В этом репозитории содержится только общедоступная документация; исходный код сервера здесь не опубликован.