Bitdefender MCP

Bitdefender + AI - 适用于 ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini，以及任何支持 MCP 的 Agent

非官方。由社区构建的 Claude Code Skill 和 Bitdefender API MCP 服务。与 Bitdefender SRL 无关联，未获其认可或赞助。

_{▶ 观看 30 秒演示 - 演示数据为模拟数据；展示的每条命令都真实存在于 CLI 中。}

提供 140 种 GravityZone API 方法，以及跨子公司的设备群运行状况、账单和事件视图。可与您已在使用的 AI 配合使用 - ChatGPT（Plus/Pro+，此连接器重新发布前暂停；请参阅 mcp-install.md）、Claude Desktop、Codex、Claude Code、Claude Cowork 和 GitHub Copilot - 也可通过远程方式配合 Microsoft 365 Copilot / Copilot Studio 和 Google Gemini 使用。免费、开源，可在您的笔记本电脑上运行。专为 MSP 所有者打造。无需编写代码。

适用于您的 Agent

安全提示（此连接器重新发布前）。 不要运行 HTTP 模式 （--transport http），即使是在 localhost 上也不行。此版本会检查令牌，但 早于修复版本对请求大小和时间限制的修复。MCP 工具也可以使用您的凭据 执行更改。请使用默认的 stdio 传输。如果您为远程 Agent 设置了隧道，请将其 关闭。修复版本即将推出。

MSP 所有者实际使用的六种 Agent（可自行安装，即刻可用）：

您的 AI Agent	如何安装 Bitdefender skill
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 bitdefender-mcp（无需编辑 JSON）。
ChatGPT（付费方案）	此连接器重新发布前暂停：ChatGPT 需要 HTTP 模式，而此版本的该模式虽会检查令牌，但尚未设定请求大小或时间限制。请参阅 mcp-install.md 中的安全提示。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 bitdefender-mcp，然后选择 Agent 模式。

ChatGPT 需要远程 HTTPS 服务，这意味着需要使用此连接器的 HTTP 模式；该模式在连接器重新发布前暂停：此版本的该模式虽会检查令牌，但尚未设定请求大小或时间限制。请参阅 mcp-install.md 中的安全提示。

Microsoft 和 Google 技术栈也适用

用户基数很大，但先说明一点：这些属于远程 / 企业级路径，不是你刚安装的本地二进制文件。

Agent	所需条件
Microsoft 365 Copilot / Copilot Studio	暂停使用，直到重新发布此连接器：Copilot Studio 需要使用 HTTP 模式，而在此构建版本中，该模式会检查令牌，但尚无请求大小或时间限制。请参阅 mcp-install.md 中的安全说明。
Google Gemini	Gemini CLI 在本地运行，与 Claude Code 相同。Gemini app 在远程运行，需要使用与 ChatGPT 相同的暂停 HTTP 模式。请参阅 mcp-install.md。

原生支持 Skill 的 Agent（也涵盖在内）： Hermes 和 OpenClaw 会直接读取此 Skill 的 SKILL.md，同时也支持 MCP——请参阅下方的安装部分。Cursor、Windsurf、Cline、Continue.dev 和 Zed 也可通过 MCP 使用。各工具的完整连接配置：docs/which-agent.md。

要使用多个 Agent？ 运行一条命令即可为所有 51+ 个受支持的 Agent 安装：npx skills add Servosity/msp-skills@latest（需要 Node.js，然后运行各 Skill 的安装程序来安装 CLI/MCP 二进制文件）。请参阅 docs/which-agent.md。

60 秒内完成安装

Claude Desktop 最快安装方式——一键安装 .mcpb

下载 Bitdefender MCP (.mcpb)——然后打开 Claude Desktop > Settings > Extensions 并选择该文件。一键完成，无需 JSON 或 shell。（在发布页面浏览所有 Bitdefender 版本。）

更喜欢 Claude Code 插件？只需添加一次扩展市场，然后安装——立即生效，无需列出目录：

/plugin marketplace add Servosity/msp-skills
/plugin install bitdefender@msp-skills

