Как подключить Notez к Claude, Cursor и Windsurf по MCP

AIDenis Povarov20 августа 2026 г.

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

MCP-сервер Notez восполняет этот пробел. Model Context Protocol — открытый стандарт, по которому ассистенты подключаются к внешним инструментам и данным, и у Notez есть MCP-сервер, который открывает по нему доступ к вашему рабочему пространству.

Настройка

1. Создайте ключ. В Notez откройте Настройки → Интеграции, найдите MCP-сервер Notez и нажмите Создать ключ MCP. Скопируйте адрес сервера и bearer-токен: токен показывается один раз.

2. Добавьте его в клиент. На странице интеграций есть готовая команда для Claude Code, в которую уже подставлены ваш адрес и токен, а также JSON-конфигурации для Claude Code, Cursor и Windsurf с указанием, в какой файл их положить. Claude (в браузере, на компьютере и на телефоне), ChatGPT и VS Code ключ не используют: они подключаются через вход в аккаунт в карточке Подключите ИИ-приложение на той же странице.

Копируйте с этой страницы, а не набирайте вручную: заголовок авторизации должен быть точным до символа, иначе ни один вызов не пройдёт.

3. Перезапустите клиент и спросите его что-нибудь о ваших заметках.

Инструменты

Ключ даёт ассистенту 31 инструмент: 13 для чтения и 18 для записи. В таблице — те, к которым он обращается в первую очередь, а полный список есть в статье Настройка MCP-сервера.

Инструмент	Что делает
`get_current_workspace`	К какому рабочему пространству привязан ключ
`list_notes`	Поиск и список заметок с фильтрами и постраничной выдачей
`get_note`	Одна заметка, кратко или целиком
`get_note_children`	Прямые дочерние заметки
`get_note_ancestors`	Цепочка родительских заметок до корня
`list_tags`	Все теги с числом заметок
`search_similar_notes`	Семантический поиск по смыслу, до 5 результатов
`get_board`	Канбан-доска с карточками по колонкам
`create_note`	Создать заметку, Markdown поддерживается
`edit_note_content`	Изменить часть заметки, не трогая остальное
`move_note_to_board_column`	Перенести карточки между колонками доски
`delete_note` / `restore_note`	Переместить заметку в корзину или вернуть её

list_notes ищет по подстроке и фильтрует по тегам, колонкам доски, значениям свойств, датам создания и изменения, типу заметки, избранному, заметкам верхнего уровня и корзине, а ещё сортирует и выдаёт результаты постранично. Так ассистент ориентируется в большом рабочем пространстве и не тянет всё в контекст.

Два ограничения, о которых стоит знать заранее

Структуру он не удаляет. Ключ даёт доступ на чтение и запись: ассистент создаёт, редактирует и переименовывает заметки, ставит им теги, переносит их, удаляет в корзину и восстанавливает. Но ни один инструмент не удаляет тег, свойство, вариант значения или колонку доски, это остаётся за вами. ИИ-чат в приложении работает на тех же инструментах, кроме двух для загрузки файлов.

Ключ привязан к рабочему пространству. Ключ, созданный в пространстве «Работа», даёт доступ только к нему. Чтобы дать доступ ко второму пространству, переключитесь на него и создайте отдельный ключ. Перевыпустить любой ключ можно на том же экране.

Для чего это нужно на практике

Записать итог сессии. Самый ценный момент отладки — сразу после того, как всё заработало, и именно тогда меньше всего хочется что-то записывать. «Создай заметку „Исчерпание пула Postgres“ с тем, что мы сейчас выяснили, и поставь тег infra». Готово ещё до того, как вы закрыли терминал.

Вернуть прежний контекст. «Прежде чем проектировать, найди в моих заметках всё про ограничение частоты запросов». Ассистент читает, к какому выводу вы пришли раньше, а не выводит всё заново, возможно, по-другому.

Подготовка к встрече. «Найди все мои заметки с тегом acme за последние два месяца и перескажи нерешённые вопросы».

Видно, кто что написал. У заметок, созданных через MCP, есть значок MCP, так что всегда понятно, что написал ассистент, а что вы.

Безопасность ключа

Ключ MCP даёт доступ на чтение и запись ко всему рабочему пространству. Обращайтесь с ним как с любыми другими учётными данными: он показывается один раз, хранится в файле конфигурации клиента, и если он утёк, его нужно перевыпустить. Это один клик на странице интеграций, и старый ключ сразу перестаёт работать.

Главная защита здесь — привязка к рабочему пространству. Если личные и рабочие заметки лежат в разных пространствах, а я советую именно так, то ключ в рабочем проекте не доберётся ни до чего личного. Это проверяет сервер при каждом вызове инструмента, а не инструкции в промпте.