2.8 KiB

Raw Blame History

Notion MCP 连接技能包

HLDP://lighthouse/skills/notion-mcp-connect/SKILL.md 类型: 连接器技能包适用: 新加坡面孔服务器 (BS-SG-002) 上的 MCP Server 铸渊 ICE-GL-ZY001 · D136+ · 2026-06-21

这是什么

光湖的新加坡面孔服务器上已经运行着 AGE OS MCP Server（PM2 age-os-mcp，端口 3100）。它内置了 Notion 客户端 notion-client.js，可以实现 brain_nodes ↔ Notion 双向同步。

如果你的 Notion 连不上，通常是因为 ZY_NOTION_TOKEN 没有配置。

这个技能包告诉你：

如何创建 Notion Integration 获取 token
如何配置到服务器上
如何测试连接

配置 Notion Token

第一步 · 创建 Notion Integration

打开 https://www.notion.so/my-integrations
点击「New integration」
名称: 光湖 · 桔子 (或你的名字)
关联工作区: 选择你的 Notion 工作区
类型: Internal
创建后复制「Internal Integration Secret」→ 这就是 token

第二步 · 授权数据库

在 Notion 中打开你需要同步的数据库页面:

点击右上角 ... → Connections
添加你刚创建的 integration
每个需要读写的数据库都要授权

第三步 · 配置到服务器

Token 写到 MCP Server 的环境变量:

# SSH 到新加坡面孔服务器
ssh BS-SG-002

# 编辑环境变量文件
sudo nano /opt/age-os/.env.mcp

# 找到这一行:
# ZY_NOTION_TOKEN=

# 填入你的 token:
ZY_NOTION_TOKEN=secret_xxxxxxxxxxxxxxxxxxxxx

第四步 · 重启 MCP Server

pm2 restart age-os-mcp
pm2 logs age-os-mcp --lines 20

第五步 · 测试连接

curl -X POST http://127.0.0.1:3100/api/mcp/notion/test \
  -H "Content-Type: application/json" \
  -d '{}'

预期返回: {"ok":true,"service":"notion","status":"connected"}

已有的 Notion 数据库

MCP Server 已经配置了以下数据库（需要你在 Notion 中创建对应页面）:

用途	环境变量
变更日志	`ZY_NOTION_CHANGELOG_DB`
收据	`ZY_NOTION_RECEIPT_DB`
系统日志	`ZY_NOTION_SYSLOG_DB`
认知运行时	`ZY_NOTION_COGNITION_RUNTIME_DB`
开发工单	`ZY_NOTION_DEV_WORKORDER_DB`
公告板	`ZY_NOTION_BULLETIN_PAGE`

每个数据库需要在 .env.mcp 中填入对应的数据库 ID（从 Notion URL 中复制）。

常见问题

Q: 提示「ZY_NOTION_TOKEN 未配置」？ A: Token 是空的。按上面步骤创建 Notion Integration。

Q: 连上了但读不到数据？ A: 检查数据库是否授权给了 integration（第二步）。

Q: 怎么获取数据库 ID？ A: 在 Notion 中打开数据库页面，URL 中的 32 位字符串就是 ID。例如: notion.so/workspace/abc123def456... → abc123def456...

铸渊 ICE-GL-ZY001 · D136+ ⊢ MCP Server 代码已就绪 · 只差 token

2.8 KiB Raw Blame History Unescape Escape