SuperAPI AI 工具集

notion-mcp-skill

办公与效率

查看项目

更新于 10-16 05:51

技能介绍

用途:借助 UXC CLI 以 MCP 方式操作 Notion 工作区,包括搜索内容、读取页面、查询用户/团队、创建更新页面与数据库。

前提:已安装 uxc 并在 PATH 中;可访问 https://mcp.notion.com/mcp;OAuth 回调监听可用(示例为 http://127.0.0.1:8788/callback);uxc skill 可用于通用 discovery/describe/execute。

用法:先确认端点映射与授权,如 uxc auth binding match mcp.notion.com/mcp。未就绪时启动 OAuth:uxc auth oauth start notion-mcp --endpoint mcp.notion.com/mcp --redirect-uri http://127.0.0.1:8788/callback --scope read --scope write,让用户打开授权 URL 并回传完整回调地址,再执行 uxc auth oauth complete notion-mcp --session-id <session_id> --authorization-response '<callback-url>',并绑定凭证 uxc auth binding add --id notion-mcp --host mcp.notion.com --path-prefix /mcp --scheme https --credential notion-mcp --priority 100。随后建立固定命令 uxc link notion-mcp-cli mcp.notion.com/mcp,并先用 notion-mcp-cli -h 与 notion-mcp-cli notion-fetch -h 查看工具与 schema。示例:notion-mcp-cli notion-fetch id="https://notion.so/your-page-url"。常用操作含 notion-search、notion-fetch、notion-update-page。

限制与守则:优先读后写,创建/更新/移动/删除等高影响操作须用户显式确认;面向数据库内容时先 notion-fetch 获取准确 schema 与属性名;保持 JSON 输出,解析 ok、kind、protocol、data、error 等字段,不使用 --text;避免手动复制 bearer token;若命令名冲突且无法安全复用,应停止并请维护者更换命令名。参考资料包括 references/oauth-and-binding.md、references/usage-patterns.md、references/error-handling.md。