QuickBooks

快速开始

该技能复用了共享的 mcporter 封装脚本，但目前尚未为 QuickBooks 注册技能本地的 mcporter.json 文件。在添加提供商 MCP 清单（manifest）之前，请勿调用 bash {baseDir}/scripts/invoke.sh。在当前运行时环境中，请先检查可用的 QuickBooks 工具，然后选择最简读取路径，以识别客户、发票、付款、费用、供应商或报表目标。

当 QuickBooks 的 MCP 清单添加完成后，请遵循与 Linear 相同的封装规则：始终通过 bash {baseDir}/scripts/invoke.sh 调用，切勿直接调用 mcporter；并在选择工具名称前，先发现（discover）各工具的 Schema。

安全性

创建、更新、删除、发送、作废或同步客户、发票、付款、费用、供应商及会计记录等写入操作，可能影响财务账簿。调用写入类工具前，须确认用户意图明确；对任何涉及资金变动或影响会计结果的变更，均需先读取目标对象的当前状态。

认证

访问令牌由系统自动配置并轮转。若运行时可用工具返回 HTTP 401 错误，且数秒内未能自动恢复，则表明 OAuth 授权已被撤销——请重新授权该集成以刷新凭据。

数据流

本仓库中尚未注册任何由提供商托管的 QuickBooks MCP 端点。若在当前活跃的 OpenClaw 环境中存在运行时工具调用，则将使用 Maverick 配置的 OAuth 凭据，并向当前工具提供商暴露 QuickBooks 的客户、发票、付款、费用、供应商及报表数据。请仅将本技能用于 QuickBooks 相关任务；切勿通过这些工具传递无关的敏感内容。

依赖项

• mcporter（github.com/steipete/mcporter）—— 当 QuickBooks 的 MCP 清单存在后，由共享封装脚本调用的 MCP CLI 工具。若未在 PATH 中找到，将通过 npm install -g --ignore-scripts mcporter 自动安装（参见 frontmatter 中的 install 规范）。该安装规范使用未锁定版本的 mcporter（即 npm 的 latest）；对于有严格供应链管控要求的运维人员，应覆盖默认安装逻辑，显式指定版本（例如 mcporter@）。
• jq（stedolan.github.io/jq）—— 由密钥库（vault）初始化器使用的 JSON 处理器。属于系统级依赖，请通过操作系统包管理器安装（如 apt install jq、brew install jq 等）。
• flock（util-linux 组件之一）—— 用于序列化并发密钥库写入操作的文件锁工具。Linux 系统默认提供；macOS 上请通过 brew install flock 安装。
• shasum（Perl 工具，依赖 Digest::SHA 模块）—— 用于计算 SHA-256 哈希值，进而推导 mcporter 密钥库密钥（vault key）及已配置令牌标记（provisioned-token marker）。macOS 及 Debian/Ubuntu 系统（包括已部署的 cloudflare/sandbox Ubuntu 22.04 镜像）均已预装；在精简版 Linux 镜像中，请安装 perl-Digest-SHA。脚本调用的是 shasum -a 256 而非 GNU sha256sum，以确保在未安装 coreutils 的原生 macOS 环境下仍可正常运行。