Automox MCP Server

Automox MCP サーバー

Automox 公式の MCP サーバーです。自然な言葉で Automox コンソールを操作できます。この MCP サーバーは、Claude などの AI アシスタントを Automox 環境に接続し、デバイスの管理、コンプライアンスの確認、ポリシーの実行などを、質問するだけで行えるようにします。

You:   "Are we ready for Patch Tuesday?"
Claude: Here's your readiness summary — 3 devices need patches,
        2 approvals are pending, and your patch policies run tonight at 2 AM...

重要

バグ報告や機能リクエストには、help.automox.com または通常のエスカレーション経路をご利用ください。

注意

AI アシスタントは誤りを犯す場合があります。MCP サーバーが生成する応答は、不正確または不完全な場合があります。このような状況が継続して発生する場合は、お知らせください。

目次

• 3.0 の新機能
• セルフホスト版とホスト版の比較
• クイックスタート
• どんなことを質問できますか？
• 設定
• セキュリティ
• プライバシーポリシー
• 別のインストール方法
• 更新
• ホスト版サーバーへの移行
• トラブルシューティング
• よくある質問
• 開発
• バージョン管理
• ライセンス
• サポート

3.0 の新機能

Automox MCP Server 3.0 では、従来のセルフホスト型ソリューションに代わる、中央ホスト型のオプションが追加されました。ホスト版サーバーは、現在ご利用中のすべての機能に加え、新しい機能を 1 つサポートしています。

• ホスト版サーバー： Automox が同じサーバーのバージョンを運用・保守するようになりました。インストールは不要です。既存の API キーを使って、AI クライアントを https://console.automox.com/api/mcp に接続してください。詳しくは、以下のセルフホスト版とホスト版の比較をご覧ください。
• ポリシーカタログのテンプレート（ホスト版のみ）： ホスト版サービスでは、Automox のベストプラクティスに基づくポリシーテンプレートのライブラリを検索し、テンプレートから直接ポリシーを作成できます。これにより、ポリシーを一から作らずに、出発点となるものを利用できます。これは、組織にすでに適用されているポリシーについて質問する機能とは別のもので、Automox が推奨するテンプレートライブラリです。
• 機能の損失なし： ホスト版サービスでは、このリポジトリを通じて現在利用できるものと同じ範囲のツールを利用できます。
• 移行の強制なし： このセルフホスト型サーバーと Claude Desktop 拡張機能は、これまでどおり動作します。現在、ホスト版サービスへの移行は任意ですが、推奨されています。詳しくはホスト版サーバーへの移行をご覧ください。
• 認証は当面変更なし： どちらのバージョンも同じ Automox API キーを使用します。SSO は今後のリリースで対応予定です。

セルフホストとホスト型の比較

どちらも同じオープンソースのサーバーコードを実行します。違いは、誰がインストールして実行するか、そして現時点でホスト型のみが備える機能があるかどうかです。

	セルフホスト（このリポジトリ）	ホスト型（MCP Server 3.0）
インストール	ご自身でインストールし、最新の状態に保ちます（PyPI、uvx、Claude Desktop 拡張機能、または Claude のコネクターディレクトリ経由）	インストールは不要です。Automox が実行します
実行場所	ご自身のマシン	Automox のマルチテナントサービス
認証	Automox API キー	Automox API キー（現時点では同じ方式）
Claude Desktop	ワンクリック拡張機能を使って現在利用できます。GitHub Releases または Claude のコネクターディレクトリからインストールできます	まだ利用できません。Claude Desktop に組み込まれたカスタムコネクターには OAuth が必要ですが、ホスト型サービスはまだ対応していません
その他のクライアント（Claude Code、Cursor、MCP Inspector など）	ローカル設定で利用できます	Bearer トークンヘッダーを使って HTTP 経由で現在利用できます
おすすめの用途	ご自身のインフラストラクチャを運用したい場合、または現在 Claude Desktop をお使いの場合	メンテナンスをゼロにしたい場合や、カスタム HTTP ヘッダーに対応するクライアントをお使いの場合