路径 A——向 AI Agent 粘贴一条提示词（推荐）

将以下内容复制到 Claude Code、Codex CLI 或 Claude Cowork 中：

在此 Agent 工作区中，从 Servosity/msp-skills 安装 Bitdefender Skill 和 MCP 服务。如果此工作区使用 POSIX shell（macOS、Linux、WSL 或 Bash），运行 bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/bitdefender/install.sh)。如果使用 Windows PowerShell，运行 iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/bitdefender/install.ps1 | iex。然后按照 README 进行身份验证，并运行 bitdefender-cli --help 以了解用法。

任何能够运行 shell 的 Agent 都可以使用同一条提示词。

路径 B——自行运行安装程序

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/bitdefender/install.ps1 | iex

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/bitdefender/install.sh)

安装程序会将 bitdefender-cli（CLI）和 bitdefender-mcp（MCP 服务）放入用户的 bin 路径。Claude Code、Codex 和 Cowork 会通过此目录中的 SKILL.md 发现 Skill。

验证：

bitdefender-cli --version

升级到最新版本

安装程序始终会获取当前版本——重新运行即可升级：

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/bitdefender/install.sh)

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/bitdefender/install.ps1 | iex

Claude Desktop .mcpb 用户：下载最新的 .mcpb（见本节顶部），然后在 Settings > Extensions 中重新选择它。Claude Code 插件用户：/plugin update bitdefender@msp-skills。

添加到 Claude Desktop、GitHub Copilot、Gemini CLI、Microsoft 365 Copilot 或其他 MCP 客户端

运行安装程序后，请参阅 mcp-install.md 和 docs/which-agent.md，查看各 Agent 的连接配置——每个 Agent 都有单独的部分，其中包括 GitHub Copilot 的 servers 键，以及远程 Microsoft 365 Copilot / Copilot Studio 路径。Claude Desktop 的 Settings > Extensions 面板是最简单的方式；mcp-install.md 中记录了 MCP 配置代码块（适合偏好编辑 JSON 的用户）。

为 Hermes 安装

在 Hermes CLI 中：

hermes skills install servosity/msp-skills/skills/bitdefender --force

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/bitdefender --force

Hermes 原生支持 MCP，因此也可以直接使用 bitdefender-mcp 服务——安装方式和环境变量相同。

为 OpenClaw 安装

告诉你的 OpenClaw Agent（复制以下内容）：

从 https://github.com/servosity/msp-skills/tree/main/skills/bitdefender 安装 bitdefender skill。该 skill 定义了如何通过 openclaw: frontmatter 块安装其所需的 CLI（bitdefender-cli）。

OpenClaw 尚未普遍开放；frontmatter 配置已预先提供，将在 OpenClaw 发布时立即启用。

身份验证

从 GravityZone Control Center（用户图标 > My Account > Control Center API）设置 API 密钥。只有当你的 Access URL 不是 https://cloud.gravityzone.bitdefender.com/api 时，才需要设置 BITDEFENDER_BASE_URL：

BITDEFENDER_API_KEY=<value> bitdefender-cli doctor

在 Windows 上（PowerShell）：

$env:BITDEFENDER_API_KEY = "<value>"
bitdefender-cli doctor

doctor 会检查配置、路径和 API 可达性，并将密钥发送到 GravityZone 的 getApiKeyDetails 方法。因此，被拒绝或已删除的密钥会显示为 Credentials: ERROR 行，错误的 base URL 则会显示为 API: ERROR 行。即使如此，它仍会以 0 退出，因此脚本应添加 --fail-on error。bitdefender-cli api-key --json 会显示该密钥可访问哪些 API 区域。

此 skill 的功能

