Notion MCP Server

Сервер Notion MCP

Сервер Model Context Protocol (MCP), который подключает Claude и других помощников ИИ к вашему рабочему пространству Notion. Эта интеграция позволяет помощникам ИИ взаимодействовать с вашими базами данных, страницами и блоками Notion.

Что это?

Этот инструмент действует как мост между помощниками ИИ (например, Клодом) и вашим рабочим пространством Notion. Он позволяет ИИ:

• Просмотр и поиск в базах данных Notion
• Создание и обновление страниц
• Управление блоками контента
• И многое другое!

Пошаговое руководство по настройке

Предпосылки

• Node.js (версия 14 или выше)
• Счет Notion
• Приложение Claude Desktop (при использовании с Claude)

1. Получение ключа API Notion

1. Перейдите по ссылке https://www.notion.so/my-integrations
2. Нажмите синюю кнопку «+ Новая интеграция».
3. Заполните данные:
   • Имя : выберите имя, например «Помощник Клода» или «Помощник ИИ».
   • Логотип : Необязательно
   • Связанное рабочее пространство : выберите рабочее пространство Notion
4. Нажмите «Отправить».
5. На следующей странице найдите раздел «Внутренний токен интеграции».
6. Нажмите «Показать» и скопируйте токен (он начинается с secret_ )

2. Настройка этого сервера

Загрузить репозиторий

Вариант A: Загрузить как ZIP (рекомендуется для новичков)

1. Перейдите в репозиторий GitHub: https://github.com/Sjotie/notionMCP/
2. Нажмите зеленую кнопку «Код» в правом верхнем углу.
3. Выберите «Загрузить ZIP»
4. После загрузки извлеките ZIP-файл в папку на вашем компьютере.
   • Windows: щелкните правой кнопкой мыши ZIP-файл и выберите «Извлечь все».
   • Mac: дважды щелкните ZIP-файл, чтобы извлечь его.

Вариант B: Клонирование с помощью Git (для пользователей, знакомых с Git)

1. Откройте командную строку или терминал.
   • Windows: нажмите Win+R , введите cmd и нажмите Enter.
   • Mac: Откройте Терминал из Приложения > Утилиты.
2. Перейдите туда, где вы хотите сохранить репозиторий.
   cd path/to/desired/location
3. Клонировать репозиторий
   git clone https://github.com/Sjotie/notionMCP/

Перейдите в каталог проектов.

После загрузки или клонирования вам необходимо перейти в папку проекта с помощью команды cd (изменить каталог):

Если вы скачали ZIP-файл (Вариант А):

1. Откройте командную строку или терминал.
2. Используйте команду cd , чтобы перейти к месту распаковки ZIP-файла:
   cd path/to/extracted/folder/notionMCP
   Например:
   • В Windows: cd C:\Users\YourName\Downloads\notionMCP
   • На Mac: cd /Users/YourName/Downloads/notionMCP

Если вы клонировали с помощью Git (вариант Б):

1. Репозиторий должен был быть клонирован в папку с именем «notionMCP».
2. Если после клонирования вы все еще находитесь в том же окне терминала, просто введите:
   cd notionMCP

Как узнать, что вы находитесь в правильном каталоге:

• После использования команды cd вы можете проверить свое текущее местоположение:
  • В Windows: введите dir и нажмите Enter — вы должны увидеть файлы типа server.js
  • На Mac: введите ls и нажмите Enter — вы должны увидеть файлы типа server.js

Установить зависимости

Оказавшись в каталоге notionMCP, установите необходимые зависимости:

Это установит все необходимые пакеты Node.js. Вы должны увидеть индикатор выполнения и, в конечном итоге, сообщение о том, что установка завершена. Это может быть что-то вроде «X Packages are looking for funding» — это совершенно нормально и означает, что все сработало.

3. Подключение к страницам Notion

В целях безопасности Notion требует явного предоставления доступа к каждой странице или базе данных:

1. Откройте Notion и перейдите на страницу или в базу данных, к которым вы хотите предоставить доступ ИИ.
2. Нажмите «•••» (три точки) в правом верхнем углу.
3. Выберите «Добавить соединения».
4. Найдите и выберите интеграцию, которую вы создали ранее.
5. Повторите эти действия для любых других страниц или баз данных, которые вы хотите сделать доступными.

4. Подключение к Claude Desktop

1. Найдите файл конфигурации Claude Desktop:
   • Windows: %APPDATA%\Claude\claude_desktop_config.json (введите этот путь в адресной строке проводника)
   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json (В Finder нажмите Cmd+Shift+G и вставьте этот путь)
2. Откройте файл в текстовом редакторе. Если его нет, создайте его со следующим содержимым:
   { "mcpServers": { "notion": { "command": "node", "args": [ "C:\\path\\to\\notion-mcp-server\\server.js" ], "env": { "NOTION_API_KEY": "your_notion_api_key_here" } } } }
3. Заменять:
   • C:\\path\\to\\notion-mcp-server\\server.js с фактическим путем к файлу server.js
     • Windows: используйте двойную обратную косую черту (\\) в пути
     • Mac: используйте косую черту (/)
   • your_notion_api_key_here с вашим ключом API Notion
4. Сохраните файл и перезапустите Claude Desktop.

5. Проверка соединения

1. Начать новый разговор на языке Клод
2. Попросите Клода взаимодействовать с вашим рабочим пространством Notion, например:
   • «Покажите мне список моих баз данных Notion»
   • «Создать новую страницу в моей базе данных задач с заголовком «Тестовое задание»»

Доступные инструменты

Сервер предоставляет следующие инструменты помощникам ИИ:

• list-databases : Просмотреть все доступные базы данных
• query-database : Получить записи из базы данных
• create-page : Добавить новую страницу в базу данных
• update-page : Изменить существующую страницу
• create-database : Создать новую базу данных
• update-database : Изменить структуру базы данных
• get-page : Просмотр определенной страницы
• get-block-children : Просмотр блоков контента
• append-block-children : Добавить содержимое на страницу
• update-block : Редактировать блоки контента
• get-block : Просмотр определенного блока
• поиск : найдите контент в вашем рабочем пространстве

Поиск неисправностей

Распространенные проблемы:

1. «Сбой соединения» в Клоде
   • Убедитесь, что путь к серверу в claude_desktop_config.json указан правильно.
   • Проверьте, действителен ли ваш ключ API Notion
   • Убедитесь, что Node.js установлен
2. «Доступ запрещен» при доступе к контенту Notion
   • Убедитесь, что вы поделились страницей/базой данных с вашей интеграцией.
   • Проверьте, что ваш ключ API имеет необходимые разрешения.
3. Сервер не запускается
   • Убедитесь, что все зависимости установлены ( npm install )
   • Проверьте, существует ли файл .env с вашим ключом API.

Получение помощи

Если вы столкнулись с проблемами, не описанными здесь, пожалуйста:

• Проверьте вывод консоли на наличие сообщений об ошибках.
• Убедитесь, что ваш ключ API Notion действителен
• Убедитесь, что ваша интеграция имеет доступ к страницам/базам данных

Лицензия

Массачусетский технологический институт