Maxio MCP

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

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

_{完整 Skill 页面 - 安装、效果、安全模型。}

面向 Maxio Advanced Billing 的开放式本地收入智能 CLI——MRR 瀑布图、留存率和逐个客户的历史记录均从 SQLite 镜像离线计算，因此即使实时 API 只返回某一时点的数据，趋势历史也能得以保留。可与你已在使用的 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	如何安装 Maxio Skill
Claude Desktop	运行安装程序，然后通过 Settings > Extensions 注册 maxio-mcp（无需编辑 JSON）。
ChatGPT（付费套餐）	此连接器重新发布前暂停：ChatGPT 需要 HTTP 模式，而此构建中的该模式无需密码、会监听所有网络接口，并且你打开的网页可以访问它。请参阅 mcp-install.md 中的安全提示。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 servers 键下将 maxio-mcp 添加到 mcp.json，然后选择 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 app 则是远程应用，需要使用与 ChatGPT 相同的暂停使用的 HTTP 模式。请参阅 mcp-install.md。

原生支持技能的 Agent（也已涵盖）： Hermes 和 OpenClaw 会直接读取此技能的 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，然后为 CLI／MCP 二进制文件运行各技能的安装程序）。请参阅 docs/which-agent.md。

60 秒内完成安装

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

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

下载 Maxio MCP (.mcpb)——然后打开 Claude Desktop > Settings > Extensions 并选择该文件。一键完成，无需 JSON，也无需 Shell。（在 releases 页面浏览所有 Maxio 版本。）

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

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

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

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

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

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

maxio-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

Claude Desktop .mcpb 用户：下载最新的 .mcpb（本节顶部），然后在 Settings > Extensions 中重新选择该文件。Claude Code 插件用户：/plugin update maxio@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 的 Settings > Extensions 面板是最简单的配置方式；对于偏好编辑 JSON 的用户，mcp-install.md 中提供了 MCP 配置块。

为 Hermes 安装

在 Hermes CLI 中：

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

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/maxio --force

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

为 OpenClaw 安装

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

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

OpenClaw 目前尚未普遍开放使用；frontmatter 配置已预先提供，OpenClaw 一经发布便会立即启用。

身份验证

设置 CLI 所需的凭据（从你的 Maxio 门户获取）：

MAXIO_PASSWORD=<value> MAXIO_SITE=<value> MAXIO_USERNAME=<value> maxio-cli doctor

在运行任何会访问数据的操作前，doctor 会确认凭据有效。即使凭据被拒绝，它也会以 0 退出，因此脚本应添加 --fail-on error。

此技能的功能

MSP 经常提出的问题	命令
我们当前的 MRR 和 ARR 是多少？	maxio-cli mrr now
MRR 按月如何变化（新增、扩张、收缩、流失、重新激活）？	maxio-cli mrr waterfall --since 2026-01-01 --group-by month
我们的净收入留存率、毛收入留存率和速动比率是多少？	maxio-cli retention --since 2026-01-01 --group-by month
这位客户的经常性收入是多少，趋势如何？	maxio-cli mrr client --customer "Acme"
本周哪些客户账户需要关注？	maxio-cli triage --limit 20
未来 30 天内有多少 MRR 即将续约？	maxio-cli renewals --within 30
哪些用量组件推动了扩张或收缩？	maxio-cli usage-drivers --since 2026-01-01
本季度我们新增了多少客户，以及带来了多少 MRR？	maxio-cli new-customers --since 3m

完整命令参考请见：guide.md。关于 AI Agent 操作规范（--agent、--dry-run，以及何时应在执行变更前确认），请参阅 AGENTS.md。

与众不同之处

大多数 Maxio 集成和 MCP 服务都会将每个问题转发为实时 API 调用。查询单条记录时这样做没问题。但当你在准备董事会材料时，需要查询整个客户群的 MRR 变动瀑布图和净收入留存率，这种方式就难以应付——因为实时 API 只返回某个时间点的数据（而 MRR 端点需要 Maxio 的 Insights/Analytics 附加组件），没有可供查询的多期趋势历史记录。