MSP 常问的问题	命令
哪些客户有未受管理、已过期或尚未扫描的终端？	bitdefender-cli fleet health
自上周以来，终端防护有哪些变化？	bitdefender-cli fleet changes --since 7d
所有客户中有哪些未解决事件属于高优先级或严重级别？	bitdefender-cli fleet incident-queue --priority high,critical
多个客户是否隔离了同一种恶意软件？它是否已列入阻止名单？	bitdefender-cli fleet threats --window 7d
这台机器属于哪个客户？它的终端 ID 是什么？	bitdefender-cli fleet locate "LAPTOP-7"
我的 RMM 中哪些机器没有 Bitdefender Agent？	bitdefender-cli fleet rmm-gap --devices ninja-devices.csv
合作伙伴汇总后，各客户上个月分别使用了多少？	bitdefender-cli usage billing --month 09/2026
列出每家子公司和子合作伙伴及其 ID 和上级	bitdefender-cli companies tree

完整命令参考：guide.md。关于 AI Agent 操作规范（--agent、--dry-run、何时需要在修改前确认），请参阅 AGENTS.md。

与众不同之处

大多数 Bitdefender GravityZone 集成和 MCP 服务都会将每个问题转发为一次实时 API 调用。查询单条记录时这没问题；但一旦规模扩大，例如要问“我的 60 个客户中，哪些有未受管理的机器，或哪些 Agent 自上周以来已过期”，这种方式就难以应付。

GravityZone 的 Public API 使用 JSON-RPC，每次调用只能执行一个方法；公司树也需要通过多次 getCompaniesList 调用逐层获取。此 skill 会为你遍历整个合作伙伴树，并将每个问题分发到所有子公司。fleet health 会将每次运行保存为带日期的本地快照（SQLite），因此 fleet changes 可以比较两次运行的差异，而 fleet locate 和 fleet rmm-gap 则可直接根据最新快照回答，无需再次分发请求。无法完整读取的公司会列在 fetch_failures 中，绝不会被视为状态正常。

Liongard 的 GravityZone 检查器 和 Sumo Logic 的 GravityZone 自动化集成 等集成会将 GravityZone 数据导入各自的平台。此工具则会将跨客户的答案提供给你已在使用的任意 AI Agent。它是 GravityZone Control Center 的补充，而非替代品：策略编写、调查和日常响应仍应在控制台中进行。

它解决的痛点

GravityZone Public API 使用 JSON-RPC，而 getCompaniesList 每次只返回公司树的一层，因此每个 MSP 脚本都要自行遍历子合作伙伴和文件夹，然后按公司分页调用 getEndpointsList。Bitdefender Expert Community 论坛帖展示了一个手动编写的 PowerShell 分页循环，但仍然返回了层级结构中的错误组。与此同时，早间需要查看的信息分散在不同的 Control Center 页面上（Network、Incidents、Quarantine、月度使用情况报告）；到了月末结算时，还得手动计算每个合作伙伴在汇总使用量中各自所占的份额。

• bitdefender-cli fleet health - 按未管理、过期、未扫描、未应用策略和已隔离的终端数量，对每家子公司进行排名。
• bitdefender-cli fleet incident-queue --sla 24h - 汇总所有客户未关闭的 EDR/XDR 事件队列，最严重和最久未处理的事件排在前面，并标记未分配的事件。
• bitdefender-cli fleet threats - 找出两家或更多客户隔离的同一文件（SHA256），并显示各客户是否已将其加入阻止列表。
• bitdefender-cli usage billing --month 09/2026 - 显示每家公司的使用情况，以及汇总后各合作伙伴自身所占的份额，可用于核对 PSA 协议。

更详细的说明请参阅 pain-point.md。

常见问题

这适用于 ChatGPT 吗？

此版本不适用。ChatGPT（Plus、Pro、Team、Business、Enterprise 和 Education 套餐；Free 目前尚未开放 Developer Mode）只能通过 HTTPS 连接远程 MCP 服务，这意味着必须以 HTTP 模式运行 Bitdefender MCP 服务。此版本的 HTTP 模式会检查令牌，但尚未设置请求大小或时间限制，因此在重新发布连接器之前，请勿运行该模式或将其置于隧道后。原因请参阅 mcp-install.md 中的安全说明。在此之前，请使用 Claude Desktop、Claude Code 或 Codex。

这适用于 Codex、Cursor、Windsurf、Cline、Copilot 或 Gemini 吗？