セルフホストのセットアップについては、以下のクイックスタートをご覧ください。ホスト型サーバーについてはホスト型サーバーへの移行をご覧ください。以前にインストールしたことがない場合に、新たに接続する方法も説明しています。

クイックスタート

1. Automox の認証情報を取得する

Automox Consoleから、次の3つの値を取得する必要があります。

値	確認場所
API Key	組織スコープのキーを使用してください。ゾーンの Settings > Secrets & Keys > Add API Key (ドキュメント)から取得できます。キーの種類については以下をご覧ください
Account UUID	Settings > Secrets & Keys（ページに表示されています）
Org ID	組織を表示したときの URL に含まれる数値 ID

Automox には 2種類の API キーがあり、ここではその違いが重要です。

	組織スコープのキー（推奨）	グローバル／アカウントキー
スコープ	1つの組織。キーが作成されたゾーンが対象です	アカウント内のすべての組織。各組織でキー所有者のロールを継承します
作成場所	ゾーンの Settings > Secrets & Keys	アカウントの Global Access Management > Keys（Full Administrator）
ツールの対応状況	すべてのツール（検証済み：検索関連ツールですぐに動作します）	Advanced Device Search 関連ツールでは不安定です — advanced_device_search、device_search_typeahead、保存済み検索の作成／読み取り／更新／削除、list_searches_for_device、get_device_assignments。フル管理者でもほとんどの組織で 403 が返されることを確認していますが、動作する組織もあります。上流の認可動作には一貫性がなく、その仕組みは確認されていません

症状： ほかのすべての場所で読み取りができるのに、検索ツールで 403 が発生する場合は、通常、権限ではなくキーに原因があります。対象の組織用に組織スコープのキーに切り替えてください。API Key と Account UUID は常に必須です。Org ID は推奨ですが任意です。組織コンテキストを必要としない一部のツールは、Org ID がなくても動作します。

2. .env ファイルを作成する

AUTOMOX_API_KEY=your-api-key
AUTOMOX_ACCOUNT_UUID=your-account-uuid
AUTOMOX_ORG_ID=your-org-id

3. AI アシスタントに接続する

Claude Desktop（推奨）— ワンクリックで MCPB をインストール：

新機能： Automox MCP が Claude のコネクターディレクトリにも直接掲載されました。Claude Desktop を開き、設定 > コネクターに移動して「Automox」を検索すると、アプリを離れずに接続できます。以下の手動手順も引き続き使用できます。手順に変更はありません。

1. GitHub Releases ページから最新の automox-mcp-<version>.mcpb をダウンロードします。
2. Claude Desktop を開き、設定 → 拡張機能に移動します。
3. .mcpb ファイルを拡張機能のウィンドウにドラッグします。
4. プロンプトに API キー、アカウント UUID、（任意で）組織 ID を貼り付けます。

.env ファイルもターミナルも不要です。認証情報は Claude Desktop のセキュアな設定に保存されます。バンドルは初回起動時に、対応する automox-mcp リリースを PyPI から取得します。

Claude Code（CLI）：

claude mcp add automox-mcp uvx -- --env-file /path/to/.env automox-mcp

Cursor／その他の MCP クライアント — MCP 設定に追加します：

{
  "mcpServers": {
    "automox-mcp": {
      "command": "uvx",
      "args": ["--env-file", "/path/to/.env", "automox-mcp"]
    }
  }
}

これで完了です。質問を始めましょう。

何を質問できますか？

このサーバーは、デバイス、ポリシー、パッチ、グループ、Webhook、Worklet、脆弱性の同期、メンテナンスウィンドウなど、130 種類以上のツールを提供します。ツール名を知っている必要はありません。実行したいことを説明するだけです。

