SuperAPI AI 工具集

notion

办公与效率

查看项目

更新于 10-15 17:19

技能介绍

用途:通过托管 Notion MCP 服务器(https://mcp.notion.com/mcp)与 Notion 页面、数据库及工作区内容交互。工具通过 exec 运行 notion-cli <subcommand> [options]。

连接管理:notion-cli status、authorize-url、exchange-code --code <code> [--redirect-uri <url>]、refresh、disconnect。

MCP 操作:notion-cli list-tools;notion-cli call-tool --name <tool> --arguments-json '<json-object>'。arguments-json 必须是 JSON 对象,数组或标量会被拒绝。建议先用 list-tools 发现工具目录及各工具的 input_schema。

认证:OAuth 由 authd 处理,采用 Dynamic Client Registration + PKCE(S256)。访问令牌存储在 $JARVIS_HOME/user/auth/notion.json,请勿手动编辑。

首次使用流程:先运行 notion-cli status;若状态为 not_connected,运行 notion-cli authorize-url,将返回的 <connect_url> 替换为实际 URL 并仅以 Markdown 链接形式 Connect Notion 分享,不要单独粘贴原始 URL;等待用户完成授权后,浏览器经 Muse 中继跳回该 VM,authd 自动完成代码交换。再运行 notion-cli status,状态变为 connected 时会同时输出发现的 MCP 工具目录。若手动环境中继未接通,可在收到代码后调用 notion-cli exchange-code --code <auth-code>。

操作规则:任何 MCP 工作前先运行 status,未连接则先完成设置;除非已知工具名与参数结构,否则 call-tool 前先调用 list-tools,不要猜测工具名;调用会修改页面、数据库或块的工具前确认用户意图;401 时自动刷新令牌,若持续未授权可显式运行 refresh 或请用户重新授权。读取结果保留 Notion 原始日期字段,并为记录创建/编辑时间和定时日期属性添加语义化 UTC 及用户本地时间形式,仅日期属性仍为日期。