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
• Для HTTP-транспорта требуется аутентификация с помощью bearer-токена
• При использовании Streamable HTTP Transport сервер доступен по адресу http://0.0.0.0:<порт>/mcp

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

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

Инструкция по запуску Notion MCP сервера

1. Создайте сервисный аккаунт и назначьте ему роль lockbox.payloadViewer;
2. Создайте секрет в Lockbox с двумя параметрами:
   • YC_NOTION_TOKEN — токен интеграции Notion (получите его в настройках интеграции Notion)
   • YC_AUTH_TOKEN — произвольный токен для аутентификации запросов к MCP серверу (придумайте сложный пароль)
3. В Marketplace найдите продукт Notion MCP Server и нажмите Установить;
4. В блоке Дополнительно укажите ранее созданный сервисный аккаунт;
5. В блоке Конфигурация продукта:
   • В поле Секрет Lockbox выберите созданный ранее секрет
6. Выберите подсеть с настроенным доступом в Интернет и создайте группу безопасности с разрешенным портом 3000;
7. Создайте виртуальную машину;
8. После установки:
   • MCP сервер будет доступен по адресу http://<IP адрес ВМ>:3000/mcp;
   • Для аутентификации используйте заголовок Authorization: Bearer <YC_AUTH_TOKEN>;
9. Для проверки работоспособности выполните тестовый запрос:

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

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

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

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

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

Сценарий 2: Анализ и резюмирование документов

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

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

Создаю резюме основных показателей:

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

Сценарий 3: Управление задачами проекта

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

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

Обновляю статус на "Завершено".
Добавляю комментарий о результатах тестирования.

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

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

Yandex Cloud не предоставляет техническую поддержку продукта. При возникновении проблем обращайтесь к информационным ресурсам разработчика.