質問例	実行される内容
「パッチチューズデーへの準備はできていますか？」	保留中のパッチ、承認状況、ポリシーのスケジュールを確認します
「コンプライアンス状況はどうなっていますか？」	コンプライアンス率、非準拠デバイス、正常性の内訳を返します
「Caldera サーバーの詳細なプロファイルを教えてください」	デバイスの詳細、インベントリ、パッケージ、ポリシーのステータスをまとめます
「対応が必要なデバイスはありますか？」	直ちに対応が必要と判定されたデバイスを表示します
「『Testing box』を再起動して」	デバイスを検索し、再起動コマンドを実行します
「『MCP testing』グループを対象に Firefox のパッチポリシーを作成して」	適切なデフォルト設定でポリシーを作成します
「先週、Mark Hansen は Automox で何をしましたか？」	指定した期間の監査証跡を検索します
「30 日間確認されていないすべての Windows デバイスを探して」	構造化クエリを使った高度なデバイス検索を行います
「脆弱性の修復状況を表示して」	問題、解決策、進捗を含むアクションセットを一覧表示します
「USB セキュリティに関する Worklet カタログを検索して」	評価／修復コードを含むコミュニティ Worklet を検索します

ツール、パラメーター、MCP リソースの全一覧については、**ツールリファレンス**をご覧ください。

ヒント： サーバー自体に質問することもできます。discover_capabilities ツールは、ドメインごとに整理された利用可能なツールをすべて返します。

設定

環境変数

セルフホストの 2.x サーバーにのみ適用されます。ホスト型の 3.0 以降のサーバーには適用されません。

