Maxio MCP

Maxio + AI - ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini、および MCP に対応するあらゆるエージェント向け

非公式です。コミュニティが構築した、Maxio API 向けの Claude Code Skill および MCP サーバーです。Maxio LLC とは提携関係になく、同社の推奨や支援を受けていません。

_{スキルの全ページ - インストール方法、効果、安全性のモデル。}

Maxio Advanced Billing 向けのオープンなローカル収益インテリジェンス CLI です。SQLite ミラーから MRR ウォーターフォール、継続率、クライアントごとの履歴をオフラインで算出するため、ライブ 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 オーナー向けに構築されています。コードは不要です。

エージェントで利用

セキュリティに関する注意（このコネクターが再公開されるまで）。 HTTP モード （--transport http）は、ローカルホスト上であっても実行しないでください。このビルドにはパスワードがなく、 すべてのネットワークインターフェースでリッスンし、ブラウザーのリバインディング対策が追加される前のものなので、 開いたウェブページから接続できてしまいます。MCP ツールは、認証情報を使って変更を加えることもできます。 デフォルトの stdio トランスポートを使用してください。リモートエージェント用にトンネルを設定している場合は、 停止してください。修正版は準備中です。

MSP オーナーが実際に使っている 6 つのエージェントに対応しています（セルフサービスで、今すぐ利用できます）。

AI エージェント	Maxio スキルのインストール方法
Claude Desktop	インストーラーを実行し、Settings > Extensions から maxio-mcp を登録します（JSON の編集は不要です）。
ChatGPT（有料プラン）	このコネクターの再公開まで一時停止中です。ChatGPT には HTTP モードが必要ですが、このビルドの HTTP モードはパスワードを求めず、すべてのネットワークインターフェースでリッスンし、開いたウェブページから接続できてしまいます。mcp-install.md のセキュリティに関する注意を参照してください。
Codex CLI	以下のインストール用プロンプトを貼り付けます。
Claude Code	以下のインストール用プロンプトを貼り付けます。
Claude Cowork	以下のインストール用プロンプトを貼り付けます。
GitHub Copilot（VS Code）	インストーラーを実行し、servers キーの下にある mcp.json に maxio-mcp を追加してから、Agent モードを選択します。

ChatGPT にはリモート HTTPS サーバーが必要であり、そのためにこのコネクターの HTTP モードが必要ですが、コネクターの再公開まで一時停止中です。このビルドの HTTP モードはパスワードを求めず、すべてのネットワークインターフェースでリッスンし、開いたウェブページから接続できてしまいます。mcp-install.md のセキュリティに関する注意を参照してください。

Microsoft および Google のスタック向け

導入済みの環境は多いですが、率直にお伝えすると、これらはリモート／エンタープライズ向けの方法であり、先ほどインストールしたローカルバイナリを使うものではありません。

エージェント	必要なもの
Microsoft 365 Copilot / Copilot Studio	このコネクターが再発行されるまで一時停止しています。Copilot Studio では HTTP モードが必要ですが、このビルドではそのモードでパスワードを要求せず、すべてのネットワークインターフェイスで待ち受け、開いたウェブページからアクセスできます。mcp-install.md のセキュリティに関する注意をご覧ください。
Google Gemini	Gemini CLI は Claude Code と同じくローカルで動作します。Gemini アプリはリモートで、ChatGPT と同じく一時停止中の HTTP モードが必要です。mcp-install.md をご覧ください。

スキルネイティブなエージェント（こちらも対応）： Hermes と OpenClaw は、このスキルの SKILL.md を直接読み込み、MCP にも対応しています。インストール手順は以下の各セクションをご覧ください。Cursor、Windsurf、Cline、Continue.dev、Zed でも MCP 経由で動作します。各ツールの詳しい接続方法は docs/which-agent.md をご覧ください。

複数のエージェントを使いますか？ 1 つのコマンドですべての対応エージェント（51 以上）にインストールできます：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 サーバーのみが含まれているため、付属の CLI がない場合は、先に以下の方法 A または方法 B のインストーラーを実行するか、既存のバイナリを指すように MAXIO_CLI_PATH を設定してください。詳細： #331。

Maxio MCP（.mcpb）をダウンロード - その後、Claude Desktop > Settings > Extensions を開き、ファイルを選択します。ワンクリックで完了し、JSON もシェルも不要です。（すべての Maxio リリースはリリースページで確認できます。）

Claude Code プラグインを使いたい場合は、マーケットプレイスを一度追加してからインストールしてください。ディレクトリ一覧の取得は不要で、すぐに使えます。

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

方法 A - AI エージェントにプロンプトを 1 つ貼り付ける（推奨）

