Пошаговая инструкция

Подключение локальной папки к Notion через MCP

Ниже — аккуратно структурированный сценарий: установка Node.js и ngrok, запуск локального MCP-сервера, публикация через ngrok и подключение к Notion. Все команды и важные ссылки можно скопировать одной кнопкой.

🟢 Node.js 🔌 ngrok 🗂️ filesystem MCP ✨ Notion Agent

💡

Что получится в итоге

Notion сможет читать, создавать и редактировать файлы внутри папки, путь к которой вы укажете при запуске сервера. Окна с MCP-сервером и ngrok нужно держать открытыми.

Короткая схема

1. Установить Node.jsЧтобы работал npm и npx

2. Установить ngrokЧтобы дать Notion доступ к локальному серверу

3. Запустить MCPЛокальный сервер на порту 3000

4. Запустить туннельngrok создаст публичную ссылку

5. Подключить в NotionCustom MCP через SSE

Перед началом

🧰

PowerShell

Команды ниже рассчитаны на Windows и PowerShell. Открывайте терминал прямо в папке проекта.

🔑

Токен ngrok

После установки нужно привязать аккаунт ngrok с помощью authtoken из личного кабинета.

📁

Папка для доступа

Заранее выберите папку, которую Notion сможет читать и редактировать через MCP-сервер.

Шаг 1 · Node.js

Установите Node.js

Сначала установите Node.js с официального сайта. Без Node.js команды npm и npx работать не будут.

Шаг 2 · ngrok

Установите ngrok

Можно скачать ngrok с сайта или установить через PowerShell.

winget install ngrok.ngrok

После установки перезапустите терминал и привяжите аккаунт:

ngrok config add-authtoken ВАШ_ТОКЕН

Токен берётся в личном кабинете ngrok:

Шаг 3 · Папка проекта

Откройте PowerShell в папке проекта

Перейдите в папку, где будет запускаться файловый сервер, и установите зависимости:

npm install

Если файловый сервер устанавливается отдельной командой из вашей инструкции, используйте:

npm install /server-filesystem

Шаг 4 · MCP-сервер

Запустите локальный мост на порту 3000

Скопируйте команду и замените ВАШ_ПУТЬ на путь к папке, которую нужно открыть для Notion.

npx -y mcp-proxy --port 3000 -- cmd.exe /c npx -y /server-filesystem "ВАШ_ПУТЬ"

✅

Признак успешного запуска

Если всё нормально, терминал покажет сообщение:

starting server on port 3000

Важно: это окно PowerShell не закрывайте.

Шаг 5 · ngrok-туннель

Откройте второе окно PowerShell

Во втором окне запустите ngrok для порта 3000:

ngrok http 3000

После запуска появится таблица. Найдите строку Forwarding и скопируйте ссылку вида:

https://xxxxx.ngrok-free.app

Для подключения в Notion к ссылке нужно добавить /sse в конце:

https://xxxxx.ngrok-free.app/sse

Шаг 6 · Notion Agent

Создайте агента в Notion

Откройте Notion

Перейдите к созданию нового агента.

Нажмите New agent

Затем выберите Create blank.

Добавьте подключение

Под пунктом Web access нажмите Add connection, затем Add custom MCP и подтвердите подключение.

Шаг 7 · Подключение для всех чатов

Откройте обычный чат Notion

Зайдите именно в обычный чат Notion, не в агента, и отправьте фразу:

дай мне сделать кастомный mcp сервер для всех чатов

После этого Notion покажет форму подключения прямо в чате.

Шаг 8 · Заполнение формы

Заполните форму подключения

Поле	Значение	Комментарий
Name	`filesystem`	Название подключения
URL	`https://xxxxx.ngrok-free.app/sse`	Замените `xxxxx` на свою ссылку ngrok
Transport	`SSE`	Обязательно выберите SSE

filesystem

https://xxxxx.ngrok-free.app/sse

SSE

⚠️

Проверьте окончание URL

В конце ссылки обязательно должно быть /sse. Без этого подключение может не заработать.

Финальный чек-лист

✓Node.js установлен, команды npm и npx работают.
✓ngrok установлен и привязан через authtoken.
✓MCP-сервер запущен на порту 3000.
✓ngrok показывает публичную ссылку в строке Forwarding.
✓В Notion указан URL формата https://xxxxx.ngrok-free.app/sse.
✓Окна с MCP-сервером и ngrok остаются открытыми.

Что делать, если подключение перестало работать?

Проверьте, что не закрыты окна PowerShell с MCP-сервером и ngrok. Если ngrok был перезапущен, ссылка могла измениться — скопируйте новую ссылку Forwarding, добавьте /sse и обновите URL в подключении Notion.

Почему Notion не видит файлы?

Убедитесь, что в команде запуска MCP вместо ВАШ_ПУТЬ указан правильный путь к папке, а PowerShell запущен с достаточными правами доступа к этой папке.

Готово

Теперь Notion сможет работать с файлами внутри выбранной папки: читать, создавать и редактировать их через подключённый MCP-сервер.

Главное правило: если закрыть окно с MCP-сервером или окно с ngrok, подключение перестанет работать.