Notion MCP Server

Notion MCP — это удаленный MCP-сервер, реализующий протокол Model Context Protocol для Notion API. Разработанный с использованием TypeScript и распространяемый под лицензией MIT, этот продукт предоставляет мощные инструменты для взаимодействия искусственного интеллекта с Notion.

Преимущества

• Простая установка — стандартная OAuth-аутентификация без необходимости настройки JSON или API-токенов.
• Оптимизированное потребление токенов — инструменты специально разработаны для эффективного взаимодействия с AI-агентами.
• Два режима транспорта:
  • STDIO Transport (по умолчанию) — стандартный ввод-вывод для коммуникации.
  • Streamable HTTP Transport — для веб-приложений или клиентов, предпочитающих HTTP-коммуникацию.

Доступные API-эндпоинты

• Получение дочерних блоков.
• Получение информации о бот-пользователе вашего токена.
• Получение информации о пользователе.
• Получение списка всех пользователей.
• Добавление дочерних блоков.
• Обновление свойств страницы.
• Запросы к базе данных.

Технические требования

• Токен интеграции Notion.
• Аутентификация с помощью Bearer-токена для HTTP-транспорта.
• Доступность сервера по адресу http://0.0.0.0:<порт>/mcp при использовании Streamable HTTP Transport.

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

• Ограниченный набор API Notion (например, невозможно удалить базы данных через MCP).
• Возможность настройки прав доступа интеграции (например, создание интеграции только для чтения).

1. Создайте облачную сеть и подсеть, в которой будет находиться виртуальная машина (ВМ).

2. Создайте группу безопасности в созданной облачной сети и добавьте правило:

   Направление трафика	Описание	Диапазон портов	Протокол	Источник / Назначение	CIDR-блоки
   Входящий	mcp-notion	3000	TCP	CIDR	0.0.0.0/0

3. Получите пару SSH-ключей для подключения к ВМ.

4. Создайте сервисный аккаунт и назначьте ему роль lockbox.payloadViewer.

5. Создайте секрет Yandex Lockbox с двумя ключами:

   • YC_NOTION_TOKEN — токен интеграции Notion. Его можно получить в настройках интеграции Notion.
   • YC_AUTH_TOKEN — произвольный токен для аутентификации запросов к MCP-серверу. Должен быть сложным, его необходимо придумать самостоятельно.

6. В Cloud Marketplace найдите продукт Notion MCP Server и нажмите Создать ВМ.

7. Задайте настройки приложения:

   1. В блоке Конфигурация продукта:

      • В поле Notion Token выберите созданные ранее идентификатор секрета, идентификатор версии секрета и ключ YC_NOTION_TOKEN.
      • В поле Auth Token выберите созданные ранее идентификатор секрета, идентификатор версии секрета и ключ YC_AUTH_TOKEN.

   2. В блоке Сетевые настройки укажите облачную сеть, подсеть и группу безопасности, созданные ранее.

   3. В блоке Доступ укажите имя пользователя и SSH-ключ для подключения к ВМ, созданный ранее.

   4. В блоке Дополнительно укажите ранее созданный сервисный аккаунт.

8. Нажмите кнопку Создать ВМ и дождитесь создания виртуальной машины.

После установки:

• MCP-сервер будет доступен по адресу http://<IP-адрес_ВМ>:3000/mcp.
• Для аутентификации используйте заголовок Authorization: Bearer <YC_AUTH_TOKEN>.

Для проверки работоспособности выполните тестовый запрос:

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <YC_AUTH_TOKEN>" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "0.1",
      "clientInfo": { "name": "curl", "version": "0.1" },
      "capabilities": {}
    }
  }' \
  http://<IP-адрес_ВМ>:3000/mcp

Автоматическое создание заметок о встречах

> Создай заметку о встрече с клиентом завтра в 15:00 по проекту "Оптимизация маркетинговой стратегии".

Создаю новую страницу в Notion с информацией о встрече.

Страница успешно создана:
- Название: "Встреча: Оптимизация маркетинговой стратегии".
- Дата: [завтрашняя дата], 15:00.
- Тип: Встреча с клиентом.
- Статус: Предстоит.
- Добавлен шаблон для записи результатов встречи.

Анализ и резюмирование документов

> Проанализируй последний квартальный отчет в базе данных "Финансовые отчеты" и создай краткое резюме основных показателей.

Выполняю поиск в базе данных "Финансовые отчеты"...
Нашел документ "Квартальный отчет Q3 2024".
Анализирую содержимое...

Резюме успешно добавлено в Notion:
- Выручка: увеличение на 12% по сравнению с предыдущим кварталом.
- Операционные расходы: снижение на 5%.
- Чистая прибыль: рост на 18%.
- Ключевые факторы роста: запуск нового продукта и расширение на азиатский рынок.

Управление задачами проекта

> Обнови статус задачи "Разработка прототипа" в проекте "Новый веб-сайт" на "Завершено" и добавь комментарий о результатах тестирования.

Ищу задачу "Разработка прототипа" в проекте "Новый веб-сайт"...
Задача найдена.

Задача успешно обновлена:
- Статус изменен на "Завершено".
- Добавлен комментарий: "Тестирование прототипа завершено успешно. Все основные функции работают корректно. Обнаружено 3 незначительных бага, которые будут исправлены в следующей итерации".
- Автоматически создана новая задача "Исправление багов прототипа" со статусом "К выполнению".

Служба технической поддержки Yandex Cloud отвечает на запросы 24 часа в сутки, 7 дней в неделю. Доступные виды запросов и срок их обработки зависят от тарифного плана. Подключить платную поддержку можно в консоли управления. Подробнее о порядке оказания технической поддержки.