変数	必須	デフォルト	説明
AUTOMOX_API_KEY	はい	—	Automox API キー（組織スコープのキーを推奨します。キーの種類を参照してください）
AUTOMOX_ACCOUNT_UUID	はい	—	Secrets & Keys にあるアカウント UUID
AUTOMOX_ORG_ID	推奨	—	数値の組織 ID（ほとんどのツールで必要です）
AUTOMOX_MCP_READ_ONLY	いいえ	false	すべての書き込み操作を無効にします（133 個中 85 個のツールが引き続き使用できます）
AUTOMOX_MCP_ALLOW_APPLY_REMEDIATION_ACTIONS	いいえ	false	エンドポイント上のワークレットにパッチを適用して実行する apply_remediation_actions ツールをオプトインで有効にします。書き込みモードでもデフォルトでは無効です。
AUTOMOX_MCP_ALLOW_SPLASHTOP_BULK_INSTALL_UNINSTALL	いいえ	false	1 回の呼び出しでサーバーグループ全体に Splashtop クライアントをインストールまたはアンインストールする splashtop_bulk_install_uninstall ツールをオプトインで有効にします。書き込みモードでもデフォルトでは無効です。
AUTOMOX_MCP_ALLOW_DELETE_DEVICE	いいえ	false	デバイスのレコードと履歴を完全に削除する delete_device ツール（DELETE /servers/{id}）をオプトインで有効にします。取り消しできず、MCP を通じて復元することもできません。書き込みモードでもデフォルトでは無効です。
AUTOMOX_MCP_ALLOW_UPLOAD_POLICY_FILE	いいえ	false	Required Software ポリシーにローカルのインストーラーファイルをアップロードする upload_policy_file ツールをオプトインで有効にします。ローカルファイルシステムから読み取るため、AUTOMOX_MCP_UPLOAD_ALLOWED_DIRS も必要です。また、stdio（ローカル）トランスポートでのみ動作します。書き込みモードでもデフォルトでは無効です。
AUTOMOX_MCP_UPLOAD_ALLOWED_DIRS	いいえ	—	upload_policy_file がインストーラーを読み取れる絶対パスのディレクトリをカンマ区切りで指定します。このツールを登録するには必須です。パスは正規化され、許可されたディレクトリ内に解決される必要があります。
AUTOMOX_MCP_UPLOAD_MAX_BYTES	いいえ	10737418240	upload_policy_file のインストーラーの最大サイズ（デフォルトは 10 GB、Automox の上限）
AUTOMOX_MCP_UPLOAD_TIMEOUT_SECONDS	いいえ	3600	upload_policy_file のアップロード読み書きタイムアウト（大きなインストーラーにはデフォルトのリクエストタイムアウトより長い時間が必要です）
AUTOMOX_MCP_MODULES	いいえ	すべて	読み込むモジュールをカンマ区切りで指定します（下記を参照）
AUTOMOX_MCP_TOKEN_BUDGET	いいえ	4000	切り捨て前の応答あたりの推定トークン最大数
AUTOMOX_MCP_SANITIZE_RESPONSES	いいえ	true	プロンプトインジェクションを軽減するため、API データをサニタイズします
AUTOMOX_MCP_TOOL_PREFIX	いいえ	—	サーバー間の名前の衝突を防ぐため、すべてのツール名にプレフィックスを付けます（例：automox）
AUTOMOX_MCP_LOG_FORMAT	いいえ	text	ログ形式：text または json（SIEM 統合用の構造化 JSON）
AUTOMOX_MCP_TRANSPORT	いいえ	stdio	トランスポート：stdio、http、sse、または streamable-http
AUTOMOX_MCP_HOST	いいえ	127.0.0.1	HTTP/SSE のバインドアドレス
AUTOMOX_MCP_PORT	いいえ	8000	HTTP/SSE のバインドポート
AUTOMOX_MCP_API_KEYS	いいえ	—	HTTP/SSE の Bearer トークン認証に使用する MCP エンドポイント API キーをカンマ区切りで指定します（例：key1,label:key2）
AUTOMOX_MCP_API_KEY_FILE	いいえ	—	MCP エンドポイント API キーを含むファイルのパス（1 行につき 1 つ）
AUTOMOX_MCP_OAUTH_ISSUER	いいえ	—	JWT 認証用の OIDC 発行者 URL（例：https://auth.example.com/realms/main）
AUTOMOX_MCP_OAUTH_JWKS_URI	いいえ	—	JWT キーのローテーション用 JWKS エンドポイント（省略時は発行者から自動導出されます）
AUTOMOX_MCP_OAUTH_AUDIENCE	JWT 認証時	—	期待される JWT の audience クレーム（トークンのパススルーを防止します）。AUTOMOX_MCP_OAUTH_ISSUER が設定されている場合は必須です
AUTOMOX_MCP_OAUTH_SERVER_URL	いいえ	—	RFC 9728 Protected Resource Metadata を有効にする正規サーバー URL
AUTOMOX_MCP_OAUTH_SCOPES	いいえ	—	必須の OAuth スコープをカンマ区切りで指定します
AUTOMOX_MCP_ALLOWED_ORIGINS	いいえ	—	DNS リバインディング保護用に許可する追加の Origin ヘッダー（カンマ区切り）
AUTOMOX_MCP_ALLOWED_HOSTS	いいえ	—	DNS リバインディング保護用に許可する追加の Host ヘッダー（カンマ区切り）
AUTOMOX_MCP_DNS_REBINDING_PROTECTION	いいえ	true	DNS リバインディング保護を無効にするには false を設定します（非推奨）
AUTOMOX_MCP_ALLOW_REMOTE_BIND	いいえ	false	ループバック以外のアドレスへのバインドを許可します（0.0.0.0 または外部 IP の場合に必要です）

読み取り専用モード

AUTOMOX_MCP_READ_ONLY=true

すべての書き込み操作を無効にします。読み取り専用ツールのみが登録されます（133 個中 85 個）。監査や監視に役立ちます。

モジュールの選択的読み込み

必要なツールモジュールのみを読み込みます。

AUTOMOX_MCP_MODULES=devices,policies

利用可能なモジュール：audit、audit_v2、devices、device_search、policies、policy_history、users、groups、events、reports、packages、webhooks、worklets、data_extracts、vuln_sync、compound、policy_windows

両方の設定を組み合わせることができます。

AUTOMOX_MCP_READ_ONLY=true
AUTOMOX_MCP_MODULES=devices,policies

