Gradient MSP MCP

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

非公式です。Gradient MSP API 用にコミュニティが構築した Claude Code スキルおよび MCP サーバーです。Gradient MSP, Inc. とは提携しておらず、同社による推奨や支援も受けていません。

_{▶ 30 秒のデモを見る — デモデータはシミュレーションです。表示されているコマンドはすべて、実際の CLI に存在します。}

Gradient MSP の Synthesize ベンダー API をターミナルから利用できます。一度の請求再構築で一括使用量を送信できるほか、ローカルの送信差異台帳や、ポータルや SDK では利用できないアラートからチケットへの追跡機能を備えています。すでにお使いの 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）は、localhost 上であっても実行しないでください。このビルドにはパスワードがなく、 すべてのネットワークインターフェースでリッスンし、ブラウザー再バインド対策が導入される前のものなので、 開いた Web ページからアクセスできてしまいます。また、MCP ツールはお客様の認証情報を使って 変更を行うこともできます。デフォルトの stdio トランスポートを使用してください。リモートエージェント用に トンネルを設定した場合は、停止してください。修正版は準備中です。

MSP オーナーが実際に使っている 6 つのエージェント（セルフサービスで、現在利用可能）：

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

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

Microsoft と Google のスタックにも対応

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

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

スキルにネイティブ対応するエージェント（こちらも対象です）： Hermes と OpenClaw は、このスキルの SKILL.md を直接読み込み、MCP にも対応しています。以下のインストール手順をご覧ください。MCP 経由で Cursor、Windsurf、Cline、Continue.dev、Zed でも動作します。ツールごとの詳しい接続方法：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 で起動します。各ツールは付属の gradient-cli をシェル経由で実行します。2026-09-18 以降のリリースでは、この CLI がバンドルに同梱されています。それ以前のバンドルに含まれるのは MCP サーバーのみです。付属の CLI がない場合は、先に以下の Path A または Path B のインストーラーを実行するか、GRADIENT_CLI_PATH に既存のバイナリを指定してください。詳細： #331。

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

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

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

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

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

このエージェントのワークスペースに、Servosity/msp-skills から Gradient MSP スキルと MCP サーバーをインストールしてください。このワークスペースで POSIX シェル（macOS、Linux、WSL、または Bash）を使う場合は、bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/gradient/install.sh) を実行してください。Windows PowerShell を使う場合は、iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/gradient/install.ps1 | iex を実行してください。その後、README の手順に従って認証し、gradient-cli --help を実行して使い方を確認してください。

シェルを実行できるエージェントであれば、同じプロンプトを使えます。

Path B - インストーラーを自分で実行する

Windows（PowerShell）：

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

macOS / Linux：

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

インストーラーは gradient-cli（CLI）と gradient-mcp（MCP サーバー）の両方を、ユーザーの bin パスに配置します。Claude Code、Codex、Cowork は、このディレクトリにある SKILL.md を通じてスキルを検出します。

確認：

gradient-cli --version

最新バージョンにアップグレードする

インストーラーは常に最新リリースを取得します。アップグレードするには再実行してください。

macOS / Linux：

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

Windows（PowerShell）：

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

Claude Desktop の .mcpb を使っている場合：最新の .mcpb（このセクションの冒頭）をダウンロードし、Settings > Extensions で再選択してください。Claude Code プラグインを使っている場合：/plugin update gradient@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/gradient --force

Hermes のチャットセッション内で：

/skills install servosity/msp-skills/skills/gradient --force

Hermes は MCP をネイティブにサポートしているため、gradient-mcp サーバーも直接使用できます。インストール方法と環境変数は同じです。

OpenClaw にインストールする

OpenClaw エージェントに次の内容を伝えてください（コピーして使用できます）。

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

OpenClaw はまだ一般公開されていません。frontmatter の接続設定はあらかじめ含まれており、OpenClaw の公開と同時に有効になります。

認証する

Gradient MSP ポータルから取得した、CLI に必要な認証情報を設定します。

