Для чего: дать ИИ читать и редактировать страницы/базы Notion (Markdown) прямо в рабочем пространстве.

Что это даёт ИИ

ИИ работает с твоим Notion как с базой знаний: ищет по воркспейсу, читает страницы и базы данных, создаёт и редактирует контент (в Markdown), заполняет свойства записей. Удобно превращать заметки в задачи, собирать сводки, наполнять базы — не выходя из чата.

Пример: «Из заметок встречи на странице X сделай список задач в базе Tasks с дедлайнами» — ИИ прочитает страницу и создаст записи с заполненными полями.

Подключение (точные шаги)

Два пути: хостед remote с OAuth (проще) или self-hosted npx с internal-токеном.

Claude Code

Рекомендуемый — remote-сервер (OAuth, без токенов вручную):

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

Затем /mcp → вход в Notion в браузере.

Self-hosted с internal integration token:

claude mcp add notion --env NOTION_TOKEN=ntn_ВАШ_ТОКЕН -- npx -y @notionhq/notion-mcp-server

Cursor / Claude Desktop

Self-hosted npx-вариант:

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "NOTION_TOKEN": "ntn_ВАШ_ТОКЕН"
      }
    }
  }
}

Remote-вариант — тот же блок с "type": "http" и "url": "https://mcp.notion.com/mcp".

Пример использования

Скажи: «Найди в Notion все страницы про онбординг и собери из них одну сводную» → ИИ выполнит поиск по воркспейсу, прочитает найденное и создаст сводную страницу. Или «добавь в базу CRM запись по новому лиду».

Безопасность

Минимум доступа: для self-hosted токена — создай internal integration (notion.so/profile/integrations) и поделись с ней только нужными страницами/базами через вкладку Access или «Connect to integration». Интеграция видит ровно то, что ей расшарили.
OAuth для remote: удобнее и без вечного токена; права отзываются в /mcp.
Токен ntn_... не коммить в репозиторий — держи в env/локальном scope.

Подводные камни

Частая ошибка: интеграция создана, но страницы ей не расшарены — ИИ «не видит» контент. Проверьте доступ в Access.
Запись реальная: ИИ может изменить/перезаписать страницу. На важных базах ограничьте доступ интеграции read-вариантом контента.
Большие базы/длинные страницы упираются в лимит вывода MCP — просите выборки и фильтры, а не «выгрузи всё».

Notion MCP