Notion MCP: подключаем базу знаний к локальному ИИ
Подключаем официальный Notion MCP к Доке через OAuth: поиск по базе знаний, отчёты и обновление страниц без копирования заметок в чат.
База знаний полезна ровно до тех пор, пока в ней можно что-то найти. Когда страниц становится несколько сотен, вопрос «где мы записали решение по релизам?» снова уходит в рабочий чат. Notion MCP позволяет задать его агенту: тот сам найдёт нужные страницы, сведёт факты и, если разрешить, обновит документ.
Что можно делать через Notion MCP
Официальный сервер Notion умеет искать по рабочему пространству, читать и создавать страницы, обновлять задачи и собирать отчёты из нескольких источников. Сценарии вполне земные:
- собрать решения по проекту из протоколов встреч;
- превратить заметки об исследовании в черновик технического задания;
- подготовить статус за неделю по базе задач;
- найти устаревшие инструкции и предложить новую редакцию.
Агент получает только тот доступ, который пользователь подтвердил через OAuth. Всё равно полезно начать с небольшой команды или отдельного пространства, а не открывать сразу всю корпоративную базу знаний.
Как подключить Notion MCP к Доке
Официальный Notion MCP работает
как удалённый сервер. Дока запускает MCP через локальный stdio, поэтому между ними
нужен рекомендованный Notion мост mcp-remote.
Открой в Доке «MCP-серверы» → «＋ Добавить сервер» и укажи:
- Название:
Notion. - Команда:
npx. - Аргументы, каждый с новой строки:
-y,mcp-remote,https://mcp.notion.com/mcp. - Переменные окружения: оставить пустыми.
При первом обращении откроется браузер: войди в Notion, выбери рабочее пространство и подтверди доступ. Токен вручную копировать не нужно. После авторизации попроси агента найти конкретную страницу — это самый простой тест.
Notion MCP умеет не только читать, но и менять страницы. Для первых задач формулируй «подготовь черновик, ничего не записывай», а изменения подтверждай отдельно.
Это локальная работа или облачная
Здесь важно не смешивать две вещи. Агент и модель могут работать на твоём компьютере, поэтому содержимое страниц не отправляется внешнему провайдеру модели. Но Notion — облачный сервис, а официальный MCP-сервер размещён у Notion. Запросы к базе знаний идут через их инфраструктуру.
Если нужен полностью изолированный контур, Notion как источник уже не подходит: тогда лучше хранить документы внутри сети и подключать локальное хранилище. Старый open-source сервер Notion с API-токеном существует, но сам Notion больше не считает его основным и активно поддерживаемым вариантом.
Как не получить кашу вместо ответа
Не проси «изучи весь Notion». Укажи область и критерий свежести: «используй страницы про проект X, обновлённые после 1 июня, и приложи ссылки на источники». Для отчёта заранее задай структуру: решения, открытые вопросы, ответственные, сроки.
Если агент должен обновить страницу, сначала попроси показать diff словами: что он добавит, удалит и почему. Это занимает лишнюю минуту, зато защищает живую базу знаний от бодрого, но неудачного редактирования.
Другие интеграции собраны в списке полезных MCP-серверов, а общая настройка полей разобрана в пошаговой инструкции.