Auvik MCP

Auvik + AI - ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini、および MCP に対応するすべてのエージェント向け

非公式です。Auvik API 向けにコミュニティが作成した Claude Code スキルおよび MCP サーバーです。Auvik Networks Inc. とは提携しておらず、同社による承認や支援も受けていません。

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

すべての Auvik エンドポイントをコマンドとして利用できるほか、Auvik の UI や API では得られない、複数のクライアントにまたがる回答も得られます。すでにお使いの AI で利用できます - ChatGPT（Plus/Pro+。このコネクターが再公開されるまで一時停止中。詳しくは mcp-install.md をご覧ください）、Claude Desktop、Codex、Claude Code、Claude Cowork、GitHub Copilot に加え、リモート方式で Microsoft 365 Copilot / Copilot Studio と Google Gemini にも対応しています。無料のオープンソースで、ノート PC 上で動作します。MSP のオーナー向けに構築されており、コードは不要です。

お使いのエージェントで利用できます

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

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

お使いの AI エージェント	Auvik スキルのインストール方法
Claude Desktop	インストーラーを実行し、Settings > Extensions で auvik-mcp を登録します（JSON の編集は不要です）。
ChatGPT（有料プラン）	このコネクターが再公開されるまで一時停止中です。ChatGPT には HTTP モードが必要ですが、このビルドではパスワードが不要で、すべてのネットワークインターフェースで待ち受けます。mcp-install.md のセキュリティに関する注意をご覧ください。
Codex CLI	下記のインストール用プロンプトを貼り付けます。
Claude Code	下記のインストール用プロンプトを貼り付けます。
Claude Cowork	下記のインストール用プロンプトを貼り付けます。
GitHub Copilot（VS Code）	インストーラーを実行し、servers キーの下にある mcp.json に auvik-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 にも対応しています。詳しくは下記のインストール手順をご覧ください。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 で起動します。すべてのツールは、同梱の auvik-cli を呼び出します。2026-09-18 以降に公開されたリリースでは、この CLI がバンドル内に含まれています。それ以前のバンドルに含まれるのは MCP サーバーのみです。同梱の CLI が見つからない場合は、先に以下の Path A または Path B のインストーラーを実行するか、既存のバイナリを指すように AUVIK_CLI_PATH を設定してください。詳細： #331。

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

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

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

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

Claude Code、Codex CLI、または Claude Cowork に次の内容をコピーします。

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

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

確認：

auvik-cli --version

最新バージョンへのアップグレード

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

macOS / Linux：

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

Windows（PowerShell）：

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

Claude Desktop の .mcpb をお使いの場合：最新の .mcpb（このセクションの先頭）をダウンロードし、Settings > Extensions で再度選択してください。Claude Code プラグインをお使いの場合：/plugin update auvik@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 パネルを使う方法です。MCP 設定ブロック（JSON の編集を希望するユーザー向け）は mcp-install.md に記載されています。

Hermes にインストールする

Hermes CLI から：

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

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

/skills install servosity/msp-skills/skills/auvik --force

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

OpenClaw にインストールする

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

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

OpenClaw はまだ一般公開されていません。frontmatter の設定は事前に用意されており、OpenClaw の公開と同時に有効になります。

認証する

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

AUVIK_USERNAME=<value> AUVIK_API_KEY=<value> auvik-cli doctor

doctor は設定、パス、API への到達性を確認し、認証済みの読み取りを 1 回実行して認証情報自体を検証します。認証情報の状態として、valid、rejected (HTTP 401)、scope-limited (HTTP 403)、または検証プローブが確認可能なエンドポイントに到達できなかった場合は not verified を報告します。認証情報が拒否された場合でも終了コードは 0 となるため、スクリプトでは --fail-on error を追加してください。

このスキルでできること

