Pax8 MCP

Pax8 + AI - 适用于 ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini，以及任何支持 MCP 的 Agent

非官方。由社区构建的 Claude Code Skill 和 Pax8 API 的 MCP 服务。与 Pax8, Inc. 无关联，也未获其认可或赞助。

_{▶ 观看 30 秒演示 - 演示数据为模拟数据；展示的每条命令都存在于实际 CLI 中。}

涵盖每个 Pax8 Partner API 端点，另有一个离线存储，用于对账、跟踪 MRR，并捕捉任何 Pax8 工具都无法呈现的用量超额情况。可与您已经在使用的 AI 搭配使用 - ChatGPT（Plus/Pro+，此连接器重新发布前暂停；见 mcp-install.md）、Claude Desktop、Codex、Claude Code、Claude Cowork 和 GitHub Copilot - 也可通过远程方式搭配 Microsoft 365 Copilot / Copilot Studio 和 Google Gemini 使用。免费、开源，可在笔记本电脑上运行。专为 MSP 所有者打造。无需编写代码。

适用于您的 Agent

安全提示（此连接器重新发布前）。 请勿运行 HTTP 模式 （--transport http），即使在 localhost 上也不行。此版本没有密码， 会监听所有网络接口，而且早于浏览器重绑定防护机制， 因此您打开的网页可以访问它。MCP 工具还可以使用您的凭据执行 更改。请使用默认的 stdio 传输方式。如果您为远程 Agent 设置了隧道， 请将其关闭。修复即将推出。

MSP 所有者实际使用的六种 Agent（自助使用，现已可用）：

您的 AI Agent	如何安装 Pax8 skill
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 pax8-mcp（无需编辑 JSON）。
ChatGPT（付费方案）	此连接器重新发布前暂停：ChatGPT 需要 HTTP 模式，而此版本的该模式不要求密码、会监听所有网络接口，并且可以被您打开的网页访问。请参阅 mcp-install.md 中的安全提示。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 pax8-mcp，然后选择 Agent 模式。

ChatGPT 需要远程 HTTPS 服务，这意味着需要使用此连接器的 HTTP 模式；该模式在连接器重新发布前暂停：此版本的该模式不要求密码、会监听所有网络接口，并且可以被您打开的网页访问。请参阅 mcp-install.md 中的安全提示。

也适用于 Microsoft 和 Google 技术栈

用户基数很大，但先如实提醒：这两种方式走的是远程 / 企业路径，而不是你刚安装的本地二进制文件。

Agent	所需条件
Microsoft 365 Copilot / Copilot Studio	暂停使用，直到重新发布此连接器：Copilot Studio 需要 HTTP 模式，而在此版本中，该模式无需密码、会监听所有网络接口，并且可以被你打开的网页访问。请参阅 mcp-install.md 中的安全说明。
Google Gemini	Gemini CLI 在本地运行，与 Claude Code 相同。Gemini 应用在远程运行，需要像 ChatGPT 一样暂停使用 HTTP 模式。请参阅 mcp-install.md。

原生支持 Skill 的 Agent（也已涵盖）： Hermes 和 OpenClaw 可直接读取此 Skill 的 SKILL.md，也支持 MCP——请参阅下方的安装章节。通过 MCP 也支持 Cursor、Windsurf、Cline、Continue.dev 和 Zed。每种工具的完整接入说明：docs/which-agent.md。

要运行多个 Agent？ 只需一条命令，即可在全部 51+ 个受支持的 Agent 中完成安装：npx skills add Servosity/msp-skills@latest（需要 Node.js，然后运行每个 Skill 对应的安装程序来安装 CLI/MCP 二进制文件）。请参阅 docs/which-agent.md。

60 秒内完成安装

Claude Desktop 最快安装方式——一键安装 .mcpb

