SuperOps MCP

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

非公式です。SuperOps API 向けの、コミュニティが開発した Claude Code Skill および MCP サーバーです。SuperOps Inc. とは提携関係になく、同社による承認やスポンサー提供も受けていません。

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

すべての SuperOps PSA+RMM エンティティをターミナルで操作でき、ウェブ UI では答えられないエンティティ横断の質問に回答するローカルの SQLite ミラーも利用できます。すでにお使いの AI（ChatGPT（Plus/Pro+）、Claude Desktop、Codex、Claude Code、Claude Cowork、GitHub Copilot）に加え、リモート経由で Microsoft 365 Copilot / Copilot Studio および Google Gemini でも使えます。無料のオープンソースで、ノート PC 上で動作します。MSP オーナー向けに開発されました。コードは不要です。

エージェントで使う

MSP オーナーが実際に使う 6 つのエージェント（セルフサービスで、すぐに利用できます）：

使用する AI エージェント	SuperOps スキルのインストール方法
Claude Desktop	インストーラーを実行し、設定 > Extensions で superops-mcp を登録します（JSON の編集は不要です）。
ChatGPT（有料プラン）	インストーラーを実行し、superops-mcp を HTTPS 経由で公開して、Developer Mode コネクターとして登録します。
Codex CLI	以下のインストール用プロンプトを貼り付けます。
Claude Code	以下のインストール用プロンプトを貼り付けます。
Claude Cowork	以下のインストール用プロンプトを貼り付けます。
GitHub Copilot（VS Code）	インストーラーを実行し、mcp.json の servers キーの下に superops-mcp を追加してから、Agent モードを選択します。

ChatGPT では、superops-mcp --transport http を実行し、HTTPS の背後で公開します。ブリッジパッケージは不要です。mcp-install.md を参照してください。

Microsoft および Google の環境でも利用可能

導入基盤は大規模ですが、率直にお知らせします。これらはリモート／エンタープライズ向けの方法であり、インストールしたローカルバイナリを使う方法ではありません。

エージェント	必要なもの
Microsoft 365 Copilot / Copilot Studio	セルフサービスでは利用できません。 superops-mcp を HTTPS 経由でホストし、Copilot Studio（Tools > Add a tool > Model Context Protocol > Server URL）または宣言型エージェントに接続します。Copilot Studio ライセンスとテナント管理者権限が必要です。mcp-install.md を参照してください。
Google Gemini	Gemini CLI はローカルで動作します。Claude Code と同じです。Gemini アプリはリモートで動作し、ChatGPT と同じ HTTPS の方法を使います。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 で起動します。すべてのツールは、付属の superops-cli を呼び出します。2026-09-18 以降に公開されたリリースでは、この CLI がバンドル内に含まれています。それより前のバンドルには MCP サーバーのみが含まれているため、付属 CLI がない場合は、まず以下の Path A または Path B のインストーラーを実行してください（または、既存のバイナリを SUPEROPS_CLI_PATH に設定してください）。詳細： #331。

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

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

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

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

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

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

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

確認：

superops-cli --version

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

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

macOS / Linux：

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

Windows（PowerShell）：

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

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

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

/skills install servosity/msp-skills/skills/superops --force

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

OpenClaw にインストールする

OpenClaw エージェントに以下を伝えます（コピーして使ってください）。

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

OpenClaw はまだ一般公開されていません。frontmatter の設定は事前に含まれており、OpenClaw が公開されるとすぐに有効になります。

認証

CLI に必要な認証情報を設定します。SuperOps のAPI トークン（Settings > My Profile > API token）と、テナントのサブドメイン（Settings > MSP Information）です。

export SUPEROPS_API_TOKEN=<your api token>
export SUPEROPS_SUBDOMAIN=<your tenant subdomain>   # sent as the CustomerSubDomain header
export SUPEROPS_REGION=us                            # or eu for euapi.superops.ai (us is the default)
superops-cli doctor

doctor は、データを扱うコマンドを実行する前に認証情報が機能することを確認します。認証情報が拒否された場合でも終了コード 0 を返すため、スクリプトでは --fail-on error を追加してください。発行するトークンのスコープが権限の境界となり、CLI で実行できるのはそのトークンに許可された操作だけです。

このスキルでできること

