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, а не баг.

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

Пошаговая инструкция подключения — это и есть сценарии, когда Notion MCP оправдан.

Шаг 1. Выберите MCP-клиент

Официально поддерживаются Claude Desktop, Claude Code, Cursor, VS Code, ChatGPT (Pro), Codex CLI, Windsurf. Для большинства есть установка в один клик в галерее Notion MCP.

Шаг 2. Добавьте сервер вручную (если нужно)

Для Cursor / VS Code / Claude Code в конфиг MCP добавляется одна секция. Больше ничего в конфиг класть не надо: ни токенов, ни ID интеграции. Авторизация пройдёт в браузере.

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

Шаг 3. Пройдите OAuth и выдайте доступ

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

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

Шаг 4. Проверьте связь

Первый запрос в агенте — простой. Если вызовы проходят без ошибок, связь работает.

«Найди в моём Notion все страницы с тегом PRD за последние 30 дней и сведи в список с ссылками».

Агент вызовет notion-search, затем notion-fetch по нужным URL и вернёт результат.

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

  • 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 добавлена секция mcpServers.notion.url = https://mcp.notion.com/mcp, без токенов.

Пройден OAuth, доступ выдан только нужным страницам и базам, а не всему workspace.

Первый запрос «найди и сведи» прошёл без ошибок

— notion-search + notion-fetch вернули результат.

Для batch-операций добавлен throttling:

не больше 3 RPS суммарно по всем tools.

Если нужны ролапы по data source — проверен тариф:

notion-query-data-sources требует Enterprise + Notion AI.

Ссылки

Ссылки

По теме

По теме