MCP Notion — Claude в вашей базе знаний

Почему это важно именно вам

У большинства директоров Notion — это живое хранилище рабочей памяти. Базы данных задач, протоколы встреч, реестры проектов, страницы с аналитикой. Если вы используете Notion как рабочий инструмент, то знаете характерную боль: добавить запись в базу встреч — три клика, открыть нужный шаблон, вставить текст вручную, заполнить поля. Раз в день — терпимо. Раз в неделю после тяжёлой встречи — уже раздражает.

MCP-сервер Notion меняет эту механику. Claude получает прямой доступ к вашему рабочему пространству: может читать страницы и базы данных, создавать новые записи, обновлять существующие. Вместо «открыть Notion → найти базу встреч → добавить запись» вы говорите: «добавь итог сегодняшней встречи с маркетинговым агентством в базу встреч, статус — требует решения». Claude находит нужную базу, создаёт запись с правильными полями и подтверждает. Встреча позади, запись сделана, вы не открывали Notion.

Это не экономия трёх кликов. Это убирает трение между разговором и документированием. Когда между мыслью и записью нет препятствия — документируют регулярно. Когда есть — откладывают до «потом», а потом уже не помнят детали.

Что это такое

Notion MCP-сервер — это мост между Claude и вашим Notion-рабочим пространством. Он работает по тому же принципу, что мы разбирали в Дне 51: MCP-сервер переводит запросы Claude в вызовы Notion API и возвращает ответы обратно.

Хорошая аналогия — личный референт, которому дали доступ к вашей базе данных. Вы говорите ему «найди все задачи в работе» или «добавь новый контакт» — он идёт в систему и делает это. Вы не объясняете ему, как работает интерфейс Notion. Вы говорите на языке задач.

Важно понимать разницу между двумя способами использовать Notion вместе с Claude. Первый способ — скопировать текст из Notion, вставить в чат Claude, получить ответ. Это работает, но требует ручных действий каждый раз. Второй способ — MCP: Claude сам обращается к Notion, читает нужные данные, создаёт записи. Вы не посредник, вы постановщик задачи.

Есть и ещё одно отличие от простого копирования: Claude через MCP видит структуру. Когда вы копируете текст страницы Notion в чат — Claude видит неформатированный текст. Через MCP Claude видит блоки, свойства базы данных, типы полей. Это позволяет ему работать со структурированными данными точно, а не пытаться угадать формат из сплошного текста.

Официальный Notion MCP-сервер поддерживает несколько операций:

Чтение контента:
- Получить содержимое любой страницы по ссылке или ID
- Прочитать записи из базы данных с фильтрами
- Найти страницы и базы данных по тексту
- Получить дочерние блоки страницы

Запись и создание:
- Создать новую страницу в рабочем пространстве или как дочернюю
- Добавить запись в базу данных с заполнением свойств
- Обновить содержимое страницы
- Добавить комментарий

Аутентификация проходит через OAuth: Notion попросит вас войти в аккаунт и выдать разрешения конкретным страницам или рабочему пространству. Claude не получает ваш пароль — только токен с ограниченным доступом.

Как работает на практике

Подключение занимает около десяти минут. Разберём пошагово.

Шаг 1. Убедитесь, что Claude Code установлен и работает

Откройте терминал и проверьте:

claude --version

Должно вернуть версию (2.1.x и выше). Если не установлен — День 1 курса.

Шаг 2. Добавьте Notion MCP-сервер в конфигурацию

Claude Code хранит MCP-серверы в файле настроек. Добавить официальный Notion-сервер можно одной командой:

claude mcp add --transport http notion https://mcp.notion.com/mcp

Флаги:
- --transport http — тип подключения. Notion работает через HTTP (это называется Streamable HTTP transport). В отличие от stdio-серверов, которые запускаются локально, этот сервер работает на серверах Notion.
- https://mcp.notion.com/mcp — адрес официального MCP-сервера Notion.

{
  "mcpServers": {
    "notion": {
      "type": "http",
      "url": "https://mcp.notion.com/mcp"
    }
  }
}

Шаг 3. Авторизуйтесь в Notion через OAuth

