Fleetp MCP

設定ファイルの場所

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

設定

{
  "mcpServers": {
    "fleet": {
      "command": "uvx",
      "args": ["fleet-mcp", "run"],
      "env": {
        "FLEET_SERVER_URL": "https://your-fleet-instance.com",
        "FLEET_API_TOKEN": "your-api-token",
        "FLEET_READONLY": "true",
        "FLEET_ALLOW_SELECT_QUERIES": "true"
      }
    }
  }
}

Note: パッケージをグローバルにインストールした場合は、uvx を fleet-mcp に置き換えてください。セキュリティを強化するには、トークンを埋め込む代わりに --config フラグを使用して TOML ファイルを指定してください（セキュリティのベストプラクティスを参照）。

Settings → Cursor Settings → MCP → Add new global MCP server に移動します。

グローバルに ~/.cursor/mcp.json へ、またはプロジェクトごとに .cursor/mcp.json へインストールします。詳しくはCursor MCP のドキュメントを参照してください。

{
  "mcpServers": {
    "fleet": {
      "command": "uvx",
      "args": ["fleet-mcp", "run"],
      "env": {
        "FLEET_SERVER_URL": "https://your-fleet-instance.com",
        "FLEET_API_TOKEN": "your-api-token",
        "FLEET_READONLY": "true",
        "FLEET_ALLOW_SELECT_QUERIES": "true"
      }
    }
  }
}

設定ファイルの場所： ~/.cline/mcp_settings.json（macOS/Linux）または %USERPROFILE%\.cline\mcp_settings.json（Windows）

または、VS Code の Settings → 「Cline: MCP Settings」を検索 → Edit JSON を選択します。

{
  "mcpServers": {
    "fleet": {
      "command": "uvx",
      "args": ["fleet-mcp", "run"],
      "env": {
        "FLEET_SERVER_URL": "https://your-fleet-instance.com",
        "FLEET_API_TOKEN": "your-api-token",
        "FLEET_READONLY": "true",
        "FLEET_ALLOW_SELECT_QUERIES": "true"
      }
    }
  }
}

設定ファイルの場所： ~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "fleet",
      "command": "uvx",
      "args": ["fleet-mcp", "run"],
      "env": {
        "FLEET_SERVER_URL": "https://your-fleet-instance.com",
        "FLEET_API_TOKEN": "your-api-token",
        "FLEET_READONLY": "true",
        "FLEET_ALLOW_SELECT_QUERIES": "true"
      }
    }
  ]
}

設定ファイルの場所： ~/.config/zed/settings.json（macOS/Linux）または %APPDATA%\Zed\settings.json（Windows）

{
  "context_servers": {
    "fleet": {
      "command": {
        "path": "uvx",
        "args": ["fleet-mcp", "run"]
      },
      "settings": {
        "env": {
          "FLEET_SERVER_URL": "https://your-fleet-instance.com",
          "FLEET_API_TOKEN": "your-api-token",
          "FLEET_READONLY": "true",
          "FLEET_ALLOW_SELECT_QUERIES": "true"
        }
      }
    }
  }
}

詳しくはWindsurf MCP のドキュメントを参照してください。

{
  "mcpServers": {
    "fleet": {
      "command": "uvx",
      "args": ["fleet-mcp", "run"],
      "env": {
        "FLEET_SERVER_URL": "https://your-fleet-instance.com",
        "FLEET_API_TOKEN": "your-api-token",
        "FLEET_READONLY": "true",
        "FLEET_ALLOW_SELECT_QUERIES": "true"
      }
    }
  }
}

詳しくはVS Code MCP のドキュメントを参照してください。

"mcp": {
  "servers": {
    "fleet": {
      "type": "stdio",
      "command": "uvx",
      "args": ["fleet-mcp", "run"],
      "env": {
        "FLEET_SERVER_URL": "https://your-fleet-instance.com",
        "FLEET_API_TOKEN": "your-api-token",
        "FLEET_READONLY": "true",
        "FLEET_ALLOW_SELECT_QUERIES": "true"
      }
    }
  }
}