GRADIENT_TOKEN=<value> gradient-cli doctor

doctor を実行すると、データにアクセスする操作を行う前に認証情報が有効かどうかを確認できます。認証情報が拒否された場合も終了コードは 0 になるため、スクリプトでは --fail-on error を追加してください。

このスキルでできること

MSP からよく聞かれる質問	コマンド
使用量の集計ファイル全体を送信し、課金を一度だけ正確に再構築するには？	gradient-cli usage push --file ./counts.csv --agent
直近 2 回の送信の間に使用量が変化したアカウントは？	gradient-cli usage drift --agent
アラートを送信し、PSA チケットが実際に作成されたことを確認するには？	gradient-cli alert send --account "123456789" --title "Backup failure" --wait --agent
送信したアラートのうち、チケットにならなかったものは？	gradient-cli alert trace --stuck --agent
マッピングされていないアカウント、またはベンダー SKU が不足しているアカウントは？	gradient-cli hygiene unmapped --agent
インテグレーションを有効化できる状態ですか？	gradient-cli status ready --agent
1 つのアカウントとサービスに、単発のユニット数を追加するには？	gradient-cli billing <serviceId> --account-id "123456789" --unit-count 42
認証情報は有効ですか？また、インテグレーションの状態はどうなっていますか？	gradient-cli integration get --agent

コマンドの全リファレンスは guide.md を参照してください。AI エージェントの操作ルール（--agent、--dry-run、変更を行う前に確認すべきタイミング）については、AGENTS.md を参照してください。

このスキルの特長

多くの Gradient MSP インテグレーションや MCP サーバーは、質問ごとにリアルタイムの API 呼び出しを行います。1 件のレコードを扱うなら問題ありません。しかし、前回の送信以降に請求対象のユニット数が変化したアカウントや、送信した 200 件のアラートのうち PSA チケットにならなかった件数を調べるような、大規模な処理には対応できません。

このスキルは Gradient MSP を全文検索機能付きのローカル SQLite ミラーに同期し、送信した集計値をすべてローカルの台帳に記録します。集計に関する質問はローカルで一度検索するだけで回答できるため、即座にオフラインで処理でき、AI には生データではなく回答が渡されます。usage drift、hygiene unmapped、alert trace --stuck のような複合コマンドでは、アカウント、サービス／SKU のマッピング、送信台帳をまたいで照合できます。ステートレスな API ラッパーでは実現できない処理です。

この課題を解決します

請求照合は、MSP の利益率を継続的に圧迫します。請求サイクルごとに、誰かが各ベンダーから CSV をダウンロードし、フィールドを PSA に手作業で対応付け、変動したライセンス数をすべて見落とさず把握できたことを願います。これは r/msp でも常に話題に上る問題です。Gradient MSP の独自調査では、手作業の場合、自動化する場合に比べて最大 90％多くの時間がかかるとされています。そのため、1,000 社を超える MSP が Synthesize を利用しています。しかし、Synthesize でプログラムから利用できる唯一の手段は、連携ごとにスクリプトプロジェクトが必要な PowerShell SDK です。そのため、照合を支えるプッシュ処理は、送信内容の記録もない、壊れやすい使い捨てスクリプトに頼っています。

このスキルは、そのギャップを埋めます。

• usage push - 件数をまとめた CSV または JSON ファイル全体を一度にプッシュし、請求の再構築は正確に 1 回だけ実行します。
• usage drift - 請求書発行前の事前確認です。直近 2 回のプッシュの間に件数が変わったアカウントを確認できます。
• alert send --wait / alert trace --stuck - アラートを送信し、PSA チケットが作成されるまで処理をブロックします。作成されなかったアラートを一覧表示します。
• hygiene unmapped - マッピングされていないすべてのアカウントと SKU の不足を、1 つの作業キューにまとめて表示します。
• status ready - 連携を有効にする前に、実行可否を確認できます。

詳しい説明は、pain-point.md をご覧ください。