HTTP トランスポート

stdio 以外でデプロイする場合：

uvx --env-file .env automox-mcp --transport http --host 127.0.0.1 --port 8000

エンドポイント認証

HTTP または SSE 経由でデプロイする場合、MCP エンドポイントに認証を必須にできます（Automox API キーとは別です）。次の 2 つの方式に対応しています。

静的 API キー（シンプル）：

automox-mcp --generate-key                         # generate a key
export AUTOMOX_MCP_API_KEYS="amx_mcp_a1b2c3..."    # or use a key file

OAuth 2.1 / JWT（エンタープライズ IdP との統合）：

export AUTOMOX_MCP_OAUTH_ISSUER="https://auth.example.com/realms/main"
export AUTOMOX_MCP_OAUTH_AUDIENCE="https://mcp.example.com"
export AUTOMOX_MCP_OAUTH_SERVER_URL="https://mcp.example.com"  # enables RFC 9728 metadata

クライアントはすべてのリクエストに Authorization: Bearer <token> を含める必要があります。認証されていないリクエストには、適切な WWW-Authenticate ヘッダーを付けて 401 Unauthorized を返します。stdio トランスポートには影響しません。

セキュリティ

Automox MCP サーバーは、多層防御のセキュリティ制御を備え、エンタープライズ環境へのデプロイを想定して設計されています。

主な特長：

• 読み取り専用モード（AUTOMOX_MCP_READ_ONLY）ですべての 48 個の書き込みツールを無効化

• モジュールのフィルタリング（AUTOMOX_MCP_MODULES）により、最小権限に基づいてツールを読み込み

• すべてのツール呼び出しに相関 IDを付与し、X-Correlation-ID として Automox API に転送

• トークン使用量の推定と自動切り詰め機能を備えたレート制限（30 回／60 秒）

• API キーの分離 — プライベート属性として保存し、リクエストごとに認証情報を注入（ヘッダーには保存しません）

• 汎用エラーレスポンス — エラー出力に内部パス、接続文字列、API キーを含めません

• プロンプトインジェクションの緩和 — Unicode の正規化、ホモグリフ対策、HTML タグ／スクリプトの除去、参照形式の Markdown の除去による API レスポンスのサニタイズ

• Webhook シークレットの処理 — 作成後、べき等性キャッシュからシークレットを除去

• SIEM との統合に対応した構造化 JSON ログ（AUTOMOX_MCP_LOG_FORMAT=json）

• サーバー間の名前の衝突を防ぐツール名のプレフィックス付与（AUTOMOX_MCP_TOOL_PREFIX）

• CycloneDX SBOM 付きのSigstore 署名済みリリース

• SSRF 対策 — Webhook URL がプライベート／ループバック IP およびクラウドメタデータエンドポイントを参照しないよう検証

• MCP エンドポイント認証 — 静的 API キーまたは OAuth 2.1/JWT に対応し、オーディエンスバインディングおよび RFC 9728 Protected Resource Metadata を使用

• DNS リバインディング対策 — MCP トランスポート仕様に従い、すべての HTTP/SSE 接続で Origin ヘッダーと Host ヘッダーを検証

• セキュリティレスポンスヘッダー — すべての HTTP レスポンスに X-Content-Type-Options、X-Frame-Options、CSP、Cache-Control: no-store、Strict-Transport-Security を設定

• 認証のレート制限 — 認証の失敗が繰り返された IP をブロックし、ブルートフォース攻撃を緩和

• リモートバインド保護 — ループバック以外の HTTP/SSE バインドには、明示的な --allow-remote-bind オプトインが必要

• 130 個を超えるすべてのツールにMCP ツールアノテーション — MCP Protocol 仕様に基づく readOnlyHint、destructiveHint、idempotentHint、openWorldHint を設定し、クライアント側の確認ダイアログと安全対策を実現

