Notion MCP: подключаем Notion к ИИ-агенту за минуту

Notion MCP — это hosted MCP-сервер от Notion по адресу https://mcp.notion.com/mcp, который даёт ИИ-агенту безопасный доступ к рабочему пространству через OAuth. Подключение в один шаг, без токенов и ручных интеграций.

Что это

Notion MCP — собственный remote-сервер Model Context Protocol от Notion. MCP — открытый стандарт Anthropic, по которому агенты обращаются к внешним системам через набор tools. Notion MCP — конкретная реализация этого стандарта, которая живёт на стороне Notion и работает как обёртка над их публичным API.

Архитектура простая:

• ИИ-инструмент (Claude, ChatGPT, Cursor, VS Code, Codex, свой агент) поднимает внутри себя MCP-клиента.
• Клиент ходит по HTTP/SSE на https://mcp.notion.com/mcp.
• Пользователь логинится через OAuth, выдаёт доступ к нужным страницам и базам.
• Агент видит рабочее пространство ровно в границах прав пользователя в Notion.

Параллельно живёт open-source вариант makenotion/notion-mcp-server. Notion честно говорит: новые возможности и активная поддержка идут в remote-сервер. Self-hosted анонсирован как потенциально sunset-нутый — брать только для жёстко изолированных контуров.

Зачем нужно

• Подключить Notion к ИИ-агенту за минуты, а не за дни токенов и интеграций.
• Читать, искать, создавать и редактировать страницы, базы, view’ы из любого MCP-клиента.
• Использовать Notion как живую CMS для сайта, PRD-репозиторий для агента, CRM для команд.
• Не отдавать агенту ключи от всего workspace — выдавать доступ постранично через OAuth.

Как устроено

Notion MCP выдаёт агенту фиксированный набор tools. Каждый явно описан и вызывается по имени.

Поиск и чтение

• notion-search — поиск по workspace и, при наличии Notion AI, по подключённым источникам (Slack, Drive, Jira, Gmail).
• notion-fetch — забрать содержимое страницы, базы или data source по URL/ID. Для баз возвращает схему и шаблоны.

Страницы

• notion-create-pages — создаёт одну или несколько страниц со свойствами, контентом, иконкой, обложкой, умеет применять шаблоны базы.
• notion-update-page — правит свойства, контент, иконку, обложку, может наложить шаблон на существующую страницу.
• notion-move-pages — перемещает страницы или базы под новый parent.
• notion-duplicate-page — делает копию страницы (асинхронно).

Базы данных и view’ы

• notion-create-database — создаёт базу, первый data source и первый view.
• notion-update-data-source — меняет схему: добавляет свойства, переименовывает, правит описание.
• notion-create-view и notion-update-view — создают и редактируют представления: table, board, list, calendar, timeline, gallery, form, chart, map, dashboard. Поддерживают фильтры, сортировки, группировку.
• notion-query-data-sources — структурные запросы по нескольким data source сразу: фильтры, группировки, ролапы, сводки. Требует Enterprise + Notion AI.
• notion-query-database-view — вытаскивает данные из конкретного view с его фильтрами. Доступен на Business+ с Notion AI.

Комментарии и люди

• notion-create-comment, notion-get-comments — оставлять комментарии на странице или в конкретном блоке, читать дискуссии.
• notion-get-teams, notion-get-users, notion-get-user, notion-get-self — списки команд, пользователей, инфа о самом боте.

Нюанс OpenAI: в ChatGPT и других OpenAI-клиентах инструменты notion-fetch и notion-search появляются под короткими именами fetch и search — это требование спецификации Deep Research, а не баг.

Когда использовать

Совет: выдавайте доступ по принципу минимальных привилегий. Для работы с базой знаний — одно родительское пространство. Для полноценного агента — весь workspace, но без персональных разделов других участников.

Проверка	Что сделать
Выберите workspace.
Отметьте конкретные страницы и базы, к которым выдаёте доступ.
Подтвердите	клиент запомнит OAuth-токен и дальше ходит от вашего имени.

Тарифы и лимиты

• Notion MCP сам по себе бесплатен. Оплачивается тариф Notion (Free / Plus / Business / Enterprise) и ваш ИИ-клиент (Claude, ChatGPT и т. д.).
• Rate limits: до 180 запросов в минуту (3 RPS) на пользователя суммарно по всем тулам. Отдельный лимит для поиска — 30 запросов в минуту.
• Поиск по коннекторам (Slack, Drive, Jira, Gmail) в notion-search работает только с Notion AI. Без Notion AI поиск ограничен вашим workspace.
• notion-query-data-sources — Enterprise + Notion AI.
• notion-query-database-view — Business+ с Notion AI и только когда notion-query-data-sources недоступен.
• Скоуп доступа ограничен вашими правами в Notion: агент физически не видит того, чего не видите вы.

Trade-off: remote-сервер удобен и всегда актуален, но ваши запросы идут через инфраструктуру Notion. Если у вас жёсткие требования к комплаенсу или изолированному контуру, рассматривайте self-hosted вариант — с пониманием, что функционал там отстаёт.

Ограничения

Ограничение	Пояснение
Скоуп ограничен правами пользователя в Notion.	Если у пользователя нет доступа к странице, агент тоже не получит — это плюс, но и ограничение для командных сценариев.
notion-query-data-sources требует Enterprise + Notion AI	На младших тарифах агент работает поштучно через notion-fetch, без сводных ролапов.
Поиск по сторонним коннекторам (Slack, Drive, Jira, Gmail) включается только с Notion AI	отдельная лицензия сверх MCP.
Rate limit 3 RPS суммарно	для длинных batch-операций нужен throttling на стороне клиента.
Self-hosted makenotion/notion-mcp-server анонсирован как потенциально sunset-нутый	Не вкладывайтесь в его развитие, если не изолированный контур.
Remote-сервер пропускает все запросы через инфраструктуру Notion	для compliance-чувствительных сценариев это минус.

Антипаттерны

Антипаттерн	Почему опасно
Не делать — выдавать агенту доступ ко всему workspace сразу.	Минимальные привилегии — это и есть смысл OAuth-флоу.
Не делать — полагаться на notion-query-data-sources в продакшне, если у заказчика не Enterprise.	Лучше сразу проектировать обходной путь через notion-fetch.
Не делать — игнорировать rate limit 3 RPS.	Длинная batch-операция без throttling’а уронит сессию по 429-й.
Не делать — поднимать self-hosted сервер для фичи, которая в remote появится через неделю.	Сначала проверьте remote.

Чеклист

Проверка	Что сделать
MCP-клиент поддерживает remote-сервер по URL (Claude Desktop, Cursor, VS Code, ChatGPT, Codex CLI)	//mcp.notion.com/mcp, без токенов.
Пройден OAuth, доступ выдан только нужным страницам и базам, а не всему workspace	notion-search + notion-fetch вернули результат.
Для batch-операций добавлен throttling	не больше 3 RPS суммарно по всем tools.
Если нужны ролапы по data source	проверен тариф — notion-query-data-sources требует Enterprise + Notion AI.