Afi MCP

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

非公式です。Afi API 用にコミュニティが開発した Claude Code Skill と MCP サーバーです。Afi とは提携しておらず、承認や後援も受けていません。

_{スキルの全ページ - インストール方法、できること、安全性モデル。}

Servosity からのもうひとつの製品。 バックアップと DR は Servosity 独自の分野です。ファーストパーティの Servosity コネクターを使うと、同じくフリート全体を対象としたローカルミラー方式（フリートの状況把握、古いバックアップ、復元、QBR レポート）を Servosity Backup and DR で利用できます。

Afi SaaS バックアップ向けの初の CLI です。公開 API を全面的にカバーし、レート制限のある 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 上でも実行しないでください。このビルドにはパスワードがなく、 すべてのネットワークインターフェースでリッスンし、ブラウザーのリバインディング対策が導入される前のものです。 そのため、開いた Web ページから接続できます。MCP ツールは、認証情報を使って変更を加えることもできます。 デフォルトの stdio トランスポートを使用してください。リモートエージェント用にトンネルを設定している場合は、 停止してください。修正は準備中です。

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

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

ChatGPT にはリモートの HTTPS サーバーが必要です。そのため、このコネクターの HTTP モードが必要になりますが、コネクターが再公開されるまで一時停止中です。このビルドの 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 にも対応しています。インストール方法は以下の各セクションをご覧ください。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 で起動します。各ツールは付属の afi-cli をシェルから呼び出します。2026-09-18 以降に公開されたリリースには、この CLI がバンドルに含まれています。それ以前のバンドルに含まれるのは MCP サーバーのみです。バンドルに付属 CLI がない場合は、先に以下の Path A または Path B のインストーラーを実行するか、AFI_CLI_PATH に既存のバイナリへのパスを設定してください。詳細： #331。

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

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

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

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

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

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

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

確認：

afi-cli --version

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

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

macOS / Linux：

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

Windows（PowerShell）：

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

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

Hermes にインストールする

Hermes CLI から実行します。

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

Hermes のチャットセッション内で実行します。

/skills install servosity/msp-skills/skills/afi --force

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

OpenClaw にインストールする

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

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

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

認証する

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

AFI_API_KEY=<value> afi-cli doctor

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

このスキルでできること

MSP からよく聞かれる質問	コマンド
バックアップ保護がまったくないリソースはどれですか？	afi-cli coverage-gaps --agent
保護されているリソースのうち、バックアップが古いもの（気付かれないまま失敗しているもの）はどれですか？	afi-cli backup-stale --max-age 48h --agent
今朝の全テナントの状態は良好ですか？それとも、失敗したのはどれですか？	afi-cli fleet-health --failed-only --agent
QBR やチケット対応に使える、あるテナントのバックアップ状況の全容は何ですか？	afi-cli tenant-scorecard <tenant-id> --agent
Afi のライセンス数は過不足がありますか？	afi-cli reconcile-licenses --agent
Multi-Geo テナント全体で、Afi における [email protected] のユーザー情報は何ですか？	afi-cli resolve <email-or-id> --agent
退職する従業員のメールボックスを安全にバックアップしてから解放するにはどうすればよいですか？	afi-cli offboard <resource-id> --tenant <tenant-id> --reason "employee departure"

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

このスキルの特長

ほとんどの Afi 連携機能や MCP サーバーは、質問ごとにリアルタイムの API 呼び出しを中継します。1 件のレコードなら問題ありません。しかし、たとえば「47 のすべてのクライアントテナントで、バックアップポリシーが設定されていないメールボックスはどれか」と尋ねるような大規模な処理では機能しなくなり、ポーリングによって Afi の公開 API のスロットリングを受けます。

このスキルは、全文検索に対応したローカルの SQLite ミラーに Afi のデータを同期します。集計に関する質問はローカルの SQL 結合 1 回で処理できるため、即座にオフラインで回答でき、AI には生データではなく答えが渡されます。coverage-gaps、backup-stale、reconcile-licenses などの複合コマンドは、すべてのテナントにわたってリソースを保護設定、アーカイブ、購入済みサブスクリプションと一度に結合します。これは、状態を保持しない API ラッパーではできない処理です。

このスキルで解消できる問題