适用——它们都支持 MCP。跨工具安装命令见上方的对照表，深入说明请参阅 docs/which-agent.md。

我需要懂编程吗？

不需要。推荐的安装方式是在 Claude Code 或 Codex 中粘贴一句话——你的 Agent 会读取 SKILL.md 并完成安装。备用方式是根据操作系统运行一行安装命令（bash 或 PowerShell）。两种方式都不需要编写代码。你只需输入一次 Bitdefender 凭据。

我的 Bitdefender 数据安全吗？

你的数据会保留在自己的计算机上。CLI 和 MCP 服务都是本地二进制文件。机群快照存储（SQLite）位于你用户帐户下的目录中。AI Agent 只能看到 CLI 返回的内容——通常是查询结果，而不是原始批量数据。凭据从环境或 Agent 配置中读取；MSP Skills 不会将其打包到此代码库中，也不会向任何地方传输。

我需要哪种 GravityZone API 密钥？

你需要 Control Center API 密钥：点击 Control Center 中的用户图标，选择 My Account，然后使用 Control Center API 区域；该区域还会显示 Access URL。创建密钥时，可以按 API 区域限定密钥的范围，但同一区域内没有读写权限之分。机群命令需要 Companies 和 Network API；usage billing 需要 Licensing，fleet incident-queue 需要 Incidents，fleet threats 需要 Quarantine 和 Incidents。设置 BITDEFENDER_API_KEY；如果 Access URL 不是 https://cloud.gravityzone.bitdefender.com/api，还需设置 BITDEFENDER_BASE_URL。

需要合作伙伴帐户吗？

要查看跨客户数据，需要：遍历子公司需要合作伙伴级密钥，因为 getCompaniesList 是合作伙伴 API。客户级密钥也能使用，但每个机群视图只会涵盖该公司。

这会触发 GravityZone API 速率限制吗？

Control Center 会限制每个 API 密钥每秒可发送的请求数；超出限制时，会返回带有 Retry-After 标头的 429 响应。CLI 默认会将请求速率控制在每秒 5 次（--rate-limit），并在收到 429 后等待限制解除。getIncidentsList 每分钟大约允许调用 3 次，因此 fleet incident-queue 会对整个合作伙伴只发起一次调用，并将额外分页请求间隔 21 秒发送。

AI 能自行隔离设备或在端点上运行命令吗？

只有在你允许的情况下才行。生成的命令在调用时会立即运行，不会提示确认，因此请先使用 --dry-run 预览：它会打印将要发送的 JSON-RPC 方法和参数，但不会实际发送。通过 MCP，通用的 bitdefender_execute 工具可以调用任何 GravityZone 方法，包括隔离、终止进程、远程命令执行和删除；唯一的限制是你的 AI 应用中的批准提示。若要让 Agent 只能读取数据，请在 MCP 服务的环境中设置 BITDEFENDER_MCP_READ_ONLY=1：此时 bitdefender_execute 只会运行 GravityZone 读取方法，拒绝所有写入操作和 Credential 层级的读取操作，并隐藏 import 工具。事件读取仍然允许；XDR 证据可能包含在端点上捕获的连接标头，因此请将事件输出视为敏感信息。请保持启用批准提示。

为什么 fleet changes 提示没有可比较的内容？

它会比较已保存的快照，而每次运行 fleet health 都会保存一个快照（除非传入 --no-save）。至少运行两次 fleet health，例如每天运行一次；之后 fleet changes 会报告期间新增或移除的端点、受管／非受管状态变化、新过时的 Agent、不再应用的策略以及隔离状态变化。

它能看到 GravityZone Active Directory 集成中的端点吗？

Fleet 命令看不到。它们读取 getEndpointsList，该方法返回 Computers 和 Groups 清单；Bitdefender 文档说明，仅位于 Active Directory 集成下的端点应通过 getNetworkInventoryItems 获取。因此，fleet health 的计数、--fail-on 和 fleet rmm-gap 都涵盖 Computers 和 Groups；fleet health、fleet locate、fleet rmm-gap 和 fleet changes 的结果会包含说明这一点的 inventory_scope 字段。在向 rmm-gap 列为缺失的设备部署 Agent 之前，请使用 inventory list 检查该设备（这是 Credential 层级的读取操作，因为其中的公司条目包含许可证密钥）。