Claude Desktop 安装包： .mcpb 可在 macOS（Intel 和 Apple Silicon）、Windows x64 和 Linux x64 上启动。每个工具都会调用配套的 pax8-cli。从 2026-09-18 起发布的版本会在安装包中附带该 CLI；较早的安装包仅包含 MCP 服务，因此如果你的安装包缺少配套 CLI，请先运行下方的路径 A 或路径 B 安装程序（或将 PAX8_CLI_PATH 设置为现有二进制文件的路径）。详情请参阅：#331。

下载 Pax8 MCP（.mcpb）——然后打开 Claude Desktop > Settings > Extensions 并选择该文件。一键完成，无需 JSON，也无需 Shell。（在发布页面查看所有 Pax8 版本。）

更喜欢 Claude Code 插件？添加一次市场，然后安装即可——立即生效，无需列出目录：

/plugin marketplace add Servosity/msp-skills
/plugin install pax8@msp-skills

路径 A——将一段提示词粘贴到你的 AI Agent 中（推荐）

将以下内容复制到 Claude Code、Codex CLI 或 Claude Cowork 中：

在此 Agent 工作区中，从 Servosity/msp-skills 安装 Pax8 Skill 和 MCP 服务。如果此工作区使用 POSIX Shell（macOS、Linux、WSL 或 Bash），请运行 bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/pax8/install.sh)。如果使用 Windows PowerShell，请运行 iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/pax8/install.ps1 | iex。然后按照 README 完成身份验证，并运行 pax8-cli --help 进行探索。

任何能够运行 Shell 的 Agent 都可以使用相同的提示词。

路径 B——自行运行安装程序

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/pax8/install.ps1 | iex

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/pax8/install.sh)

安装程序会将 pax8-cli（CLI）和 pax8-mcp（MCP 服务）都安装到用户的 bin 路径中。Claude Code、Codex 和 Cowork 会通过此目录中的 SKILL.md 发现 Skill。

验证：

pax8-cli --version

升级到最新版本

安装程序始终会获取当前版本——重新运行即可升级：

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/pax8/install.sh)

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/pax8/install.ps1 | iex

Claude Desktop .mcpb 用户：下载最新的 .mcpb（见本节顶部），并在 Settings > Extensions 中重新选择它。Claude Code 插件用户：/plugin update pax8@msp-skills。

添加到 Claude Desktop、GitHub Copilot、Gemini CLI、Microsoft 365 Copilot 或其他 MCP 客户端

安装程序运行后，请参阅 mcp-install.md 和 docs/which-agent.md，了解各 Agent 的接入方式——每个 Agent 都有一个专属章节，其中包括 GitHub Copilot 的 servers 键，以及 Microsoft 365 Copilot / Copilot Studio 的远程接入方式。Claude Desktop 的“设置 > 扩展”面板是最简单的接入方式；对于偏好编辑 JSON 的用户，mcp-install.md 中记录了 MCP 配置块。

为 Hermes 安装

在 Hermes CLI 中：

hermes skills install servosity/msp-skills/skills/pax8 --force

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/pax8 --force

Hermes 原生支持 MCP，因此也可以直接使用 pax8-mcp 服务——安装方式和环境变量都相同。

为 OpenClaw 安装

告诉你的 OpenClaw Agent（复制以下内容）：

从 https://github.com/servosity/msp-skills/tree/main/skills/pax8 安装 pax8 技能。该技能定义了如何通过 openclaw: frontmatter 块安装其必需的 CLI（pax8-cli）。

OpenClaw 目前尚未普遍开放；frontmatter 接入配置已预先提供，将在 OpenClaw 发布时立即启用。

身份验证

在 Pax8 门户的 Integrations 下创建 OAuth2 Client ID 和 Secret，然后设置 CLI 所需的两项凭证：

PAX8_CLIENT_ID=<value> PAX8_CLIENT_SECRET=<value> pax8-cli doctor

PAX8_AUDIENCE（默认值为 api://p8p.client）和 PAX8_OAUTH_SCOPE 是针对非标准租户的可选覆盖项。运行任何会访问数据的操作前，doctor 会确认凭证是否有效；pax8-cli auth login 会以交互方式生成并缓存 bearer token。即使凭证遭到拒绝，它也会以 0 退出，因此脚本应添加 --fail-on error。