MSP でよく聞かれる質問	コマンド
SLA 違反が迫っているのは誰ですか？技術者ごとにグループ化できますか？	superops-cli sla-watch --by tech --window 4h
アラートが未解決のままになっているクライアントはどれですか？	superops-cli alert-coverage --client Acme
重大なパッチが適用されておらず、現在アラートが発生しているエンドポイントはどれですか？	superops-cli at-risk-assets --client Acme
1 週間、誰も対応していない未完了チケットはどれですか？	superops-cli stale-tickets --days 7
あるクライアントの情報（サイト、ユーザー、契約、チケット、アセット、未払い請求書）はすべて確認できますか？	superops-cli client-360 "Acme Corp"
今月の請求処理を前に、請求可能時間はどこに集中していますか？	superops-cli unbilled --since 2026-05-01
トリアージエージェント向けに、作業ログ、クライアント、SLA を含む 1 件のチケット情報を取得できますか？	superops-cli context-ticket 12345 --agent
同期済みのすべてのチケット、アセット、クライアントを検索できますか？	superops-cli search "disk full"

これらのビューに加え、チケット、アセット、アラート、クライアント、サイト、ユーザー、契約、請求書、作業ログ、技術者、サービス項目、IT ドキュメント、KB など、SuperOps PSA+RMM のすべてのエンティティを、型付きの list／get サブコマンドで利用できます。また、raw query を使えば、型付きコマンドでラップされていない GraphQL 読み取りクエリを実行できます。すべてのコマンドは MCP ツールとしても利用できます。

コマンドの詳細はガイドを参照してください。AI エージェントの運用規約（--agent、--dry-run、変更を行う前に確認すべき場合）については、AGENTS.mdを参照してください。

このツールの特長

SuperOps のほとんどの統合や MCP サーバーは、質問ごとに GraphQL をリアルタイムで呼び出します。1 件のレコードなら問題ありません。しかし、「すべてのクライアントの未完了チケットのうち、SLA 違反が迫っているものと、その担当キューはどれか」といった質問を大規模に処理すると行き詰まります。API は読み取りをレート制限し、リストのペイロードにも、質問に必要なエンティティ間のリンクが含まれていないことがあります。

このスキルは、全文検索に対応したローカルの SQLite ミラーに SuperOps を同期します。集計に関する質問はローカルの SQL 結合 1 回で処理できるため、瞬時に結果が得られ、オフラインでも利用でき、AI には生データではなく回答が提示されます。sla-watch、client-360、at-risk-assets などの複合コマンドは、チケット、SLA、技術者、クライアント、契約、アセット、アラート、請求書を横断して結合します。ステートレスな API ラッパーでは実現できない処理です。

この課題を解決します

SuperOps が掲げるのは、PSA と RMM を 1 つのデータベースに統合することです。この点は実現されています。しかし、コンソールでは依然として一度に 1 つのエンティティしか確認できず、プラットフォーム独自の AI についても、サードパーティのレビュー担当者が述べているように「現実というより、ロードマップ上の話です」（Flamingo、「SuperOps Review for MSPs」、2026 年）。そのため、月末や QBR の前に実際に確認したい質問は、今も単一のコンソール画面ではまとめて確認できない、複数のエンティティにまたがるものです。SLA 違反が迫っているのは誰で、どの担当者のキューにあるのか。クライアントの請求対象時間のうち、未照合のものはどれくらいあるのか。パッチ未適用で、かつアラートが発生中のエンドポイントはどれか。また、GraphQL API を使って自分で実装するのも困難です。読み取りにはレート制限があり、こうした質問に必要な関連情報（アセットとチケットの関連付け、子アクティビティの集約タイムスタンプなど）も一部取得できないため、スクリプト側でデータを取得、キャッシュし、ローカルで結合する必要があります。

このスキルでできること：

• superops-cli sla-watch --by tech --window 4h - 解決 SLA に違反している、または違反が迫っている未完了チケットを、技術担当者ごとにグループ化して表示します。ディスパッチャーが朝のトリアージに使えます。
• superops-cli client-360 "Acme Corp" - クライアントと、そのサイト、ユーザー、契約、未完了チケット、アセット、未処理の請求書をまとめて表示します。コンソールの 6 つのタブを 1 つのコマンドにまとめられます。
• superops-cli at-risk-assets --client Acme - パッチ状況から未適用または重大なパッチの存在が示され、未解決のアラートもあるエンドポイントを表示します。優先順位を付けて対処できます。
• superops-cli unbilled --since 2026-05-01 - クライアントごとに、記録された請求対象の作業ログ時間を合計して表示します（照合の対象）。請求書の発行前に、請求対象時間がどこに集中しているかを把握できます。

初回実行時に sync を実行して、テナントのデータをローカルの SQLite に取り込みます。それ以降は、これらのビューをオフラインで、即座に、レート制限なしで利用できます。

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

既知の制限（正直にお伝えします）

これらのビューは、SuperOps のリスト API で実際に取得できる情報から計算されます。CLI では、代替指標を使っていることを明示しています。