設定ファイルの場所： ~/Library/Application Support/Cody/mcp_settings.json（macOS）、%APPDATA%\Cody\mcp_settings.json（Windows）、または ~/.config/Cody/mcp_settings.json（Linux）

{
  "mcpServers": {
    "fleet": {
      "command": "uvx",
      "args": ["fleet-mcp", "run"],
      "env": {
        "FLEET_SERVER_URL": "https://your-fleet-instance.com",
        "FLEET_API_TOKEN": "your-api-token",
        "FLEET_READONLY": "true",
        "FLEET_ALLOW_SELECT_QUERIES": "true"
      }
    }
  }
}

UI から： Hamburger menu → Settings → Tools → + Add MCP → uvx fleet-mcp run を入力 → 名前：「Fleet」→ Add

手動設定： Settings → Advanced → Edit settings.json

"augment.advanced": {
  "mcpServers": [
    {
      "name": "fleet",
      "command": "uvx",
      "args": ["fleet-mcp", "run"],
      "env": {
        "FLEET_SERVER_URL": "https://your-fleet-instance.com",
        "FLEET_API_TOKEN": "your-api-token",
        "FLEET_READONLY": "true",
        "FLEET_ALLOW_SELECT_QUERIES": "true"
      }
    }
  ]
}

Program → Install → Edit mcp.json に移動します。LM Studio MCP サポートを参照してください。

{
  "mcpServers": {
    "fleet": {
      "command": "uvx",
      "args": ["fleet-mcp", "run"],
      "env": {
        "FLEET_SERVER_URL": "https://your-fleet-instance.com",
        "FLEET_API_TOKEN": "your-api-token",
        "FLEET_READONLY": "true",
        "FLEET_ALLOW_SELECT_QUERIES": "true"
      }
    }
  }
}

その他の MCP 対応クライアントでは、次の一般的な形式を使用してください。

{
  "mcpServers": {
    "fleet": {
      "command": "uvx",
      "args": ["fleet-mcp", "run"],
      "env": {
        "FLEET_SERVER_URL": "https://your-fleet-instance.com",
        "FLEET_API_TOKEN": "your-api-token",
        "FLEET_READONLY": "true",
        "FLEET_ALLOW_SELECT_QUERIES": "true"
      }
    }
  }
}

これらのツールは、すべてのモード（readonly=true または readonly=false）で利用できます。データの読み取りのみを行い、Fleet の状態を変更することはありません。

ホスト管理

• fleet_list_hosts - フィルタリング、ページネーション、検索に対応したホスト一覧を取得します
• fleet_get_host - IDを指定して、特定のホストの詳細情報を取得します
• fleet_get_host_by_identifier - ホスト名、UUID、ハードウェアシリアル番号でホストを取得します
• fleet_search_hosts - ホスト名、UUID、シリアル番号、IPアドレスでホストを検索します
• fleet_list_host_upcoming_activities - 特定のホストの今後のアクティビティ一覧を取得します
• fleet_list_host_past_activities - 特定のホストの過去のアクティビティ一覧を取得します
• fleet_get_host_mdm - 特定のホストのMDM情報を取得します
• fleet_list_host_certificates - 特定のホストの証明書一覧を取得します
• fleet_get_host_macadmins - ホストのmacadminsデータ（Munki、MDMプロファイル）を取得します
• fleet_get_host_device_mapping - ホストのデバイスマッピング情報を取得します
• fleet_get_host_encryption_key - ホストのディスク暗号化復旧キーを取得します

クエリ管理

• fleet_list_queries - 保存済みクエリの一覧をページネーション付きで取得します
• fleet_get_query - 特定の保存済みクエリの詳細を取得します
• fleet_get_query_report - スケジュールされたクエリの最新結果を取得します

ポリシー管理

