ACMP MCP Server

メモ

英語： Aagon ACMPのPublic API向けMCPサーバーです。すべての書き込み／実行／削除アクションのアクティビティログと、それらすべてをブロックする緊急停止機能を備えています（バージョン1の二者承認機能は廃止されました）。ACMPサーバー上で単一のWindows EXEとして動作し、あらゆるMCPクライアントで利用できます。ACMPのユーザー層の大半がDACH地域にあるため、ドキュメントはドイツ語ですが、英語での課題報告も歓迎します。

ACMP Public API向けのMCPサーバーです（Aagon Client Management Platform）。「過去30日間オフラインだったコンピューターは？」のように普通の言葉で質問すると、AIがACMPから直接回答を取得します。

概要

• あらゆるMCPクライアントに対応： Claude、ChatGPT/Codex、GitHub Copilot、Gemini、Cursor …
• 幅広い範囲をカバー： クライアント、コンテナー、ジョブ／Client Commands、チケット、アセット、インベントリ、脆弱性、マスターデータ。
• アクティビティログと緊急停止機能： すべての操作は即時に反映されます。事前にdryRunでプレビューを確認できます。すべての書き込み、実行、削除アクションは、操作担当者、対象、意図、結果とともにログに記録され、Webインターフェースの緊急停止ボタンですべての操作をワンクリックでロックできます。バージョン1の二者承認機能は廃止されました（理由）。
• 操作担当者ごとの設定： 各担当者に専用のAPIキーを割り当て、必要に応じて専用のACMP IDを設定できます。これにより、ACMPは担当者本人の実際の権限を確認します。
• 単一のEXEで、クラウド不要： ACMPサーバー上で直接動作します。IISも.NET SDKも不要です。
• ブラウザーで状況を把握： ホームページには、現在重要な項目（連絡のないコンピューター、空き容量のないディスク、古いスキャン、多数のエラーがあるジョブ）が表示されます。さらに、未対応項目の共有リスト、コンピューターごとのClient Commandのロールアウト状況、Windows Updateのエラー停止機能も利用できます。
• オプション： Client Commandsの作成、承認、分類、パラメーター設定、キオスクの管理、Windows Updateの拒否またはテストリングでの停止、Managed Softwareの登録と配布、コンテナーフィルター、メンテナンスウィンドウ、セキュリティプロファイルの設定、Unix Scriptsの作成、カスタムフィールドの追加、ACMPデータベースでのジョブの切り替えや作成ができます。デフォルトでは無効です。
• すぐに使えるテンプレート： ACMP CTL（Community Template Library）には、各手順が平文で記載されたClient Commandテンプレートがあります。acmp_lib_installを使うと、テンプレートをConsoleにドラフトとして追加できます。

互換性

クイックスタート

A）AIにセットアップしてもらう

ACMPサーバー上でリポジトリをクローンするか、ZIPを展開します。そこで、コマンドを実行できるAIエージェント（Claude Code、Codex CLI、エージェントモードのGitHub Copilot、Gemini CLI、Cursorなど）を起動し、次のように入力します。

Richte diesen ACMP-MCP-Server auf diesem Rechner ein. Folge AGENTS.md Schritt für Schritt,
erkläre mir jeden Admin-Schritt, bevor ich ihn ausführe, und frag mich nie nach Passwörtern
oder API-Keys im Chat.

AGENTS.md には、チェック、インストール、初期設定、LANへの公開、クライアント接続、トラブルシューティングまでの全手順が記載されています。ほとんどのエージェントは自動的にこのファイルを読み込みます。Claude Code（CLAUDE.md）、Gemini CLI（GEMINI.md）、GitHub Copilot（.github/copilot-instructions.md）向けの参照ファイルも用意されています。

B）手動で行う場合：ターミナルでアシスタントを起動

ACMP サーバーで PowerShell を開き、リポジトリに移動して起動します。管理者権限がない場合、Windows の確認ダイアログ（UAC）の後にスクリプトが自動的に再起動します。

.\install.ps1

最後に、アシスタントがAPI キーと Web ログイン情報（概要、アクティビティ、緊急停止、オンボーディングに使う短縮名と Web トークン）を表示し、希望すればキーをクリップボードにコピーします。その後、使用する AI クライアントを尋ね、対応する完成済みの設定を表示します。

cd C:\ProgramData\AcmpMcp
.\add-user.ps1