MSPから繰り返し寄せられる質問	コマンド
すべてのクライアントでサポート終了を過ぎているハードウェアは？	auvik-cli eol --bucket expired
QBR資料向けに、今後90日以内にサポート終了を迎えるのは？	auvik-cli eol --within 90
設定バックアップがまったくないデバイスは？	auvik-cli configuration audit --finding no_backup
前回の同期以降、全体で追加、変更、削除されたものは？	auvik-cli inventory diff --since 7d
請求対象のデバイス数とインベントリの数が一致しないクライアントは？	auvik-cli usage reconcile --mismatch-only
Auvik が完全にポーリングできないデバイスと、失敗している認証情報は？	auvik-cli device discovery-gaps --method snmp
アラートのノイズが最も多いデバイスとクライアントは？	auvik-cli alert noise --since 30d --group-by client
誰も使用していない SaaS ライセンスは？	auvik-cli asm shadow --finding unused_licenses

コマンドの全リファレンスは guide.md を参照してください。AI エージェントの運用規約（--agent、--dry-run、変更を加える前に確認すべき状況）については、AGENTS.md を参照してください。

このスキルの特徴

ほとんどの Auvik 連携機能や MCP サーバーは、質問のたびにライブ API を呼び出します。1件のレコードを扱うなら問題ありません。しかし、QBR の前週に「全40クライアントでサポート終了を過ぎているのはどれで、そのうちまだ保証期間内なのはどれか」と尋ねるような規模になると、対応できません。

このスキルは Auvik のデータを全文検索機能付きのローカル SQLite ミラーに同期します。集計に関する質問は、ローカルでの SQL 結合1回で答えられるため、即座に、オフラインでも処理でき、AI には生データではなく答えが渡されます。eol、usage reconcile、changes などの複合コマンドは、デバイスのインベントリ、ライフサイクルと保証の日付、請求利用記録、設定の改訂履歴、エンティティ監査ログ、アラート履歴を横断して結合します。これは、ステートレスな API ラッパーでは実現できません。

利便性の問題ではなく、構造上の制約によるギャップが1つあります。Auvik の API は削除イベントを出力しません。 filter[modifiedAfter] で取得できるのは追加と変更だけなので、廃止されたデバイスは一覧の応答に表示されなくなるだけです。削除を検出するには、自分で以前のフリートの状態を保持しておく必要があります。まさにその記録を行うのが inventory diff --snapshot です。

このスキルで解決できる課題

Auvik の料金は請求対象デバイスごとに発生し、請求額を左右する台数は画面上の数字です。その数字が変わっても、どのデバイスが変動の原因なのかは表示されません。実務上の答えはツールの限界で終わり、データをエクスポートして手作業で数えることになります。所有者が Auvik に尋ねる質問はどれも同じ構図です。データ自体はあるのに、集計結果がありません。

• 請求に関する異議申し立て。 usage reconcile --mismatch-only は、各クライアントの請求対象台数を同期済みのインベントリと並べ、差異のある両側のデバイス行を示します。
• 更新についての相談。 eol --within 90 は、全クライアントのデバイスを、サポート終了日、製品寿命終了日、販売終了日、保証終了日のうち最も早い日に基づいて分類します。
• 通知されない廃止。 inventory diff --since 7d は、削除されたものを報告します。Auvik の API は削除を通知しません。
• バックアップのないスイッチ。 configuration audit --finding no_backup は、保存済みの設定バックアップがないデバイス、バックアップが古いデバイス、または実行中の設定として何も記録されていないデバイスを検出します。
• 誰にも見えない機器。 device discovery-gaps は、検出状況と認証情報のプローブ結果を結合するため、「なぜこの機器をポーリングできないのか」を3つの画面ではなく1つのコマンドで確認できます。

詳しい説明は pain-point.md を参照してください。

よくある質問

ChatGPT で使えますか？

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

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