Claude Code、Codex CLI、または Claude Cowork に以下をコピーします。

このエージェントのワークスペースに、Servosity/msp-skills から Maxio Skill と MCP サーバーをインストールしてください。このワークスペースで POSIX シェル（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 を実行して使い方を確認してください。

このプロンプトは、シェルを実行できるあらゆるエージェントで使えます。

方法 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 をご覧ください。各エージェントのセクションがあり、GitHub Copilot の servers キーや、リモート版 Microsoft 365 Copilot／Copilot Studio の手順も含まれています。Claude Desktop では、Settings > Extensions パネルを使うのが最も簡単です。JSON を編集する場合に使う MCP 設定ブロックについては、mcp-install.md に記載されています。

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 エージェントに次の指示を送ります（コピーしてください）：

https://github.com/servosity/msp-skills/tree/main/skills/maxio から maxio スキルをインストールしてください。このスキルでは、必須の CLI（maxio-cli）を openclaw: フロントマターのブロックからインストールする方法を定義しています。

OpenClaw はまだ一般公開されていません。フロントマターによる接続設定は事前に組み込まれており、OpenClaw のリリースと同時に有効になります。

認証する

Maxio ポータルから、CLI に必要な認証情報を設定します：

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、--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 エージェントからその課題を解消できます。

• 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 サーバーのみです。そのため、Maxio MCP サーバーを HTTP モードで実行する必要があります。このビルドの HTTP モードはパスワードを要求せず、すべてのネットワークインターフェースで待ち受け、開いたウェブページからアクセスできます。そのため、コネクターを再公開するまでは実行したり、トンネルの背後に配置したりしないでください。その理由については、mcp-install.md のセキュリティに関する注意をご覧ください。それまでは、Claude Desktop、Claude Code、または Codex をご利用ください。

Codex、Cursor、Windsurf、Cline、Copilot、Gemini でも使えますか？

はい。いずれも MCP に対応しています。ツール別のインストールコマンドは、上の一覧表と docs/which-agent.md の詳しい説明をご覧ください。

コーディングの知識は必要ですか？

いいえ。推奨するインストール方法は、Claude Code または Codex に一文を貼り付けるだけです。エージェントが SKILL.md を読み、インストールを実行します。代替方法として、OS ごとのワンラインインストーラー（bash または PowerShell）もあります。どちらの方法でも、コードを書く必要はありません。Maxio の認証情報を一度入力するだけです。

Maxio のデータは安全ですか？

データはお使いのマシンに保存されます。CLI と MCP サーバーはローカルバイナリです。SQLite ミラーは、ユーザーアカウント内のディレクトリに保存されます。AI エージェントに見えるのは CLI が返す内容のみで、通常は生の一括データではなくクエリ結果です。認証情報は環境変数またはエージェントの設定から読み込まれます。このリポジトリに含まれたり、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 と、MRR の推移履歴をスナップショットする maxio-cli mrr sync の 2 つの差分コマンドを実行します。どちらも前回の実行以降に変更されたデータのみを取得します。エンドポイントミラーコマンドと maxio-cli tail は Maxio から直接読み取るため、レート制限の対象になります。

Maxio のパートナーまたは顧客である必要がありますか？

ご自身の Maxio Advanced Billing API 認証情報（ユーザー名とパスワード）が必要です。それだけです。これは非公式のコミュニティ開発スキルであり、Maxio の製品ではないため、パートナープログラムへの参加や別途の登録は必要ありません。認証情報ですでにアクセスを許可されているデータのみを読み取ります。

Maxio ポータルの代わりになりますか？

いいえ。請求業務と設定の管理は引き続きポータルが担い、このスキルはその機能を補完します。このスキルを使うと、AI エージェントから収益の推移に関する回答をすばやく得られます。また、ライブ API では再構築できなくなった履歴のローカルコピーも維持できます。

費用はいくらですか？

無料です。Apache-2.0 ライセンスで提供されています。お支払いいただくのは、使用する AI エージェント（Claude、ChatGPT、Codex など）の料金のみです。料金は当社ではなく、AI プロバイダーから請求されます。

安全性モデル

Tier	Examples	Recommended agent policy
読み取り	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 spec（Anthropic、2025年12月、40以上のエージェント）に準拠しています。MCP と互換性があり、Hermes を含む、MCP に対応したあらゆるエージェントで動作します。OpenClaw に対応済みです（frontmatter はあらかじめ設定済みで、OpenClaw のリリースを待っています）。

Servosity がメンテナンスしています。Apache-2.0 ライセンスで提供されています。CLI Printing Press を使用して構築されました。最終更新日：2026-06-30。