クライアントの接続

Streamable HTTP と独自のヘッダーに対応している MCP クライアントは、直接接続できます。

たとえば、Claude Code の場合：

claude mcp add --transport http acmp http://<HOST>:8765/ --header "Authorization: Bearer <KEY>" --scope user

Claude Desktop： Releases から acmp-mcp-<version>.mcpb をダブルクリックしてインストールし、拡張機能の設定でサーバーアドレスと API キーを入力します。

一般的なすべてのクライアント向けの完成済み設定は、docs/CLIENTS.md にあります。ローカル（stdio）サーバーにしか対応していないクライアントは、mcp-remote ブリッジ経由で接続できます。

仕組み

flowchart TB
    KI["KI-Client<br/>Claude · Codex · Copilot · Gemini · Cursor"]
    subgraph SRV["ACMP-Server"]
        MCP["ACMP-MCP-Server<br/>(Windows-EXE)"]
        LOG[("Aktivitätsprotokoll<br/>+ Notbremse")]
        ACMP[("ACMP<br/>Public API über SICS/AESB")]
        DB[("ACMP-Datenbank")]
    end
    TEAM(["IT im Browser<br/>Weboberfläche"])
    KI -->|"MCP · HTTP + API-Key"| MCP
    MCP -->|"lesen · schreiben · ausführen"| ACMP
    MCP -->|"jede Schreibaktion"| LOG
    TEAM -->|"Aktivität ansehen · Notbremse ziehen"| LOG
    MCP -.->|"optional: DB-Reports, Writer"| DB

バージョン2：二者承認なし

バージョン1までは、書き込み、実行、削除のコマンドは承認ページに申請として登録され、承認後にのみ実行されていました。実運用では、セキュリティ上の理由で申請が却下されたことは一度もなく、クリック操作が手間になっているだけでした。バージョン2以降、これらのツールは即座に実行されます。その代わりに、次の仕組みを用意しています。

• プレビュー： ほとんどの書き込みツールはdryRun: trueに対応しています。サーバーからの指示により、AIはまずプレビューを表示し、チャットで人の承認を待ちます。PowerShellと削除の場合は、必ずこの手順を行います。
• アクティビティログ： 誰が、いつ、何を、どの対象に対して行ったかを、意図と結果とともに記録します。パスワードはマスクされます。
• 緊急停止： Webインターフェース上のスイッチで、すべてのオペレーターに対するすべての書き込みツールを即座にブロックします。読み取りとdryRunは引き続き実行できます。

利用例：

1. 「PC-0815のディスクがいっぱいです。WindowsのTempフォルダーを整理してください」と入力します。
2. AIがコンピューターを検索し（acmp_get_client_id）、ドライブを確認して（acmp_low_disk_space）、PowerShellスクリプトを表示します。
3. 承認すると、AIがスクリプトを実行します（acmp_run_powershell）。呼び出しはただちにアクティビティログに記録されます。
4. AIが結果を報告します。

バージョン1からの更新： git pullと.\install.ps1を実行します。アシスタントが設定を切り替えます（approval → web、バックアップあり）。これまでの承認トークンは、その後Webログインとして使われます。ただし、承認メールのリンクに記載されていたトークンなので、更新後に.\renew-web-tokens.ps1を実行して新しいトークンに切り替えてください（インストールフォルダーで管理者として実行）。再インストールしなくても、サーバーは以前のapprovalセクションを引き続き読み込みます（publicUrl、requester、approversのみ）。未処理の承認申請は実行されなくなります。

重要

承認なしでは、安全性はオペレーターと、APIキーを誰に渡すかにかかっています。各キーをドメイン管理者のパスワードと同じように扱い、チケット、ファイル、Webページの指示をAIに実行させないでください。迷った場合は緊急停止を有効にしてください。

ツール

12の分野にわたる179個のツールがあります。分野をクリックすると、各ツールとその動作が表示されます。

🟢 読み取り · 🟡 書き込み（即時実行され、ログに記録） · 🔴 実行または削除（重要）。🟡と🔴は緊急停止によってブロックされます。 どのツールが変更を行うかは、/settings でも確認できます。一部のツールにはオプション機能が必要です：(DB) データベース接続（db.connectionString、読み取り専用）、(PS) クライアントコマンドテンプレート（runPowershell.clientCommandId）、(CW) CC Writer（ccWriter）、(KW) キオスクライター（kioskWriter）、(WW) WUM Writer（wumWriter）、(UW) Unix スクリプトライター（unixWriter）、(FW) フィールドライター（cfWriter）、(JW) ジョブライター（jobWriter）。現在の一覧は tools/list で取得できます。各ツールは任意で format: "json" を受け付けます。

