Notion MCP — официальный сервер Notion для подключения ИИ-агентов

Notion давно был удобным местом для базы знаний, но подключить его к ИИ-инструментам раньше было болью: интеграция, токены, ручная выдача доступа каждой странице, хрупкие self-hosted MCP-серверы. В 2025 году Notion выкатил свой официальный хостинг-сервер Model Context Protocol и сделал его рекомендуемым способом работать с Notion из ChatGPT, Claude, Cursor и любого другого MCP-клиента.

Что это такое

Notion MCP — это собственный hosted-сервер 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), выдаёте доступ к нужным страницам и базам.
• Агент видит ваше рабочее пространство ровно в тех границах, в каких его видите вы: жёстко по вашим правам в Notion.

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

Основные возможности

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

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

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

Страницы

• notion-create-pages — создаёт одну или несколько страниц с свойствами, контентом, иконкой и обложкой, умеет применять шаблоны базы данных.
• notion-update-page — правит свойства, контент, иконку, обложку. Может наложить шаблон на существующую страницу.
• notion-move-pages — перемещает страницы или базы под новый парент.
• 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 — структурные запросы по нескольким дата-источникам сразу: фильтры, группировки, ролапы, сводки. Требует 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 — списки команд, пользователей и инфа о самом боте.

Подключение

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

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

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

Для Cursor / VS Code / Claude Code в конфиг MCP добавляется одна секция:

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

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

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

При первом вызове MCP-клиент откроет экран Notion. Вы:

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

Шаг 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: агент физически не видит того, чего не видите вы.

Практические сценарии

Работа с PRD и техническими спеками. Агент в IDE (Cursor, Codex CLI) видит ваши спеки и базы задач в Notion. По одному промпту он читает спеку, пишет код, отмечает задачу как Done и оставляет комментарий со ссылкой на PR.

Конструктор базы знаний. Через ChatGPT или Claude вы голосом или текстом диктуете: «собери обзор о такой-то технологии» — и агент сам создаёт страницу в нужной базе с правильными свойствами.

CRM и проекты. На выходе из встречи агент разладивает транскрипт и раскладывает итоги по страницам клиентов, обновляет статусы сделок, создаёт задачи с правильными исполнителями.

Собственные агенты. Если вы пишете свой MCP-клиент (LangGraph, свой runtime, n8n-блок), Notion MCP подключается как обычный OAuth-источник и даёт весь этот набор tools «из коробки».

Наполнение «живого сайта». Notion под капотом как CMS + MCP как интерфейс — и агент без ручного API пишет и обновляет страницы базы знаний, статьи, блог-посты, которые были отрендерены на сайте.

Аудит и отчёты. notion-query-data-sources позволяет собрать «что в работе сразу по всем командам» и выдать сводку без ручной обходящей логики в агенте.

Ссылки

• Официальный справочник Notion MCP: developers.notion.com/docs/mcp
• Подключение: developers.notion.com/guides/mcp/get-started-with-mcp
• Полный список tools: developers.notion.com/guides/mcp/mcp-supported-tools
• Open-source сервер (deprecated, но жив): github.com/makenotion/notion-mcp-server
• Спецификация Model Context Protocol: modelcontextprotocol.io
• Блог-разбор от команды Notion: notion.com/blog/notions-hosted-mcp-server-an-inside-look

По теме

• Статья: Как два ИИ-агента и один человек собрали этот сайт за ночь
• Блог: Страница, собранная в прямом эфире моего вебинара
• База знаний: MCP (Model Context Protocol) — стандарт подключения ИИ к внешним системам

Если вы уже живёте в Notion и начинаете встраивать в работу ИИ-агентов, Notion MCP — самый быстрый способ связать эти два мира. Хотите обсудить, как разложить MCP-доступ и роли агентов под вашу команду, — напишите в Telegram, разберём вместе.