• fleet_list_policies - すべてのコンプライアンスポリシーを一覧表示します
• fleet_get_policy_results - 特定のポリシーのコンプライアンス結果を取得します

ソフトウェアと脆弱性

• fleet_list_software - Fleet全体のソフトウェアインベントリを一覧表示します
• fleet_get_software - 特定のソフトウェア項目の詳細情報を取得します
• fleet_get_host_software - 特定のホストにインストールされているソフトウェアを取得します
• fleet_get_vulnerabilities - フィルタリングに対応した既知の脆弱性一覧を取得します
• fleet_get_cve - 特定のCVEの詳細情報を取得します
• fleet_search_software - 名前でソフトウェアを検索します
• fleet_find_software_on_host - ホスト名で、ホスト上の特定のソフトウェアを検索します
• fleet_get_software_install_result - ソフトウェアインストールリクエストの結果を取得します
• fleet_list_software_titles - Fleet全体のソフトウェアタイトル一覧を取得します
• fleet_get_software_title - 特定のソフトウェアタイトルの詳細情報を取得します

チーム管理

• fleet_list_teams - すべてのチームを一覧表示します
• fleet_get_team - 特定のチームの詳細を取得します
• fleet_list_team_users - 特定のチームに所属するユーザーをすべて一覧表示します
• fleet_get_team_secrets - チーム固有の登録シークレットを一覧表示します

ユーザー管理

• fleet_list_users - フィルタリングに対応した全ユーザーの一覧を取得します
• fleet_get_user - 特定のユーザーの詳細を取得します
• fleet_list_user_sessions - ユーザーのアクティブなセッションを一覧表示します
• fleet_get_session - IDでセッションの詳細を取得します

ラベル管理

• fleet_list_labels - すべてのラベルを一覧表示します
• fleet_get_label - 特定のラベルの詳細情報を取得します

パック管理

• fleet_list_packs - すべてのクエリパックを一覧表示します
• fleet_get_pack - 特定のパックの詳細情報を取得します
• fleet_list_scheduled_queries - 特定のパック内のスケジュール済みクエリを一覧表示します

スクリプト管理

• fleet_list_scripts - Fleetで利用可能なすべてのスクリプトを一覧表示します
• fleet_get_script - 特定のスクリプトの詳細を取得します
• fleet_get_script_result - スクリプト実行の結果を取得します
• fleet_list_batch_scripts - バッチスクリプトの実行一覧を取得します
• fleet_get_batch_script - バッチスクリプト実行の詳細を取得します
• fleet_list_batch_script_hosts - バッチスクリプト実行に含まれるホストを一覧表示します
• fleet_list_host_scripts - 特定のホストで利用可能なスクリプトを一覧表示します

MDM 管理

• fleet_list_mdm_commands - 実行済みの MDM コマンドを一覧表示します
• fleet_get_mdm_command_results - MDM コマンドの結果を取得します
• fleet_list_mdm_profiles - MDM 構成プロファイルを一覧表示します
• fleet_get_host_mdm_profiles - 特定のホストにインストールされている MDM プロファイルを取得します
• fleet_get_mdm_profiles_summary - MDM プロファイルの展開状況の概要を取得します
• fleet_get_filevault_summary - FileVault 暗号化の概要を取得します
• fleet_list_mdm_devices - MDM に登録されているすべての Apple デバイスを一覧表示します
• fleet_get_bootstrap_metadata - チームのブートストラップパッケージに関するメタデータを取得します
• fleet_get_bootstrap_summary - ブートストラップパッケージの展開状況の集計概要を取得します
• fleet_get_setup_assistant - MDM の Apple Setup Assistant 構成を取得します
• fleet_list_mdm_apple_installers - すべての Apple MDM インストーラーを一覧表示します

VPP/App Store 管理

• fleet_list_app_store_apps - インストール可能な App Store アプリを一覧表示します
• fleet_list_vpp_tokens - Fleet で構成されている VPP トークンを一覧表示します

構成管理

