Notion — стандартная база знаний для тысяч команд. OpenClaw с MCP-интеграцией умеет читать и писать в Notion: ведёт документацию, создаёт отчёты, обновляет базы данных, отвечает на вопросы по корпоративным wiki.

Настройка MCP-сервера для Notion

Есть готовый официальный MCP-сервер от Notion (с марта 2026):

npm install -g @notionhq/mcp-server

Добавьте в конфиг OpenClaw:

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@notionhq/mcp-server"],
      "env": {
        "NOTION_API_KEY": "secret_ваш_ключ_здесь"
      }
    }
  }
}

Получить API-ключ:

Откройте notion.so → Settings → Integrations
Create new integration
Дайте доступ к нужным страницам (Share → Invite → ваша интеграция)

Что умеет интеграция

Официальный MCP предоставляет инструменты:

search — поиск по Notion
get_page — читать страницу
create_page — создавать страницу
update_page — обновлять содержимое
query_database — запросы к базам данных
create_database_item — создавать записи в БД

Сценарий 1: Автоматическая документация

После каждого PR агент обновляет Notion:

> После успешного мержа PR #234 в GitHub:
  1. Прочитай описание PR и изменённые файлы
  2. Обнови страницу "API Changelog" в Notion (добавь запись о новом эндпоинте)
  3. Если изменилась схема БД — обнови "Database Schema" страницу
  4. Создай задачу в Notion для тестировщика

  База: workspace/notion-pages.json (маппинг разделов)

Сценарий 2: Еженедельный отчёт в Notion

> Каждую пятницу в 17:00:
  1. Собери данные за неделю: GitHub (commits, PRs), Jira (закрытые задачи)
  2. Создай страницу "Weekly Report - [дата]" в Notion
  3. Структура: Что сделано / Что в процессе / Блокеры / На следующей неделе
  4. Уведоми команду в Telegram: "Отчёт за неделю готов: [ссылка]"

Сценарий 3: Ответы на вопросы по базе знаний

Подключите Notion как источник данных для RAG:

> Ты — ассистент поддержки. База знаний: Notion workspace компании.
  Когда тебя спрашивают о процессах, политиках, инструкциях —
  ищи ответ в Notion через search и get_page.

  Если ответа нет в базе — скажи об этом и предложи кому написать.
  Не выдумывай информацию которой нет в базе.

Сценарий 4: Синхронизация задач

> Когда в Jira создаётся задача с тегом "documentation-needed":
  1. Создай страницу в Notion в разделе "Нужна документация"
  2. Заполни: название задачи, описание, ответственный
  3. Добавь ссылку на Jira задачу
  4. Назначь reminder через 5 дней

  Используй webhook от Jira для триггера.

Сценарий 5: Обновление корпоративной вики

> Проверь страницы Notion в разделе "Технические гайды" на актуальность.
  Критерий устаревания: упоминают версии Node.js 18-, Python 3.9-, npm 8-.

  Для каждой устаревшей страницы:
  1. Пометь как "Требует обновления" (добавь тег)
  2. Создай задачу в Notion DB "Tech Debt" с описанием что обновить
  3. Пришли мне список страниц требующих обновления

Структура данных: базы данных Notion

Notion Database — таблица с типизированными полями. Через MCP можно делать запросы:

> Запроси из базы данных "Клиенты" (ID: abc123def):
  - Клиенты у которых план Enterprise
  - Дата последнего звонка > 30 дней назад
  - Статус не равен "Churned"

  Выведи: название компании, контакт, дата последнего контакта.
  Отсортируй по дате (самые давние первыми).

Автоматическое ведение meeting notes

> После каждой встречи в Google Calendar с тегом "recorded":
  1. Получи транскрипт встречи (через Google Meet API)
  2. Создай страницу в Notion "Meeting: [название] - [дата]"
  3. Структура: Участники / Повестка / Ключевые решения / Action items
  4. Для каждого action item: создай задачу в Notion и назначь ответственного

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

Минимальные права: давайте интеграции доступ только к тем страницам и базам данных, которые нужны. Не открывайте весь workspace.

Конфиденциальные данные: зарплаты, персональные дела сотрудников, финансовые детали — не должны быть доступны интеграции.

Аудит: в Notion доступен log действий (Settings → Audit Log) — проверяйте что интеграция делает.

Часто задаваемые вопросы

Можно ли читать страницы с базой данных? Да, через query_database с фильтрами.

Поддерживаются ли вложенные страницы? Да, но нужно явно давать доступ к каждой родительской странице.

Работает ли с Notion Team/Enterprise? Да, API доступен на всех тарифах.

Как обновить только часть страницы? Через блоки — API работает на уровне блоков Notion.

Итог

Интеграция OpenClaw + Notion превращает базу знаний из статичного репозитория в живой инструмент: она обновляется автоматически, агент отвечает на вопросы по ней, и документация перестаёт устаревать.

Читайте также: Создание MCP-сервера и GitHub интеграция.