データはお使いのマシンに保存されます。CLI と MCP サーバーはローカルバイナリであり、リモートエージェント向けに HTTP モード（auvik-mcp --transport http または PP_MCP_TRANSPORT=http）を意図的に起動しない限り、MCP サーバーは stdio 経由で動作します。このビルドでは HTTP モードを使わないでください。パスワードを求めず、すべてのネットワークインターフェースでリッスンするため、コネクターが再公開されるまで停止しています（mcp-install.md のセキュリティに関する注記をご覧ください）。SQLite ミラーはユーザーアカウント配下のディレクトリに置かれます。AI エージェントに見えるのは CLI が返す情報のみで、通常はクエリ結果であり、生データの一括データではありません。認証情報は環境またはエージェントの設定から読み込まれます。MSP Skills に含まれたり、MSP Skills によってどこかへ送信されたりすることはありません。

ユーザー名と API キーの両方が必要なのはなぜですか？

Auvik は HTTP Basic 認証を使用します。Auvik ユーザーのメールアドレスがユーザー名、API キーがパスワードです。単一トークン形式はありません。また、正しいリージョンのホストも必要です。AUVIK_BASE_URL で us1、us2、eu1 などを選択します。間違ったリージョンを指定すると、キーが間違っている場合とまったく同じ 401 が返されます。

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

ほとんどの場合、達しません。それがミラーの目的です。読み取りは sync が行います。その後、8 つのクライアント横断コマンドはローカルの SQLite から結果を返し、API には一切アクセスしません。そのため、質問を再度行っても上流でのコストはかかりません。

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

いいえ。ライブのネットワーク状態を確認し、アラートキューに対応する場所は引き続き Auvik です。このツールは、ポータルでは答えにくい質問に対応します。すべてのクライアントを横断する質問や、異なる時点を比較する質問です。

費用はいくらですか？

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

安全モデル

ティア	例	推奨されるエージェントポリシー
読み取り	eol、configuration audit、inventory diff、usage reconcile、device discovery-gaps、alert noise、asm shadow、changes、sync、search、export、すべての list / get、および settings と stat の SNMP ポーラーコマンドすべて（設定コマンドのように見えますが、GET のみです）	許可
書き込み（定型）	alert dismiss-single とその使いやすい別名 alert dismiss。Auvik API がサポートする唯一の書き込みです。両方の名前を許可リストに追加します	--dry-run でプレビューしてから、レビュー済みの書き込みを実行
認証情報／セキュリティ	auth set-credentials（認証情報を CLI の認証情報ファイルに書き込みます）、auth logout	必ず人間が介在
データの外部送信	任意のコマンドでの --deliver webhook:<url>（そのコマンドの出力を指定した URL に POST します）、feedback --send、および**AUVIK_FEEDBACK_ENDPOINT が設定され、AUVIK_FEEDBACK_AUTO_SEND=true の場合の、引数なしの feedback**。この組み合わせではフラグが一切不要なため、両方の環境変数が設定された後に feedback をローカル専用として許可リストに登録するのは安全ではありません（エンドポイントが設定されていない場合、feedback はローカルファイルへの書き込みのみを行います）	必ず人間が介在。Webhook の送信先により、クライアントデータが端末の外部に送信されます

Auvik API には削除機能も管理用の書き込み機能もないため、制限対象となる「破壊的操作」または「管理者」ティアはありません。

最も強力な制御は、Auvik の認証情報に付与するスコープです。CLI が実行できるのは、その認証情報に許可された操作だけです。制限する方法を含む詳細は、governance.md をご覧ください。

ステータス

ベータ版で、実環境での検証待ちです。コマンド群は Auvik API 仕様から生成されており、クライアント間の分析は仕様由来のフィクスチャを使ったユニットテストでカバーされています。しかし、本番の Auvik テナントでこれを実行している MSP からの一連の検証結果はまだないため、ここに記載された内容は実際の Auvik の応答で検証されていません。ご自身のテナントで実行した場合、動作確認フォームへの記入が、このコネクターに実績バッジが付くきっかけになります。MSP は毎週の Build Sessions でこのようなコネクターを徹底的に試しています。compoundingteams.com/build-sessions から参加登録してください。

---

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

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