此技能会将 Maxio 数据同步到带有全文搜索功能的本地 SQLite 镜像中，并将每次同步保存为时间序列快照。汇总问题只需在本地计算一次：即时、离线完成，AI 看到的是答案，而不是原始数据。maxio-cli mrr waterfall、maxio-cli retention 和 maxio-cli reconcile 等复合命令可以跨订阅、客户、组件和发票进行关联——无状态 API 封装无法做到这一点。由于实时 API 没有端点可以事后还原历史 MRR 变化或留存率，因此历史记录会持续累积。

解决的痛点

在 Maxio 自己的 G2 评价中，运营人员指出，经常性收入报告是薄弱环节：MRR、流失率和 ARPA 难以准确获取，团队还表示，为了回答这些问题，不得不在导入的账单数据上使用第三方应用。即使只是询问在某个时间段内注册的客户及其带来的收入，也无法在门户中轻松找到答案；实时 API 只返回某个时间点的数据，没有可用于还原历史趋势的端点。

此技能可通过终端或 AI Agent 填补这一空白：

• maxio-cli mrr waterfall --since 2026-01-01 --group-by month - 按月展示新增、扩张、收缩、流失和重新激活的变动。
• maxio-cli retention --since 2026-01-01 --group-by month - 展示净收入留存率、毛收入留存率和快速比率。
• maxio-cli new-customers --since 3m - 展示该时间段内的新客户及其带来的 MRR。
• maxio-cli triage --limit 20 - 列出当前需要关注的客户。
• maxio-cli reconcile --since 2026-01-01 - 找出标准化 MRR 与实际开票金额不一致之处。

更详细的说明请参阅 pain-point.md。

常见问题

这能与 ChatGPT 配合使用吗？

当前版本不行。ChatGPT（Plus、Pro、Team、Business、Enterprise 和 Education 计划；Free 目前尚未开放 Developer Mode）只能通过 HTTPS 连接远程 MCP 服务，这意味着必须以 HTTP 模式运行 Maxio 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）。这两种方式都不需要编写代码。你只需输入一次 Maxio 凭据。

我的 Maxio 数据安全吗？

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

这会触发 Maxio API 速率限制吗？

分析功能很少会触发。同步完成后，收入分析命令（maxio-cli mrr waterfall、maxio-cli retention、maxio-cli cohort、maxio-cli triage、maxio-cli reconcile）会读取本地 SQLite 镜像，因此不会调用 API。要让镜像保持最新，只需运行两个增量命令——maxio-cli sync 用于同步完整数据集，maxio-cli mrr sync 用于记录 MRR 变动历史快照——这两个命令都只会获取自上次运行以来发生变化的数据。端点镜像命令和 maxio-cli tail 会直接从 Maxio 读取实时数据，因此会计入速率限制。

我需要成为 Maxio 合作伙伴或客户吗？

你需要自己的 Maxio Advanced Billing API 凭据（一组用户名和密码）——仅此而已。这是一项非官方的社区构建技能，并非 Maxio 产品，因此没有合作伙伴计划或单独的注册流程。它只读取你的凭据本身已有权限访问的数据。

这会取代我的 Maxio 门户吗？

不会。它是门户的补充，账单操作和配置仍由门户负责。此技能可为你的 AI Agent 提供快速的收入趋势分析结果，并在本地保存一份历史数据副本，以弥补实时 API 无法还原历史数据的问题。

费用是多少？

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

安全模型

级别	示例	建议的 Agent 策略
读取	maxio-cli mrr now、maxio-cli retention、maxio-cli triage、maxio-cli search	允许
写入（常规）	maxio-cli customers update、maxio-cli subscriptions-json create-subscription	使用 --dry-run 预览，然后经审核后再写入
破坏性操作 / 配置	maxio-cli customers delete、maxio-cli subscription-groups delete、maxio-cli payment-profiles delete-unused	仅限人工参与

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

状态

测试版。已针对 Maxio API 功能进行验证，目前正通过每周 Build Sessions，与在自有生产租户上实际运行该工具的 MSP 一起进行验证。请在 compoundingteams.com/build-sessions 报名参加。

---

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

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