• fleet_get_config - 現在の Fleet アプリケーション構成を取得します
• fleet_get_enroll_secrets - 登録シークレットの構成を取得します
• fleet_get_certificate - Fleet サーバーの証明書チェーンを取得します
• fleet_get_version - Fleet サーバーのバージョン情報を取得します

シークレット管理

• fleet_list_secrets - Fleet のシークレット変数を一覧表示します

招待管理

• fleet_list_invites - 保留中のユーザー招待を一覧表示します
• fleet_verify_invite - 招待トークンを検証し、招待の詳細を取得します

Carve 管理

• fleet_list_carves - ファイルカーブセッションを一覧表示します
• fleet_get_carve - 特定のカーブセッションに関する詳細情報を取得します
• fleet_get_carve_block - カーブセッションから特定のデータブロックを取得します

デバイス管理

• fleet_get_device_info - デバイストークンを使用してデバイス情報を取得します

アクティビティ監視

• fleet_list_activities - Fleet のアクティビティと監査ログを一覧表示します

Osquery テーブルの検出とリファレンス

• fleet_list_osquery_tables - 動的検出を使用して、利用可能な osquery テーブルを一覧表示します
• fleet_get_osquery_table_schema - 特定のテーブルの詳細なスキーマを取得します
• fleet_suggest_tables_for_query - 意図に基づいて、AI を活用したテーブルの候補を取得します

システム

• fleet_health_check - Fleet サーバーの接続と認証を確認します

これらのツールは Fleet の状態を変更でき、構成で readonly=false が設定されている場合にのみ利用できます。読み取り専用ツールに加えて、スクリプトやポリシーの作成、チームの管理など、Fleet 環境に変更を加えられるようになります。readonly=true（デフォルト）に設定すると、これらのツールは無効になります。

ホスト管理

• fleet_delete_host - Fleet からホストを削除します
• fleet_transfer_hosts - ホストを別のチームに移管します
• fleet_query_host - 特定のホストに対してアドホックなライブクエリを実行します
• fleet_query_host_by_identifier - ホスト名／UUID／シリアル番号でライブクエリを実行します
• fleet_cancel_host_activity - 特定のホストで予定されているアクティビティをキャンセルします
• fleet_lock_host - ホストデバイスをリモートでロックします
• fleet_unlock_host - ホストデバイスをリモートでロック解除します
• fleet_unenroll_host_mdm - ホストの MDM 登録を解除します
• fleet_add_labels_to_host - ホストにラベルを追加します
• fleet_remove_labels_from_host - ホストからラベルを削除します
• fleet_refetch_host - ホストにデータを直ちに再取得、更新させます

クエリ管理

• fleet_create_query - 新しい保存済みクエリを作成します
• fleet_delete_query - 保存済みクエリを削除します
• fleet_run_live_query_with_results - ライブクエリを実行し、結果を収集します
• fleet_run_saved_query - ホストに対して保存済みクエリを実行します

ポリシー管理

• fleet_create_policy - 新しいコンプライアンスポリシーを作成します
• fleet_update_policy - 既存のポリシーを更新します
• fleet_delete_policy - ポリシーを削除します

ソフトウェア管理

• fleet_install_software - 特定のホストにソフトウェアをインストールします
• fleet_batch_set_software - チーム向けにソフトウェアインストーラーを一括アップロード／設定します

チーム管理

• fleet_create_team - 新しいチームを作成します
• fleet_add_team_users - 特定のチームに1人以上のユーザーを追加します
• fleet_remove_team_user - 特定のユーザーをチームから削除します

ユーザー管理

• fleet_create_user - 新しいユーザーを作成します
• fleet_update_user - 既存のユーザーを更新します
• fleet_delete_session - 特定のセッションを削除／無効化します
• fleet_delete_user_sessions - 特定のユーザーのすべてのセッションを削除します

ラベル管理

• fleet_create_label - 新しいラベルを作成します
• fleet_update_label - 既存のラベルを更新します
• fleet_delete_label - 名前を指定してラベルを削除します

