中文说明

Notion MCP 에이전트를 로컬 파일, 셸, git, 위임 작업을 위한 로컬 코딩 에이전트로 전환하세요.

이 프로젝트가 하는 일들

• 로컬 파일, 셸, git, 패치 스타일 편집을 MCP를 통해 노출
• MCP 에이전트가 Notion 페이지를 편집하는 대신 실제 로컬 저장소에서 작업할 수 있게 합니다
• 로컬 codex 또는 [[T1]를 통한 위임된 장기 실행 작업 지원

퀵 스타트

최소한 다음과 같이 설정하세요:

중요한 MCP 에이전트 구성

Notion 내에서 MCP 에이전트 설정에 이 내용을 사용하세요:

• URL: https:// /mcp
• 인증 유형: Bearer
• 토큰: NOTION_LOCAL_OPS_AUTH_TOKEN

ChatGPT 웹 언어

ChatGPT 웹 개발자 모드는 HTTPS MCP 엔드포인트를 기대하며 다음 사이트와 연결할 수 있습니다. OAuth. 이 프로젝트는 로컬 기능을 위한 최소한의 OAuth 호환성 모드를 구현합니다. 사용: 동적 클라이언트 등록, PKCE 인증 코드 흐름, 보호됨 자원 메타데이터와 베어러 액세스 토큰. 완전한 사용자를 구현하지 않습니다 계정 시스템이나 ChatGPT iframe UI 위젯 같은 것들.

.env에서 OAuth 모드를 활성화하기:

그 다음 서비스를 재시작하세요. 런디드 관리형 설치는 재설치하거나 재시작하세요. 생성된 PLIST는 새로운 ENV 값을 받습니다:

ChatGPT 앱/커넥터를 다음 기능으로 만드세요:

• MCP 서버 URL: [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.