• インタラクティブな MCP Apps（io.modelcontextprotocol/ui）— コンプライアンスのトリアージ、パッチの承認、ポリシーの影響範囲、修復の適用、RBAC アクセス認証など、重要なフロー向けのインライン審査／承認画面を提供します。Apps 対応ホストではインラインで表示され、それ以外のホストでは構造化されたツール出力に適切にフォールバックします。書き込みフローの Apps は、ホストの確認を通じて既存のゲート付きツールを実行します。新しいツールやゲートは追加せず、ホストのすべてを拒否する CSP のもとで動作します（自己完結型で、外部や CDN からの読み込みはありません）

• 61 件のセキュリティ強化項目（V-001 から V-182、S-001 から S-006）を CHANGELOG および SECURITY.md に記載 機能モデル。 このサーバーは、公開されている Automox Console API と Webhooks API の 100％をラップします。ただし、意図的に設けた例外が1つあります。シークレットを公開するエンドポイントは一切ラップしません（API キーの復号、パスワードの設定）。破壊的な操作はすべて、事前確認（ホストによる確認）を求めるか、デフォルトで無効になっている環境変数フラグで制御します。具体的には、次の3つの基本ルールがあります。

• シークレットは一切扱いません — サーバーがシークレットの内容を返したり、モデルに設定させたりすることはありません。認証情報の入力は環境変数または設定経由に限られます。復号エンドポイントはラップせず、パスワードの設定は除外し、すべての射影でシークレットフィールドをマスキングします。これが唯一の意図的な除外項目です。

• 破壊的な操作は2段階で制御します。 単一の対象に対する復元可能な操作は、事前確認を求めます（destructiveHint: true。ホストの確認ダイアログに表示され、読み取り専用モードでは完全に無効になります）。1回ごとの確認では保護できない操作（フリート全体への操作、自己ロックアウト、任意のモデル作成コードの実行）は、明示的に設定するデフォルトで無効の環境変数フラグ（AUTOMOX_MCP_ALLOW_APPLY_REMEDIATION_ACTIONS、AUTOMOX_MCP_ALLOW_SPLASHTOP_BULK_INSTALL_UNINSTALL、AUTOMOX_MCP_ALLOW_DELETE_DEVICE）で制御します。デバイスの削除は制御対象であり、除外されているわけではありません。

網羅性の一覧、制御の原則、意図的な除外項目の詳細は、API カバレッジと意図的な除外に記載されています。

脆弱性の報告と完全な脅威モデルについては、SECURITY.mdを参照してください。 デプロイのセキュリティ強化（コンテナー、Kubernetes、MCP ゲートウェイ、TLS、認証）については、デプロイセキュリティガイドを参照してください。 セキュリティ対策の水準は、Wiz MCP セキュリティベストプラクティスのチートシートを基準に評価しています。

注：ネットワークからアクセス可能な環境にデプロイする場合は、エンドポイント認証（AUTOMOX_MCP_API_KEYSによる静的キー、またはAUTOMOX_MCP_OAUTH_ISSUERによる JWT）を有効にするか、サーバーを MCP ゲートウェイまたは認証機能を備えたリバースプロキシの背後に配置してください。TLS の終端処理はデプロイ担当者の責任です。

プライバシーポリシー

Automox MCP サーバーは、お使いの AI アシスタントと Automox API の間でステートレスなプロキシとして動作します。

データの収集： サーバーは、Automox プラットフォームへの API リクエストを実行するために必要な情報を除き、ユーザーデータを収集、保存、送信しません。API 認証情報は起動時に環境変数から読み込まれ、Automox API へのリクエストの認証にのみ使用されます。

データの使用： Automox API から取得したデータはすべて、リクエストを開始した AI アシスタントに直接返されます。サーバーは、プロンプトインジェクション対策としてレスポンスをサニタイズ（Unicode の正規化、HTML の除去）しますが、API データを分析、集計したり、ほかの目的に転用したりすることはありません。

第三者との共有： サーバーは第三者とデータを共有しません。お客様が提供する認証情報を使用して、Automox API（console.automox.com）とのみ通信します。テレメトリ、分析データ、使用状況データが、サーバーの作者やその他のサービスに送信されることはありません。