Запустите Claude:

claude

Авторизацию нужно пройти самому: /mcp внутри сессии или claude mcp login notion из терминала (по SSH — с флагом --no-browser). В терминале появится ссылка — откройте её в браузере. Notion попросит:

1. Войти в аккаунт Notion (если ещё не вошли)
2. Выбрать рабочее пространство
3. Указать, к каким страницам давать доступ — можно дать доступ ко всему рабочему пространству или только к выбранным страницам

После подтверждения Claude Code получает токен и сохраняет его. При следующем запуске авторизация не потребуется.

Шаг 4. Проверьте подключение

Спросите Claude напрямую:

Что ты можешь делать в Notion?

Claude перечислит доступные инструменты: поиск, чтение страниц, создание записей. Если инструменты не появились — проверьте, что OAuth завершился успешно, и перезапустите claude.

Шаг 5. Первый реальный запрос

Попробуйте простой запрос:

Найди в Notion все страницы, в названии которых есть слово "протокол"

Claude использует инструмент поиска, вернёт список страниц с названиями и ссылками. Если видите результаты — всё работает.

Теперь рабочие сценарии для директора.

Сценарий: добавить итог встречи в базу данных

У вас в Notion есть база данных «Встречи» со свойствами: Дата, Участники, Тема, Статус, Ключевые решения.

После встречи пишете Claude:

Только что завершил встречу с агентством Медиа-Планет. Обсудили бюджет на июль,
согласовали три канала: Яндекс.Директ, myTarget, Авито. Решение: увеличить бюджет
myTarget на 20%. Следующая встреча — через две недели. Добавь в базу встреч в Notion,
статус "Решение принято".

Claude найдёт базу «Встречи», определит схему полей, создаст запись с правильными свойствами. Вы получите подтверждение и ссылку на созданную запись.

Сценарий: найти задачи по статусу

Найди в базе данных задач Notion все задачи со статусом "В работе"
и покажи их списком с ответственными

Claude прочитает базу данных, применит фильтр по свойству «Статус», вернёт отформатированный список. Это занимает секунды вместо того, чтобы открывать Notion и фильтровать вручную.

Сценарий: прочитать страницу перед встречей

Прочитай страницу "Онбординг нового клиента" в Notion и дай краткое резюме
из трёх пунктов — что нужно сделать на первой встрече

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

Сценарий: создать страницу с отчётом

Вы получили от агентства данные по кампании, хотите зафиксировать анализ в Notion:

Создай в Notion страницу "Анализ кампании myTarget — июнь 2026" в разделе "Маркетинг".
Добавь следующие разделы: Ключевые показатели, Выводы, Следующие шаги.
Заполни их на основе этих данных: [вставьте данные из отчёта]

Claude создаёт страницу с нужной структурой, заполняет разделы на основе переданных данных. Это занимает секунды и избавляет от ручного форматирования.

Сценарий: поиск и работа с базой контактов

Если у вас в Notion есть база данных контактов:

Найди в базе контактов Notion все записи, где компания "Медиа-Планет",
и покажи имена и должности

Или сразу добавить нового:

Добавь в базу контактов Notion: Анна Смирнова, руководитель проектов,
компания "Медиа-Планет", email anna@example.com, познакомились на конференции сегодня

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

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

Ошибка 1: Claude не находит нужную базу данных или страницу

Причина чаще всего одна — страница не включена в доступ при OAuth. Во время авторизации Notion спрашивает, к чему давать доступ. Если вы выбрали «только выбранные страницы» и не добавили нужную базу данных — Claude её не видит.

Как исправить: откройте Notion → Настройки → Связанные приложения → найдите Claude Code → нажмите «Изменить доступ» и добавьте нужные страницы или базы данных.

Ошибка 2: Claude создаёт запись, но не заполняет нужные поля

Свойства в Notion бывают разных типов: текст, дата, статус, multi-select, relation. Claude понимает схему, но если вы не указали значение — он оставит поле пустым или поставит значение по умолчанию.

Как исправить: в запросе явно называйте поля. Не «добавь встречу» — а «добавь встречу, дата — сегодня, статус — Запланирована, участники — Иван Петров». Чем конкретнее запрос, тем точнее заполненная запись.

