Сервер Notion MCP

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

Что это?

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

• Просмотр и поиск в базах данных Notion

• Создание и обновление страниц

• Управление блоками контента

• И многое другое!

Related MCP server: Notion MCP Server

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

Предпосылки

• 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 действителен

• Убедитесь, что ваша интеграция имеет доступ к страницам/базам данных

Лицензия

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