AppDirect MCP

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

非公式です。AppDirect API 向けにコミュニティが開発した Claude Code Skill と MCP サーバーです。 AppDirect, Inc. とは提携関係になく、同社による推奨や後援も受けていません。

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

ドキュメントに記載された AppDirect のマーケットプレイス操作をすべて 1 つのバイナリにまとめ、オフライン同期と請求照合の結合機能も備えています。すでにお使いの 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 エージェント	AppDirect スキルのインストール方法
Claude Desktop	インストーラーを実行し、Settings > Extensions で appdirect-mcp を登録します（JSON の編集は不要です）。
ChatGPT（有料プラン）	このコネクターが再発行されるまで利用停止中です。ChatGPT には HTTP モードが必要ですが、このビルドではパスワードを要求せず、すべてのネットワークインターフェースで待ち受け、開いた Web ページからアクセスできます。mcp-install.md のセキュリティに関する注意を参照してください。
Codex CLI	以下のインストール用プロンプトを貼り付けます。
Claude Code	以下のインストール用プロンプトを貼り付けます。
Claude Cowork	以下のインストール用プロンプトを貼り付けます。
GitHub Copilot（VS Code）	インストーラーを実行し、servers キーの下にある mcp.json に appdirect-mcp を追加してから、Agent モードを選択します。

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

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

導入基盤は大きいですが、率直にお伝えします。こちらはリモート／エンタープライズ向けの方法であり、先ほどインストールしたローカルバイナリではありません。

エージェント	必要なもの
Microsoft 365 Copilot / Copilot Studio	このコネクターが再発行されるまで一時停止しています。Copilot Studio では HTTP モードが必要ですが、このビルドの 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 で起動します。すべてのツールは、付属の appdirect-cli を呼び出します。2026-09-18 以降にリリースされたバージョンでは、この CLI がバンドル内に含まれています。それ以前のバンドルに含まれるのは MCP サーバーのみです。付属の CLI がない場合は、先に以下の方法 A または方法 B のインストーラーを実行するか、APPDIRECT_CLI_PATH に既存のバイナリを指定してください。詳細： #331。

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

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

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

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

これを Claude Code、Codex CLI、または Claude Cowork にコピーしてください：

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

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

確認：

appdirect-cli --version

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

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

macOS / Linux：

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

Windows（PowerShell）：

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

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

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

/skills install servosity/msp-skills/skills/appdirect --force

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

OpenClaw にインストールする

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

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

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

認証する

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

APPDIRECT_CLIENT_ID=<value> APPDIRECT_CLIENT_SECRET=<value> APPDIRECT_OAUTH_SCOPE=<value> appdirect-cli doctor

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

このスキルでできること

MSP からよく聞かれる質問	コマンド
すべての企業を対象に、先週失敗または停滞した支払いはどれですか？	appdirect-cli payments unpaid --since 7d --json
月末前に、請求されていない有効な項目、期限超過の項目、または失敗した項目は何ですか？	appdirect-cli reconcile --since 30d --agent
今週のサブスクリプションの変更内容（新規、終了、一時停止）を教えてください。	appdirect-cli subs changed --since 7d --json
ある顧客の全体像（ユーザー、サブスクリプション、請求書、商談）を表示してください。	appdirect-cli company show <companyId>
ステータス別の代理販売パイプラインはどのような状況ですか？	appdirect-cli pipeline --group-by status --agent
どの未完了の商談が停滞していますか？	appdirect-cli pipeline stale --days 14 --json
キーワードで企業、サブスクリプション、請求書、商談を検索します。	appdirect-cli search "<text>"
オフライン分析用に、マーケットプレイス全体をローカルミラーに取り込みます。	appdirect-cli sync

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

このスキルの特徴

ほとんどの AppDirect 連携や MCP サーバーは、質問のたびにライブ API を呼び出し、そのために 1 時間有効な OAuth トークンを再発行します。単一のレコードを扱うなら問題ありません。しかし、「今四半期、請求されていないのに有効なサブスクリプションは、すべてのリセラー企業でいくつありますか？」といった質問をすると、規模が大きくなるにつれて機能しなくなります。

