中文说明

Превратите агент Notion MCP в локальный кодящий агент для локальных файлов, shell, git и делегированных задач.

Что делает этот проект

• предоставляет локальные файлы, shell, git и редактирование в стиле патча через MCP
• позволяет агенту MCP работать в реальном локальном репозитории вместо редактирования только страниц Notion.
• поддерживает делегированные долгосрочные задачи через локальные codex или claude

Быстрый старт

По крайней мере, установка:

Важная конфигурация агента MCP

Используйте это в конфигурации MCP Agent внутри Notion:

• URL: https:// /mcp
• Тип аутентификации: Bearer
• Жетон: NOTION_LOCAL_OPS_AUTH_TOKEN

ChatGPT Web OAuth

Режим веб-разработчика ChatGPT ожидает HTTPS MCP-конечную точку и может подключаться к OAuth. Этот проект реализует минимальный режим совместимости с OAuth для локального режима использовать: динамическая регистрация клиента, поток авторизационного кода PKCE, защищённый метаданные ресурсов и токены доступа носителя. Он не реализует полноценного пользователя Аккаунт или виджеты интерфейса ChatGPT iframe.

Включите режим OAuth в .env:

Затем перезапустите сервис. Для запущенных с управляемыми установками переустановите или перезапустите Сгенерированный plist получает новые значения env:

Создайте приложение/коннектор ChatGPT с помощью следующего:

• URL сервера MCP: https:// /mcp

notion-local-ops-mcp

中文说明

Turn a Notion MCP Agent into a local coding agent for local files, shell, git, and delegated tasks.

What This Project Does

• exposes local files, shell, git, and patch-style editing through MCP
• lets an MCP Agent work on a real local repo instead of only editing Notion pages
• supports delegated long-running tasks through local codex or claude

Quick Start

git clone https://github.com//notion-local-ops-mcp.git
cd notion-local-ops-mcp
cp .env.example .env
./scripts/dev-tunnel.sh

Set at least:

NOTION_LOCAL_OPS_WORKSPACE_ROOT="/absolute/path/to/workspace"
NOTION_LOCAL_OPS_AUTH_TOKEN="replace-me"

Important MCP Agent Configuration

Use this in your MCP Agent configuration inside Notion:

• URL: https:///mcp
• Auth type: Bearer
• Token: NOTION_LOCAL_OPS_AUTH_TOKEN

ChatGPT Web OAuth

ChatGPT web developer mode expects an HTTPS MCP endpoint and can connect with OAuth. This project implements a minimal OAuth compatibility mode for local use: dynamic client registration, PKCE authorization code flow, protected resource metadata, and bearer access tokens. It does not implement a full user account system or ChatGPT iframe UI widgets.

Enable OAuth mode in .env:

NOTION_LOCAL_OPS_AUTH_MODE=oauth
NOTION_LOCAL_OPS_PUBLIC_BASE_URL="https://"
NOTION_LOCAL_OPS_AUTH_TOKEN="replace-me"
# Optional: use a separate login token for the OAuth authorization page.
# NOTION_LOCAL_OPS_OAUTH_LOGIN_TOKEN="replace-me"

Then restart the service. For launchd-managed installs, reinstall or restart so the generated plist receives the new env values:

./scripts/install-launchd.sh

Create the ChatGPT app/connector with:

• MCP server URL: https:///mcp
• Authentication: OAuth
• Client registration: dynamic registration, if ChatGPT offers the choice

When ChatGPT opens the authorization page, enter NOTION_LOCAL_OPS_AUTH_TOKEN unless NOTION_LOCAL_OPS_OAUTH_LOGIN_TOKEN is set.

Smoke-test the public OAuth surface before adding it to ChatGPT:

curl -sS https:///.well-known/oauth-protected-resource/mcp
curl -sS https:///.well-known/oauth-authorization-server
curl -i https:///mcp

The first two commands should return JSON metadata. The /mcp request without credentials should return 401 with a WWW-Authenticate header containing resource_metadata.

OAuth security notes

• Always set NOTION_LOCAL_OPS_PUBLIC_BASE_URL in OAuth mode. Without it the issuer URL falls back to the request Host header, which a tunnel attacker can spoof to steer OAuth metadata at a phishing host. The server prints a startup warning when this happens.