SaaS のバックアップには、MSP のオーナーが r/msp で何度も取り上げる、気づきにくい障害モードがあります。実行されていると思っていたバックアップが、実は実行されていないという問題です。Microsoft 365 や Google Workspace にメールボックスやサイトが作成され、オンボーディングのチケットが完了しても、バックアップポリシーが適用されたことを誰も確認しません。あるいは、ポリシーは適用されているのに、夜間のアーカイブがひそかに保存されなくなっているにもかかわらず、ポータルでは「保護済み」と表示されたままです。クライアントから復元を求められ、データがそもそも存在しなかったとわかるまで、この問題に気づくことはありません。よく聞かれるのは、「すべてのクライアントで M365 のバックアップが実行されていることを、実際にはどう確認すればよいのか」という質問です。Afi にはデータがありますが、ポータルではクライアントごとに確認する必要があり、ベンダーからポーリングしないよう求められている API を使うため、一度に確認できるのは 1 つのテナントだけです。

このスキルは、ローカルミラーを使ってそのギャップを解消します。

• afi-cli coverage-gaps --agent - バックアップで保護されていないすべてのリソースを、フリート全体から検出します。見落としがちな箇所を明らかにします。
• afi-cli backup-stale --max-age 48h --agent - 保護対象のリソースのうち、最新のアーカイブが古くなっているものを検出します。これは、気づきにくい障害のパターンです。
• afi-cli fleet-health --failed-only --agent - 月曜日にフリート全体が正常か確認する作業を、1 つの表で行えます。
• afi-cli reconcile-licenses --agent - 購入済みのライセンス数と、実際に保護されている数を照合します。
• afi-cli offboard <resource-id> --tenant <tenant-id> --reason "employee departure" - 最新のバックアップが検証されるまでは保護の解除を拒否する、安全対策付きのアーカイブ後の解除処理を行います。

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

よくある質問

ChatGPT で使えますか？

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

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

データはお使いのマシンに保存されます。CLI と MCP サーバーはローカルバイナリです。SQLite ミラーは、ユーザーアカウント内のディレクトリに保存されます。AI エージェントが参照するのは CLI の返却内容のみです。通常はクエリ結果であり、生の一括データではありません。認証情報は環境変数またはエージェントの設定から読み込まれます。MSP Skills に同梱されたり、外部に送信されたりすることはありません。

Afi の API レート制限に抵触しますか？

想定どおりに使えば、抵触しません。Afi は継続的にポーリングするアプリケーションをスロットリングし、利用を停止する場合もあります。そのため、このスキルでは、レート制限に配慮した 1 回の処理（afi-cli fleet-sync）でフリート全体をローカルストアに同期し、その後はすべての質問に対して、そのストアを使ってオフラインで回答します。同期はスケジュールに従って行い、質問のたびには行いません。

Afi の顧客である必要がありますか？また、API キーにはどのようなアクセス権が必要ですか？

はい。Afi アカウントと、Afi ポータルで作成する Application API キーが必要です（組織レベルでは Configuration > Apps、テナントレベルでは Service > Settings > Apps）。キーは Application のインストール範囲を引き継ぐため、CLI からアクセスできるのは、その Application がインストールされている組織とテナントのみです。各 Application では、ローテーション用に 2 つのキーを利用できます。

これは Afi ポータルに取って代わるものですか？

いいえ。復元、エクスポート、ポリシーの編集は引き続き Afi ポータルで行います。公開 API ではこれらの操作を利用できません。このスキルは、読み取り、レポート、保護されたオフボーディングを担います。フリート全体に関する質問に答え、検証済みのアーカイブ後に保護を解除する処理を実行したうえで、ポータルでしか実行できない操作を行えるよう、ポータルに戻します。

費用はかかりますか？

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

安全性モデル

ティア	例	推奨されるエージェントのポリシー
読み取り	coverage-gaps、backup-stale、fleet-health、tenant-scorecard、reconcile-licenses、resolve、fleet-sync、およびすべての list／get	許可
書き込み（定型）	orgs create、import、tenants resources protections-protect、tenants jobs tasks-trigger	--dry-run でプレビューしてから、レビュー済みの書き込みを実行
認証情報／セキュリティ	auth set-token、auth logout	必ず人が関与
破壊的操作／設定	offboard（保護を解除）、tenants resources protections-unprotect、tenants archives delete	必ず人が関与

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

ステータス

ベータ版です。Afi 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。