• unbilled には、クライアントごとの請求対象の記録済み時間が表示されます。厳密な「作業ログと請求書の差分」ではありません。API には、各エントリに「請求済み」かどうかを示すフラグがないためです。
• at-risk-assets と alert-coverage では、リストのペイロードにアセットとチケットの関連付けが含まれていないため、「現在問題を引き起こしている状態」の代替指標として、未解決のアラートを使用します。
• context-ticket では、同期済みのチケット、その作業ログ、クライアント、SLA をまとめて表示します。会話やメモのスレッドは、superops-cli tickets <id> でリアルタイムに取得します。

よくある質問

ChatGPT で使えますか？

はい。Plus、Pro、Team、Business、Enterprise、Education の各プランで利用できます（Free プランでは、まだ Developer Mode を利用できません）。ChatGPT は HTTPS 経由でリモート MCP サーバーに接続します。ローカルの stdio バイナリには接続しません。SuperOps MCP サーバーはローカルで動作しますが、HTTP にネイティブ対応しています。superops-mcp --transport http --addr :7777 で起動し、HTTPS トンネルまたは独自のリバースプロキシの背後に配置してください。ブリッジパッケージは必要ありません。手順は mcp-install.md をご覧ください。

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

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

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

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

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

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

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

ローカルミラーは、読み取り時に API へのアクセスが発生しないようにするためのものです。最初の sync の後は、エンティティをまたいだビュー（sla-watch、client-360、at-risk-assets、alert-coverage、unbilled、stale-tickets）はローカルの SQLite に対して実行されるため、API 呼び出しはゼロです。ライブ呼び出しでは --rate-limit によるスロットリングが適用されます。また、sync は差分のみを取得するため、増分実行が可能で、中断後も再開できます。トークンでアクセスできないリソースは失敗ではなく警告として扱います。

US と EU の SuperOps リージョンで動作しますか？

はい。デフォルトでは US ホストが使われます。EU ホスト（euapi.superops.ai）を指定するには、SUPEROPS_REGION=eu を設定してください。テナントのサブドメインは SUPEROPS_SUBDOMAIN に設定します。CLI は各リクエストでこれを CustomerSubDomain ヘッダーとして送信します。

チケットを作成または更新できますか？

型付きコマンドは、調査、エクスポート、同期、分析を目的とした読み取り専用の設計です。書き込み方法は、型付きコマンドで対応していない操作（例：createTicket、updateTicket、resolveAlerts）を実行するための、サポート対象の代替手段である raw mutation のみです。--dry-run と組み合わせると、実行される GraphQL リクエストを正確にプレビューできます。必ず人間が確認する手順を設けてください。raw query は読み取り専用の代替手段です。

SuperOps コンソールの代わりになりますか？

いいえ。そのような目的ではありません。ディスパッチ、作業時間の入力、請求など、アプリ内のワークフローには引き続きコンソールが最適です。このスキルを使うと、すでに利用している AI エージェントからテナントのデータにアクセスでき、PSA と RMM を横断して結合したデータから、現在どのコンソール画面でもまとめて確認できない質問への回答を得られます。

費用はいくらですか？

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

安全性モデル

ティア	例	推奨されるエージェントポリシー
読み取り	すべての型付きコマンドと raw query - sla-watch、client-360、at-risk-assets、alert-coverage、unbilled、stale-tickets、tickets list、assets list、search、sync	許可
書き込み（ミューテーションの代替手段）	raw mutation - 唯一の書き込み方法。読み取り専用の型付きコマンドで対応していない操作（createTicket、updateTicket、resolveAlerts）を実行します	--dry-run でプレビューし、レビュー後に書き込みを実行
破壊的操作	型付きの破壊的コマンドはありません。削除は raw mutation で実行する、明示的な破壊的 GraphQL 操作となります	必ず人間が関与

すべての型付きコマンドは読み取り専用です。バイナリからリモート環境を変更する唯一の方法は raw mutation であり、--dry-run は送信せずに GraphQL リクエストを正確に表示します。エージェントポリシーに承認プロセスを設けてください。プレビューし、リクエストを表示し、承認を得てから実行します。

最も強力な制御手段は、SuperOps 認証情報に付与するスコープです。CLI が実行できるのは、認証情報で許可された操作のみです。アクセスを制限する方法などの詳細は、governance.md をご覧ください。

ステータス

ベータ版です。SuperOps API の機能を対象に検証済みで、毎週開催する Build Sessions では、本番テナントに接続して実行している MSP による検証を進めています。compoundingteams.com/build-sessions から参加登録してください。

---

標準規格。 オープンな Agent Skills 仕様（Anthropic、2025 年 12 月、40 以上のエージェント）に準拠しています。MCP に対応しており、Hermes を含む、MCP 対応のあらゆるエージェントで動作します。OpenClaw に対応するよう準備済みです（フロントマターは設定済みで、OpenClaw のリリース待ちです）。

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