Fleet 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"
      }
    }
  }
}

注意：如果您已全局安裝該軟件包，請將 uvx 替換為 fleet-mcp。為增強安全性，請使用 --config 標誌引用 TOML 文件，而不是嵌入令牌（請參閱 安全最佳實踐）。

轉到：設置 → Cursor 設置 → MCP → 添加新的全局 MCP 服務器。 可以全局安裝在 ~/.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 設置 → 搜索 “Cline: MCP 設置” → 編輯 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：漢堡菜單 → 設置 → 工具 → + 添加 MCP → 輸入 uvx fleet-mcp run → 名稱：“Fleet” → 添加。 手動配置：設置 → 高級 → 編輯 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"
      }
    }
  ]
}

導航到 程序 → 安裝 → 編輯 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_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_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 設置助手配置。
• fleet_list_mdm_apple_installers - 列出所有 Apple MDM 安裝程序。

VPP/應用商店管理

• fleet_list_app_store_apps - 列出可用於安裝的應用商店應用。
• 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 - 驗證邀請令牌並獲取邀請詳細信息。

數據雕刻管理

• 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 - 將一個或多個用戶添加到特定團隊。
• 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 設置助手。
• fleet_delete_setup_assistant - 刪除 MDM Apple 設置助手。
• fleet_upload_mdm_apple_installer - 上傳新的 Apple MDM 安裝程序包。 注意：擦除設備工具目前已禁用，因為它太危險。如果確實需要，可能會在以後重新考慮。

VPP/應用商店管理

• fleet_add_app_store_app - 添加用於分發的應用商店應用。
• fleet_update_app_store_app - 更新應用商店應用設置。
• 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 - 刪除待處理的邀請。