このスキルは AppDirect を全文検索機能付きのローカル SQLite ミラーに同期します。集計に関する質問はローカル SQL の結合を 1 回行うだけで回答でき、処理は即時に完了し、オフラインでも利用できます。AI に渡されるのは生データではなく、回答です。reconcile、subs changed、company show などの複合コマンドは、サブスクリプション、請求書、支払い、企業、商談を横断して結合します。ステートレスな API ラッパーでは実現できない処理です。

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

r/mspでは、再販 SaaS の請求照合が繰り返し話題になります。「請求照合が悪夢のようだ」、毎月の調整、そしてマーケットプレイスでは有効なのに請求書に記載されていないサブスクリプションによる利益の流出です。コンソールでは1画面につき1社しか確認できないため、請求書に記載されていないサブスクリプション、支払い失敗、または停滞している商談を見つけるには、何百もの会社の請求ページを手作業でクリックして回る必要があります。照合が漏れ、月次締めのたびに損失が膨らみます。

このスキルを使えば、こうした確認をそれぞれ1つのコマンドで行えます。

• appdirect-cli reconcile --since 30d --agent - すべての会社を対象に、請求書のない有効なサブスクリプション、支払期限を過ぎた請求書、支払い失敗を確認します。
• appdirect-cli payments unpaid --since 7d --json - 週次の支払い失敗への対応対象を、1つの並べ替え済みリストにまとめます。
• appdirect-cli subs changed --since 7d --json - 解約状況の確認に向けて、新規、終了、一時停止のサブスクリプションを確認します。
• appdirect-cli company show <companyId> - 更新準備に向けて、1社の顧客の全体像を確認します。
• appdirect-cli pipeline stale --days 14 --json - 動きがなくなったオープン中の商談を確認します。

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

よくある質問

ChatGPTで使えますか？

このビルドでは使えません。ChatGPT（Plus、Pro、Team、Business、Enterprise、Educationの各プラン。FreeではまだDeveloper Modeを利用できません）は、HTTPS経由のリモート MCP サーバーにのみ接続します。そのため、AppDirect 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）もあります。どちらの方法でもコードを書く必要はありません。AppDirectの認証情報を一度入力するだけです。

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

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

AppDirectのパートナーである必要はありますか？

はい。このスキルは、運営または再販しているマーケットプレイス向けのパートナー API 認証情報（OAuth2 client_credentials）を使用して認証します。自分で管理していないマーケットプレイスでのエンドユーザー購入向けではありません。独自ドメインでホワイトラベルのマーケットプレイスを運営している場合は、APPDIRECT_BASE_URLを使ってCLIの接続先を指定してください。

AppDirectのAPIレート制限に達しませんか？

レート制限を回避できるように設計されています。マーケットプレイスのREST APIには、リーキーバケット方式のレート制限があります（たとえば、毎秒数件ずつ補充される20リクエスト分のバケット）。このスキルはデータをローカルミラーに同期し、ほとんどの質問にオフラインで回答するため、日常的なクエリでライブAPIを呼び出すことはほとんどありません。syncはレート制限を考慮します。また、--rate-limitでリクエスト速度を制限できます。

AppDirectのポータルに取って代わりますか？

いいえ。ポータルを補完するものです。ポータルは引き続き、会社を1社ずつクリックして確認する場所です。このスキルは、ポータルに確認画面がない会社横断の請求や、月次締め前のパイプラインに関する質問に回答します。

費用はかかりますか？

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

安全モデル

各コマンドの実際の HTTP メソッドに基づいてティアが決まるため、finalize-opportunity や upload-and-link-image のような書き込みコマンドは、読み取りとして見過ごされることなく、書き込みとして制限されます。

ティア	例	推奨されるエージェントポリシー
読み取り	payments unpaid、reconcile、subs changed、company show、pipeline、search、および 160 以上のすべての GET エンドポイント	許可
書き込み（通常）	会社、ユーザー、メンバーシップ、商談の作成／更新、ユーザーの招待、購入のリクエスト、割引の適用、商談の確定（合計 118 件）	--dry-run でプレビューしてから、レビュー済みの書き込みを実行
認証情報／財務	一時パスワードの設定、支払い方法または支払い手段の作成／更新／デフォルト設定（合計 7 件）	必ず人間が関与
破壊的操作	メンバーシップ、グループ、サブスクリプション割り当て、ショッピングカートの削除、サブスクリプションのキャンセル、開発者アカウントの期限切れ（合計 34 件）	必ず人間が関与

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

ステータス

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