パック管理

• fleet_create_pack - 新しいクエリパックを作成します
• fleet_update_pack - 既存のパックを更新します
• fleet_delete_pack - 名前を指定してパックを削除します

スクリプト管理

• fleet_run_script - 特定のホストでスクリプトを実行します
• fleet_run_batch_script - 複数のホストでスクリプトを実行します
• fleet_cancel_batch_script - スクリプトの一括実行をキャンセルします
• fleet_create_script - 新しいスクリプトを作成してアップロードします
• fleet_modify_script - 既存のスクリプトを変更します
• fleet_delete_script - スクリプトを削除します

MDM 管理

• fleet_upload_mdm_profile - 新しい MDM 構成プロファイルをアップロードします
• fleet_delete_mdm_profile - MDM 構成プロファイルを削除します
• fleet_lock_device - MDM に登録されたデバイスをリモートからロックします
• fleet_upload_bootstrap_package - MDM 登録用のブートストラップパッケージをアップロードします
• fleet_delete_bootstrap_package - チームのブートストラップパッケージを削除します
• fleet_create_setup_assistant - MDM Apple Setup Assistant を作成または更新します
• fleet_delete_setup_assistant - MDM Apple Setup Assistant を削除します
• fleet_upload_mdm_apple_installer - 新しい Apple MDM インストーラーパッケージをアップロードします 注意：デバイスを消去するツールは、危険性が高すぎるため現在無効になっています。本当に必要な場合は、後日再検討する可能性があります。

VPP／App Store 管理

• fleet_add_app_store_app - 配布用の App Store アプリを追加します
• fleet_update_app_store_app - App Store アプリの設定を更新します
• fleet_delete_vpp_token - VPP トークンを削除します

構成管理

• fleet_update_config - Fleet アプリケーションの構成を更新します
• fleet_update_enroll_secrets - 登録シークレットの構成を更新します

シークレット管理

• fleet_create_secret - 新しいシークレット変数を作成します
• fleet_delete_secret - ID を指定してシークレット変数を削除します

招待管理

• fleet_create_invite - 新しいユーザー招待を作成します
• fleet_update_invite - 保留中の招待を更新します
• fleet_delete_invite - 保留中の招待を削除します

このプロジェクトでは、依存関係の管理に uv を使用しています。

セットアップ

git clone https://github.com/SimplyMinimal/fleet-mcp.git
cd fleet-mcp
uv sync --dev

よく使うタスク

プロジェクト構成

src/fleet_mcp/
├── cli.py              # Command-line interface
├── client.py           # Fleet API client
├── config.py           # Configuration management
├── server.py           # MCP server implementation
├── tools/              # MCP tool implementations
└── utils/              # Utilities (SQL validator, etc.)

1. 設定ファイルの JSON 構文を検証します
2. MCP クライアントを再起動します
3. クライアントのログでエラーを確認します
4. uvx または fleet-mcp が PATH に含まれていることを確認します：which uvx

1. 手動でテストします：uvx fleet-mcp test
2. FLEET_SERVER_URL にアクセスできることを確認します
3. FLEET_API_TOKEN が有効であることを確認します
4. 自己署名証明書の場合：FLEET_VERIFY_SSL=false

1. API トークンが正しいことを確認します
2. トークンの有効期限が切れていないことを確認します
3. トークンに適切な権限があることを確認します
4. 新しいトークンを生成します：Fleet UI → マイアカウント → API トークンを取得

1. FLEET_ALLOW_SELECT_QUERIES=true を設定します
2. クエリが SELECT のみであることを確認します（INSERT、UPDATE、DELETE などは不可）
3. osquery の SQL 構文が有効であることを確認します

• 書き込み操作には FLEET_READONLY=false が必要です
• クエリの実行には FLEET_ALLOW_SELECT_QUERIES=true が必要です
• 現在のモードでツールが利用可能か確認します