它能用于本地部署的 GravityZone 吗？

它使用相同的 JSON-RPC Public API，因此请将 BITDEFENDER_BASE_URL 设置为 Control Center 的 Access URL。目前尚未在正在运行的本地部署控制台上进行验证。

它会取代 GravityZone Control Center 吗？

不会。Control Center 仍最适合用于编写策略、调查问题和处理日常控制台工作。此技能用于回答跨客户问题，并从你的 AI Agent 运行脚本化操作。

它的费用是多少？

免费，采用 Apache-2.0 许可。你只需为使用的 AI Agent（Claude、ChatGPT、Codex 等）付费；费用由你的 AI 提供商收取，而不是由我们收取。

安全模型

层级	示例	建议的 Agent 策略
读取	fleet health、fleet incident-queue、fleet threats、fleet locate、fleet rmm-gap、fleet changes、companies tree、usage billing、usage monthly、companies list、endpoints list、endpoints get、incidents list、quarantine list、policies list、patches missing、tasks status、reports list	允许
终端响应	isolation isolate、isolation restore、endpoints kill-process、investigation run-command、investigation kill-process、investigation collect-package、investigation retrieve-file、tasks scan、tasks reconfigure、quarantine remove、quarantine restore、quarantine empty、live-search、yara、response-actions create	人工介入并明确确认——这些操作会触及真实客户的机器
防护与策略配置	policies set-modules、endpoints assign-policy、blocklist add、blocklist remove、custom-rules create、custom-rules update、custom-rules delete、phasr apply、maintenance-windows create、push set、integrations create、aws-ec2 configure、endpoints move、groups move	使用 --dry-run 预览，然后由人工批准后写入——排除规则、较弱的策略，或将设备移入其他组的策略，都可能造成安全漏洞
写入（常规）	incidents note、incidents set-status、incidents assign、endpoints set-label、groups create、company-folders create、reports create、packages create	使用 --dry-run 预览，然后经审核后写入
凭据与访问权限	push get（返回 webhook Authorization 值）、license get（返回许可证密钥）、companies get-by-user（需要用户密码）、packages get、packages install-links、integrations get、policies get（策略密码设置）、inventory list（可能返回许可证密钥）、accounts create、accounts update、accounts delete、email-verification、auth set-token	仅允许人工介入
破坏性操作与商业操作	import（每行 JSONL 会创建一项，因此可能触及上述任一层级）、endpoints delete、endpoints move-to-company、company-folders move、companies create、companies suspend、companies delete、company-folders delete、groups delete、packages delete、license set-key、license add-product-key、license remove-product-key、license set-monthly-subscription	仅允许人工介入，并明确确认

生成的命令在调用时会立即运行；请使用 --dry-run 预览。通过 MCP 使用时，通用的 bitdefender_execute 工具可以执行表格中的所有写入操作；如果 Agent 仅应读取数据，请设置 BITDEFENDER_MCP_READ_ONLY=1。

最有力的控制措施是授予 Bitdefender 凭据的权限范围——CLI 只能执行凭据允许的操作。完整详情（包括如何限制权限）见 governance.md。

状态

Beta 版。已根据 Bitdefender API 范围完成验证，目前正与 MSP 一起，在每周的 Build Sessions 中针对其自有生产租户进行实时验证。请在 compoundingteams.com/build-sessions 确认参加。

---

标准。 符合开放的 Agent Skills 规范（Anthropic，2025 年 12 月；支持 40 多个 Agent）。兼容 MCP，可与任何支持 MCP 的 Agent 配合使用，包括 Hermes。已支持 OpenClaw（frontmatter 已预先配置，等待 OpenClaw 发布）。

由 Servosity 维护。采用 Apache-2.0 许可证。使用 CLI Printing Press 构建。最后更新：2026-10-16。