by 运行时依赖
安装命令
点击复制技能文档
Notion 快速入门 始终通过 bash 调用 {baseDir}/scripts/invoke.sh —— 永远不要直接调用 mcporter。包装器在需要时从环境提供的令牌中初始化 OAuth 密钥库，然后调用 mcporter。 bash {baseDir}/scripts/invoke.sh call maverick-notion.notion-get-self bash {baseDir}/scripts/invoke.sh call maverick-notion.notion-search query="roadmap" 为了获得结构化输出（同时将传输错误作为 JSON 信封显示 —— 用于解决 mcporter #153 的问题）： bash {baseDir}/scripts/invoke.sh call --output json maverick-notion.notion-search query="roadmap" | jq '.result.content' 发现可用工具和模式： bash {baseDir}/scripts/invoke.sh list maverick-notion --schema 安全 写操作（notion-create-pages、notion-update-page、notion-move-pages、notion-duplicate-page、notion-create-database、notion-update-data-source、notion-create-view、notion-update-view、notion-create-comment 和广泛的工作空间更改）会修改 Notion 内容，影响连接的工作空间。确认用户意图清晰后再调用写工具 —— 搜索和读取工具在探索时可以自由调用。 在修改之前，先搜索页面、数据库、用户或块 ID，并读取当前记录。 身份验证令牌会自动颁发和轮换。如果调用返回 HTTP 401 并且在几秒钟内无法恢复，OAuth 授权已经被撤销 —— 重新授权集成以刷新凭据。 数据流 工具调用通过 HTTPS 访问 Notion 的托管 MCP 服务（https://mcp.notion.com/mcp），并通过 OAuth 进行身份验证。Notion 可以看到每个调用引用的工作空间内容。仅将此技能用于 Notion 相关工作；不要通过这些工具传递无关的敏感内容。 依赖 mcporter（github.com/steipete/mcporter）—— 用于调用 Notion 托管 MCP 服务器的 MCP CLI。如果 PATH 中缺少，会通过 npm install -g --ignore-scripts mcporter 自动安装（参见前置内容中的安装规范）。安装规范使用未固定版本的 mcporter（npm 最新版本）；具有严格供应链控制的运营商应覆盖安装以固定特定版本（例如 mcporter@）。 jq（stedolan.github.io/jq）—— 用于初始化密钥库的 JSON 处理器。系统依赖；通过操作系统包管理器安装（apt install jq、brew install jq 等）。 flock（util-linux的一部分）—— 用于序列化并发密钥库写入的文件锁定。默认在 Linux 上可用；在 macOS 上通过 brew install flock 安装。 shasum（Perl，随 Digest::SHA 一起提供）—— 计算用于派生 mcporter 密钥库密钥和提供的令牌标记的 SHA-256 哈希值。预安装在 macOS 和 Debian/Ubuntu（包括部署的 cloudflare/sandbox Ubuntu 22.04 镜像）上；在最小的 Linux 镜像上安装 perl-Digest-SHA。脚本调用 shasum -a 256，而不是 GNU sha256sum，因此可以在不需要 coreutils 的 stock macOS 上运行。