Writer が変更できるのは、許可されたフォルダーにある自分のドラフトのみで、許可されたオペレーターに限られます。既存の Commands を変更する場合は、acmp_cc_new_version のみを使用します。新しいバージョンとして扱い、Aagon の標準フォルダーでは変更せず、手順 ID と保存済みパスワードは保持されます。他者が作成したドラフトを上書きするのは、明示的に要求された場合のみです（バックアップを作成）。プレビュー（dryRun）には、各手順とそのフィールドが表示されます。

書き込みの前に、サーバーは ACMP のバージョン、テーブル、トリガー、および書き込み用ログインの権限を確認します。また、最新の Commands 50 件を試験的に展開し、再パッケージ化します。ACMP のアップデート後などに差異がある場合は、何も書き込みません。リリースできるのは、自分が作成したドラフトと、最後に MCP が保存したバージョンです。ファイルが変更された後続バージョンはリリースされず、コンソールで処理する必要があります。「HIER … EINTRAGEN」のようなプレースホルダーがある場合、リリースはできません。ACMP 6.10 でテスト済みです。

プロンプトの例は docs/USAGE.md にあります。新しいネイティブコマンドは api-tools.json に宣言的に追加し、新しい SQL レポートは db-tools.json に追加します。どちらも再コンパイルは不要です。

Webインターフェース

ログイン（/login）は短縮名と操作者ごとの専用 Web トークンで行い、その後はセッション Cookie（HttpOnly、SameSite=Strict、12 時間）を使用します。Web トークンは ACMP キーや MCP キーとは独立しています。API キーが漏えいしても、緊急停止は解除できません。バージョン 1 の古いリンク（?approver=…&token=…）ではログインできなくなりました。アドレス内のトークンは、メール、閲覧履歴、プロキシログに残るためです。renew-web-tokens.ps1 で Web トークンを更新できます。

設定

config.example.json にはコメント（_hinweis フィールド）があります。install.ps1 は、そこから config.local.json を生成します。

警告

このサーバーは、すべてのエンドポイントでのコマンド実行に至るまで、完全な ACMP アクセス権を付与します。すべての API キーを管理者パスワードと同じように扱ってください。

• TLS は組み込まれていません。 サーバーはデフォルトで 127.0.0.1 のみで待ち受け、API キーなしでの LAN 運用を拒否します。LAN では、ファイアウォールで接続元サブネットを制限してください。ネットワーク境界を越える場合は、TLS プロキシまたは VPN を前段に配置してください。
• install.ps1 は、認証情報が保存されているインストールフォルダーへのアクセスを管理者と SYSTEM に制限します。
• 緊急停止機能とログはインストールフォルダーにあります（notbremse.json、activity-*.jsonl）。このフォルダーに書き込めるユーザーは、どちらも回避できるため、アクセスは管理者と SYSTEM のみにしてください。ACMP／MCP サーバー自体では、MCP はジョブを実行しません（acmp_run_powershell、acmp_enqueue_client_command、acmp_read_registry、acmp_call）。SYSTEM として実行されるスクリプトは、そこにあるすべてのキーを含む config.local.json を読み取れる可能性があるためです。SQL サーバーなど、その他のコンピューターは runPowershell.protectedClients で保護してください。
• オペレーターのパスワードは保存しません。acmp-token-setup.exe が保存するのは、DPAPI で暗号化されたトークン（LocalMachine）のみです。
• /regresult（acmp_read_registry の戻りチャネル）は、クライアントがキーを知らないため、意図的にキーなしでアクセスできます。受け付けるのは、未完了で推測できないトークンに対する結果のみです。
• セキュリティ上の脆弱性は、公開 Issue として報告せず、SECURITY.md の説明に従ってください。

コントリビュート

Issue とプルリクエストを歓迎します。Issue にはホスト名、IP アドレス、ユーザー名、キー、トークンを含むログを投稿しないでください。事前に伏せ字にしてください。

ライセンス

MIT。Aagon GmbH の公式製品ではありません。ACMP と AESB は Aagon GmbH の商標です。