此技能的功能

MSP 常见问题	命令
我的账单收入从哪里流失了——为已取消的产品收费，还是产品处于活跃状态却从未开票？	pax8-cli reconcile
能否在下一张发票最终确定前发现这类收入流失？	pax8-cli reconcile --draft
我目前的 MRR 和利润率是多少？按产品细分。	pax8-cli mrr
哪些用量即将超额计费，尚未计入客户发票？	pax8-cli overage
本周我的业务有哪些变化——新增、取消或调整规模的订阅？	pax8-cli since 7d
哪些客户在所有发票上的总支出最高？	pax8-cli spend
在一个视图中查看某个客户的所有信息——订阅、联系人、发票和用量？	pax8-cli company show <companyId>
我可以转售哪些与某个供应商或关键词匹配的产品？	pax8-cli search "microsoft 365"

完整命令参考请见：guide.md。关于 AI Agent 的操作规范（--agent、--dry-run、执行修改前何时需要确认），请参阅 AGENTS.md。

有何不同

大多数 Pax8 集成和 MCP 服务都会将每个问题转发为实时 API 调用。查询单条记录时，这样没问题。但在规模扩大后就行不通了，例如要查询上个月所有客户的利润率损失来自何处，或哪些用量即将在开票前超额计费。

此技能会将 Pax8 数据同步到支持全文搜索的本地 SQLite 镜像中。聚合查询会转换为一次本地 SQL 联接：即时、离线完成，AI 看到的是答案，而非原始数据。reconcile、mrr 和 company show 等组合命令会联接发票、订阅、产品和用量数据——这是无状态 API 封装器无法完成的。

解决的痛点

Pax8 在配置和下单方面表现出色，却无法在一个地方告诉你资金究竟流失在哪里。市场平台会提供月度发票文件，却不会将其中的明细与有效订阅关联起来，因此，取消的产品仍在计费，或有效订阅从未开票，都得由你手动查找。自动化供应商 Bumblebee 曾介绍一家 MSP，每月花 五天 将 Pax8 发票与其 PSA 对账，之后才实现自动化（hirebumblebee.com）；Pax8 自己的开发者文档也坦言，将发票明细映射回订阅确实需要投入集成工作（devx.pax8.com）。

此技能通过本地镜像解决这一问题：

• pax8-cli reconcile - 找出没有有效订阅的发票明细，以及从未开票的有效订阅（--draft 会预先检查下一张尚未过账的发票）
• pax8-cli mrr - 按产品统计经常性收入和利润率，省去反复重建电子表格
• pax8-cli overage - 在用量计入客户发票前，找出即将超额的用量
• pax8-cli spend - 按发票总支出对客户进行排名
• pax8-cli company show <companyId> - 在一个视图中查看单个客户的订阅、联系人、发票和用量

更详细的说明见 pain-point.md。

常见问题

这能与 ChatGPT 配合使用吗？

此版本不支持。ChatGPT（Plus、Pro、Team、Business、Enterprise 和 Education 计划；Free 目前尚未提供 Developer Mode）只能通过 HTTPS 连接到远程 MCP 服务，这意味着需要以 HTTP 模式运行 Pax8 MCP 服务。在此版本中，HTTP 模式不需要密码，会监听所有网络接口，并且你打开的网页可以访问它，因此在连接器重新发布之前，请勿运行它或将其置于隧道之后；mcp-install.md 中的安全说明解释了原因。在此之前，请使用 Claude Desktop、Claude Code 或 Codex。

这能与 Codex、Cursor、Windsurf、Cline、Copilot 或 Gemini 配合使用吗？

可以——它们都支持 MCP。跨工具安装命令见上方的矩阵，以及 docs/which-agent.md 中的详细说明。

我需要懂编程吗？