データの保持： サーバーはセッション間で永続的なデータを保持しません。メモリー内キャッシュ（冪等性キー、レート制限カウンター）は、プロセスの終了時に消去されます。有効にした場合、構造化ログは標準エラー出力に書き込まれ、その管理と保管はデプロイ担当者の責任です。

完全なプライバシーポリシーについては、Automox MCP サーバーのプライバシーポリシーを参照してください（PRIVACY.mdにも同じ内容が記載されています）。

別のインストール方法

上記のクイックスタートでは、インストール不要のuvxを使用します。継続的に使用するためインストールする場合は、次のようにします。

# Using uv
uv tool install automox-mcp

# Using pip
pip install automox-mcp

次に、シェルで環境変数を設定し、automox-mcpを実行します。

更新

すでにサーバーをインストールしている場合は、最新バージョンに更新します。

# uvx (Quick Start method) — force a cache refresh
uvx --refresh automox-mcp

# uv tool install
uv tool upgrade automox-mcp

# pip
pip install --upgrade automox-mcp

Note: uvx はおよそ 7 日ごとにキャッシュを自動更新するため、ほとんどのユーザーは特に操作しなくても新しいリリースを利用できます。すぐに最新の状態にするには、uvx --refresh を実行します。

ホステッドサーバーへの移行

Automox MCP Server 3.0（ホステッド）は、このリポジトリと同じツールを実行しますが、ローカルインストールの管理が不要です。移行は 2 つの手順で完了します。ローカルサーバーを削除してから、ホステッドサーバーに接続します。インプレースアップグレードはなく、変換するものも、移動する設定ファイルも、移行するデータもありません。これまで Automox MCP サーバーを実行したことがない場合は、手順 2 に進んでください。インストールするパッケージはありません。

手順 1：ローカルサーバーを削除する

Claude Code：

claude mcp remove automox

Cursor やその他の設定ファイルベースのクライアント：MCP 設定ファイルから automox-mcp エントリを削除します。

Claude Desktop／MCPB 拡張機能：Claude Desktop を開き、Settings → Extensions に移動します。Automox を見つけ、オフにする（後で再びオンにできます）か、Uninstall を選択して完全に削除します。その後、Claude Desktop を再起動すると、古いツールが表示されなくなります。削除する前に、ホステッドサービスはまだ Claude Desktop から利用できないことにご注意ください。Claude Desktop のカスタムコネクタには OAuth が必要ですが、ホステッドサービスはまだ OAuth に対応していません。Automox を Claude Desktop で使用している場合は、ホステッドサーバーに接続できるクライアント（Claude Code や Cursor など）に移行するまで、拡張機能をインストールしたままにしてください。

手順 2：ホステッドサーバーに接続する

Claude Code：

claude mcp add --transport http automox \
  https://console.automox.com/api/mcp \
  --header "Authorization: Bearer YOUR_AUTOMOX_API_KEY"

新しいセッションを開き、「組織のコンプライアンス状況はどうなっていますか？」などと尋ねます。

MCP Inspector（評価またはデバッグ用）：

npx @modelcontextprotocol/inspector

UI で、Transport Type = Streamable HTTP、URL = https://console.automox.com/api/mcp、Authentication → Bearer Token = API キー（キーをそのまま貼り付け）に設定します。Connect をクリックし、Tools → List Tools を選択します。

その他の MCP クライアント（Cursor など）、カスタムヘッダーを使用したストリーミング HTTP に対応するクライアント：

URL:      https://console.automox.com/api/mcp
Header:   Authorization: Bearer YOUR_AUTOMOX_API_KEY

Automox での権限は、コンソールや API での権限とまったく同じように適用されます。MCP はユーザー本人として動作します。移行期間中もセルフホスト型インストールは引き続き動作するため、急いで切り替える必要はありません。

トラブルシューティング

