A
securityF
licenseA
qualityA high-performance MCP server that integrates Notion into AI workflows, enabling interaction with Notion pages, databases, and comments through a standardized protocol.
Last updated -
19
25
Сервер Notion MCP
В этом проекте реализован MCP-сервер для Notion API .
Установка
1. Настройка интеграции в Notion:
Перейдите по ссылке https://www.notion.so/profile/integrations и создайте новую внутреннюю интеграцию или выберите существующую.
Хотя мы ограничиваем область действия Notion API (например, вы не сможете удалять базы данных через MCP), существует ненулевой риск для данных рабочей области, если они будут раскрыты LLM. Пользователи, заботящиеся о безопасности, могут захотеть дополнительно настроить возможности интеграции.
Например, вы можете создать токен интеграции, доступный только для чтения, предоставив доступ только «Чтение содержимого» на вкладке «Конфигурация»:
2. Подключение контента к интеграции:
Убедитесь, что к вашей интеграции подключены соответствующие страницы и базы данных.
Для этого вам необходимо зайти на эту страницу, нажать на три точки и выбрать «Подключиться к интеграции».
3. Добавление конфигурации MCP в ваш клиент:
Использование npm:
Добавьте следующее в ваш .cursor/mcp.json или claude_desktop_config.json (MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json )
{
"mcpServers": {
"notionApi": {
"command": "npx",
"args": ["-y", "@notionhq/notion-mcp-server"],
"env": {
"OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\" }"
}
}
}
}
Использование Докера:
Существует два варианта запуска сервера MCP с Docker:
Вариант 1: Использование официального образа Docker Hub:
Добавьте следующее в ваш .cursor/mcp.json или claude_desktop_config.json :
{
"mcpServers": {
"notionApi": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e", "OPENAPI_MCP_HEADERS",
"mcp/notion"
],
"env": {
"OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer ntn_****\",\"Notion-Version\":\"2022-06-28\"}"
}
}
}
}
Этот подход:
Использует официальный образ Docker Hub
Правильно обрабатывает экранирование JSON через переменные среды.
Обеспечивает более надежный метод настройки
Вариант 2: Локальная сборка образа Docker:
Вы также можете создать и запустить образ Docker локально. Сначала создайте образ Docker:
docker-compose build
Затем добавьте следующее в ваш .cursor/mcp.json или claude_desktop_config.json :
{
"mcpServers": {
"notionApi": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e",
"OPENAPI_MCP_HEADERS={\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\"}",
"notion-mcp-server"
]
}
}
}
Не забудьте заменить ntn_**** на ваш секрет интеграции. Найдите его на вкладке конфигурации интеграции:
Примеры
Используя следующую инструкцию
Comment "Hello MCP" on page "Getting started"
ИИ правильно спланирует два вызова API, v1/search и v1/comments , для выполнения задачи
Аналогично, следующая инструкция приведет к созданию новой страницы с именем «Notion MCP», добавленной к родительской странице «Разработка».
Add a page titled "Notion MCP" to page "Development"
Вы также можете ссылаться на идентификатор контента напрямую.
Get the content of page 1a6b35e6e67f802fa7e1d27686f017f2
Разработка
Строить
npm run build
Выполнять
npx -y --prefix /path/to/local/notion-mcp-server @notionhq/notion-mcp-server
Публиковать
npm publish --access public
This server cannot be installed
Related Resources
Related MCP Servers
- Asecurity-licenseAqualityAn MCP server implementation that integrates Claude with Salesforce, enabling natural language interactions with Salesforce data and metadata for querying, modifying, and managing objects and records.Last updated -15545110MIT License
- AsecurityAlicenseAqualityAn MCP server implementation that integrates Claude with Salesforce, enabling natural language interactions with Salesforce data and metadata for querying, modifying, and managing objects and records.Last updated -74614MIT License
- AsecurityAlicenseAqualityNotion MCP Server is a MCP server implementation that enables AI assistants to interact with Notion's API.Last updated -13210138MIT License