よくある質問

ChatGPT で使えますか？

このビルドでは使えません。ChatGPT（Plus、Pro、Team、Business、Enterprise、Education プラン。Free ではまだ Developer Mode を利用できません）が接続できるのは、HTTPS 経由のリモート MCP サーバーのみです。そのため、Gradient MSP MCP サーバーを HTTP モードで実行する必要があります。このビルドの 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 ごとに 1 行のインストーラー（bash または PowerShell）も用意されています。どちらの方法でも、コードを書く必要はありません。Gradient MSP の認証情報を一度入力するだけです。

Gradient MSP のデータは安全ですか？

データはお使いのマシンに保存されます。CLI と MCP サーバーはローカルのバイナリです。SQLite のミラーは、ユーザーアカウント内のディレクトリに保存されます。AI エージェントに表示されるのは CLI が返す情報だけで、通常はクエリ結果であり、大量の生データではありません。認証情報は環境変数またはエージェントの設定から読み取られます。このリポジトリに含められたり、MSP Skills によってどこかへ送信されたりすることはありません。

必要な認証情報と設定方法を教えてください。

Synthesize のベンダートークンが必要です。GRADIENT_TOKEN に <vendorApiKey>:<partnerApiKey> の base64 値を設定するか、GRADIENT_VENDOR_API_KEY と GRADIENT_PARTNER_API_KEY を設定してください。CLI がトークンを自動生成します。GRADIENT_BASE_URL の設定は任意です。gradient-cli integration get を実行すると、認証情報が機能することを確認できます。

Synthesize ポータルや Managed Billing Reconciliation の代わりになりますか？

いいえ。マッピングの承認と照合の確認は、引き続き Synthesize ポータルで行います（または Gradient の MBR サービスが対応します）。この CLI はベンダーおよび連携側のツールです。アカウント、サービス、使用件数をプッシュし、プッシュした内容を監査し、アラートから PSA チケットまでの経路を追跡します。ポータルを補完するものであり、ポータルにログインするものではありません。

Gradient MSP API のレート制限に達しますか？

CLI がライブ API と通信するのは、指示したときだけです。また、一括処理の usage push では、行ごとに請求を再構築するのではなく、最後に 1 回だけ呼び出します。読み取り中心の処理は、sync の後はローカルの SQLite ミラーに対して実行されます。必要に応じて、グローバルフラグ --rate-limit で 1 秒あたりのリクエスト数を制限できます。

費用はかかりますか？

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

安全性モデル

Tier	例	推奨されるエージェントのポリシー
読み取り	integration get、vendor get、services get、accounts list、usage drift、alert trace、hygiene unmapped、status ready、analytics	許可
書き込み（定型）	usage push、billing、alert send、alerting、import、accounts create、accounts update、accounts update-one、services create、mappings create、mappings update、mappings update-bulk、integration update-status、vendor update	--dry-run でプレビューしてから、レビュー済みの書き込みを実行
認証情報／設定	auth set-token、auth logout（ローカルの認証情報ファイルのみ）	必ず人間が介在
破壊的操作	なし - Synthesize ベンダー API には削除コマンドがありません	必ず人間が介在

最も強力な制御は、Gradient MSP の認証情報に付与する権限範囲です。CLI で実行できるのは、その認証情報で許可された操作だけです。制限を設ける方法を含む詳細については、governance.md をご覧ください。

ステータス

ベータ版です。Gradient MSP API の機能に照らして検証済みで、毎週開催している Build Sessions では、自社の本番テナントで実際に運用する MSP による検証も進めています。compoundingteams.com/build-sessions から参加をお申し込みください。

---

標準規格。 オープンな Agent Skills spec（Anthropic、2025 年 12 月、40 以上のエージェント）に準拠しています。MCP と互換性があり、Hermes を含む、MCP 対応エージェントで動作します。OpenClaw に対応済みです（フロントマターの設定は完了しており、OpenClaw の公開待ちです）。

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