Ошибка 3: Запрос работает медленно

Если Notion MCP отвечает заметно дольше, чем локальные инструменты — это нормально. HTTP-транспорт через серверы Notion добавляет задержку сети. Операции чтения одной страницы — быстрые. Поиск по всему рабочему пространству или чтение большой базы данных с сотнями записей — медленнее.

Как исправить: сужайте запросы. Вместо «найди все задачи» — «найди задачи в базе "Задачи Q2" со статусом В работе». Чем точнее указан источник, тем быстрее ответ.

Ошибка 4: Авторизация сбрасывается после обновления Claude Code

Иногда после обновления Claude Code OAuth-токен перестаёт работать. Симптом: Claude сообщает об ошибке авторизации при обращении к Notion-инструментам.

Как исправить: запустите claude и попробуйте любой запрос к Notion — если токен устарел, автоматически запустится новый OAuth-поток. Просто пройдите авторизацию заново.

Когда нужно / когда нет

Notion MCP нужен, если:
- Notion — ваш основной инструмент для рабочих записей, задач и протоколов
- Вы регулярно добавляете однотипные записи в базы данных (встречи, задачи, контакты, идеи)
- Хотите, чтобы Claude мог читать и учитывать информацию из Notion без ручного копирования в чат
- Используете Claude для обработки встреч, интервью или документов — и хотите, чтобы итоги сразу попадали в Notion

Notion MCP избыточен, если:
- Notion у вас для хранения, а не для работы — обращаетесь к нему раз в неделю
- Основная работа с документами в других инструментах (Google Docs, Confluence, SharePoint)
- Нет структурированных баз данных — только свободные страницы с текстом. В этом случае проще передавать контент в чат вручную

Совет по области доступа:

Если в вашем рабочем пространстве Notion смешаны личные и рабочие страницы — создайте отдельное рабочее пространство только для профессионального контента и подключайте именно его. Это и порядок, и чёткая граница: что Claude может видеть, а что нет.

Связь с другими уроками

День 51 — MCP: что это и зачем. Базовая концепция MCP-серверов, транспорты, scopes. Если вы не читали — начните оттуда. Notion MCP — практический пример того, что описано в День 51.

День 54 — MCP GitHub. Та же архитектура, но для работы с репозиториями и задачами GitHub. Если у вас проекты ведутся в GitHub Projects, а документация в Notion — эти два MCP-сервера хорошо работают вместе: задача в GitHub, протокол в Notion.

День 21 — субагенты и специализированные агенты. Когда Notion MCP подключён, имеет смысл создать субагента специально для работы с базой знаний — с инструкциями о структуре вашего рабочего пространства, названиях баз данных и правилах записи. Такой агент будет работать точнее, чем запросы «в лоб».

Задание на сегодня

Подключите Notion MCP и создайте одну запись в любой базе данных.

Конкретные шаги:
1. Выполните claude mcp add --transport http notion https://mcp.notion.com/mcp
2. Запустите claude
3. Запустите вход: claude mcp login notion (или /mcp внутри сессии) и подтвердите доступ в браузере
4. Напишите Claude: «Добавь тестовую запись в базу данных [название вашей базы] в Notion»

Критерий «выполнено»: в вашей базе данных Notion появилась новая запись, созданная Claude. Неважно, что там написано — важно, что запись создана через MCP без открытия Notion вручную.

Если базы данных нет — создайте простую: в Notion нажмите «Новая страница» → «Таблица» → добавьте три столбца: Название, Дата, Статус. Этого достаточно для первого теста.

Резюме

• Notion MCP-сервер подключается одной командой: claude mcp add --transport http notion https://mcp.notion.com/mcp
• Авторизация через OAuth: Claude получает токен доступа, пароль не передаётся
• Claude умеет читать страницы и базы данных, создавать и обновлять записи с правильными свойствами
• Главное ограничение: доступ только к тем страницам, которые вы явно разрешили при OAuth — это также ваша защита
• Особенно полезно для регулярного документирования: итоги встреч, задачи, контакты — всё добавляется голосом или текстом без открытия Notion