不需要。推荐的安装方式是在 Claude Code 或 Codex 中粘贴一句话，由你的 Agent 读取 SKILL.md 并完成安装。备用方式是使用适用于各操作系统的一行安装命令（bash 或 PowerShell）。两种方式都不需要编写代码。你只需输入一次 Pax8 凭据。

我的 Pax8 数据安全吗？

你的数据保留在自己的设备上。CLI 和 MCP 服务都是本地二进制文件。SQLite 镜像存放在你用户帐户下的目录中。AI Agent 只能看到 CLI 返回的内容——通常是查询结果，而非原始批量数据。凭据从你的环境或 Agent 配置中读取；MSP Skills 不会将凭据打包进此仓库，也不会将其传输到任何地方。

我必须是 Pax8 合作伙伴吗？它使用什么凭据？

是的——它会使用你自己的合作伙伴凭据连接到 Pax8 Partner API。在 Pax8 门户的 Integrations 下创建 OAuth2 Client ID 和 Client Secret，然后设置 PAX8_CLIENT_ID 和 PAX8_CLIENT_SECRET。CLI 会将它们发送到 Pax8 的令牌端点以换取持有者令牌，并缓存该令牌。PAX8_AUDIENCE（默认值为 api://p8p.client）和 PAX8_OAUTH_SCOPE 是可选的覆盖项。真正的边界由凭据自身的权限决定——请将权限范围限定为你希望 AI 访问的内容。

这会触及我的 Pax8 API 速率限制吗？

首次同步后，分析命令（reconcile、mrr、overage、spend、since、company show、search）会在你的本地 SQLite 镜像上运行，不会调用 API。实时调用会遵守 --rate-limit 节流设置。Pax8 的列表端点都不支持按更改时间筛选，因此每次同步都会重新读取你的公司和订阅（以及镜像的其他资源）。随后，since 命令会报告已存储的订阅历史，以及你所选时间窗口内创建或更新的当前订阅。

它会取代 Pax8 门户吗？

不会。配置、下单和支持工作流仍在门户中完成。这项技能可从终端或 Agent 解答门户无法在一处整合的跨实体计费和收入问题——对账、MRR 和利润率、用量超额、客户 360 度视图。

费用是多少？

免费。采用 Apache-2.0 许可。你只需为使用的 AI Agent（Claude、ChatGPT、Codex 等）付费，费用由你的 AI 提供商收取，而不是由我们收取。

安全模型

层级	示例	建议的 Agent 策略
读取	pax8-cli reconcile、pax8-cli mrr、pax8-cli overage、pax8-cli spend、pax8-cli since 7d、pax8-cli company show <companyId>、pax8-cli search "microsoft 365"、pax8-cli companies find、pax8-cli subscriptions find	允许
写入（常规）	pax8-cli companies create-company、pax8-cli companies update-company、pax8-cli companies contacts create、pax8-cli subscriptions update、pax8-cli orders create——写入会立即发送；--dry-run 是选择启用的预览功能，并非默认行为	先使用 --dry-run 预览，再经审核后写入
破坏性操作 / 配置	pax8-cli subscriptions delete（取消订阅）、pax8-cli companies contacts delete	仅限人工参与

最有力的控制措施是你授予 Pax8 凭据的权限范围——CLI 只能执行这些凭据获准执行的操作。完整详情（包括如何限制权限）请参阅 governance.md。

状态

Beta 版。已根据 Pax8 API 接口进行验证，并正在每周 Build Sessions 中与使用自有生产租户运行此工具的 MSP 一起验证。请在 compoundingteams.com/build-sessions RSVP。

---

标准。 符合开放的 Agent Skills 规范（Anthropic，2025 年 12 月；支持 40 多种 Agent）。兼容 MCP——可与任何支持 MCP 的 Agent 配合使用，包括 Hermes。支持 OpenClaw（frontmatter 已预先配置，等待 OpenClaw 发布）。

由 Servosity 维护。采用 Apache-2.0 许可。使用 CLI Printing Press 构建。最后更新：2026-06-05。