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 - 删除待处理的邀请。