症状	原因／対処方法
Claude Desktop の「custom connector」画面でホステッドサーバーの追加に失敗する	Claude Desktop に組み込まれているカスタムコネクタは、OAuth によるサインインにしか対応していません。ホステッドサービスはまだ OAuth に対応しておらず、API キーのみを受け付けるため、ホステッド URL を入力すると失敗します。これは Automox MCP デスクトップ拡張機能とは別のものです。代わりに拡張機能をインストールしてください（ワンクリックで .mcpb をインストールでき、Claude の Connectors Directory からも入手できます）。この拡張機能はお使いのマシン上でサーバーをローカルに実行し、すでにお持ちの同じ API キーで接続するため、カスタムコネクタ画面ではなく拡張機能を通じて、Claude Desktop で引き続きすべての機能を利用できます。
401 Unauthorized	Authorization: Bearer ヘッダーがないか、キーが正しくありません。キーを Bearer <key> の形式でそのまま送信してください。
「OAuth Authentication Failed」または無効な JSON に関するエラー	401 の後、クライアントが OAuth の検出にフォールバックしています。カスタムヘッダー名を試すのではなく、Bearer ヘッダーを修正してください。
一部のツールで 403 Forbidden が発生する	キーのスコープを確認してください。組織スコープのキーを使用してください。一部のユーザー管理機能には管理者スコープが必要です。
回答が不正確に見える	AI アシスタントは間違えることがあります。重要な結果は、実行に移す前に Automox Console で確認してください。

よくある質問

セルフホスト型の 2.x サーバーは使えなくなりますか？ いいえ。既存のセルフホスト型インストールは引き続き動作し、インストール方法や入手方法にも変更はありません。ホステッドサービスは、ご希望のタイミングで利用できる新しい選択肢にすぎず、切り替えは必須ではありません。

ホステッドサービスに移行すると、利用できる機能が減りますか？ いいえ。ホステッドサービスでは、現在利用できるものと同じツールを実行できます。

SSO に切り替える必要がありますか？ まだ必要ありません。ホステッドサービスでは、現在と同じ API キー方式を使用します。SSO とユーザーごとの認証は今後のリリースで予定されており、導入時には明確な移行ガイドを提供します。

Claude Desktop を使用しています。どうすればよいですか？ 今のところ、Automox MCP デスクトップ拡張機能を引き続きご利用ください。Claude Desktop のネイティブコネクターオプションには OAuth が必要ですが、ホステッドサービスはまだ対応していません。

サポートが必要ですか？help.automox.com からお問い合わせください。

開発

git clone https://github.com/AutomoxCommunity/automox-mcp.git
cd automox-mcp
uv python install
uv sync --python 3.13 --dev

テスト

MCP Inspector を使った対話型デバッグ：

fastmcp dev

ユニットテストを実行します：

uv run --python 3.13 --dev pytest

本番環境のスモークテストを実行します（Automox の認証情報が必要です）：

uv run python tests/smoke_production.py

MCP Scanner

Cisco の MCP Scanner を使った静的解析：

mcp-scanner \
  --analyzers yara \
  --format summary \
  stdio \
  --stdio-command uv \
  --stdio-arg run \
  --stdio-arg automox-mcp \
  --stdio-env AUTOMOX_API_KEY=test-api-key \
  --stdio-env AUTOMOX_ACCOUNT_UUID=test-account \
  --stdio-env AUTOMOX_ORG_ID=1 \
  --stdio-env AUTOMOX_MCP_SKIP_DOTENV=1

バージョン管理

セマンティックバージョニングに従います。pyproject.toml を更新し、コミットしてタグ（例：v0.1.0）を付けてプッシュすると、リリースワークフローによって PyPI に自動で公開されます。

ライセンス

MIT ライセンスです。LICENSE を参照してください。

サポート

Automox 公式 MCP サーバーです。質問、不具合、機能のリクエストについては、help.automox.com をご利用ください。

セキュリティの脆弱性を報告する場合は、SECURITY.md を参照してください。公開の issue は作成しないでください。