Blumira MCP

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

非官方。由社区为 Blumira API 构建的 Claude Code Skill 和 MCP 服务。与 Blumira, Inc. 无关联，也未获得其认可或赞助。

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

来自你的直连组织和所有 MSP 子账户的每条 Blumira 发现、检测和 Agent 数据，都汇集在一个可离线搜索的存储中，支持跨账户分类处置和长期趋势分析，回答单次 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

安全提示（在此连接器重新发布前）。 请勿将此连接器接入 supergateway 桥接服务或任何其他 stdio 转 HTTP 桥接服务，即使是在 localhost 上也不行。该桥接服务不添加密码，因此任何能够访问其端口的人都可以使用 MCP 工具和你的凭据。请使用默认的 stdio 传输方式。如果你为远程 Agent 设置了桥接服务或隧道，请将其关闭。修复即将推出。

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

你的 AI Agent	如何安装 Blumira Skill
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 blumira-mcp（无需编辑 JSON）。
ChatGPT（付费套餐）	在此连接器重新发布前暂停：ChatGPT 需要 HTTPS 服务，而此构建版本仅支持 stdio，因此需要一个不添加密码的 stdio 转 HTTP 桥接服务。请参阅 mcp-install.md 中的安全提示。
Codex CLI	粘贴下面的安装提示词。
Claude Code	粘贴下面的安装提示词。
Claude Cowork	粘贴下面的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 blumira-mcp，然后选择 Agent 模式。

ChatGPT 需要远程 HTTPS 服务。此连接器仅支持 stdio，因此需要一个不添加密码的 stdio 转 HTTP 桥接服务；在连接器重新发布前，这种方式暂停使用。请参阅 mcp-install.md 中的安全提示。

Microsoft 和 Google 技术栈的支持

这些平台的安装量很大，但需要坦诚说明：它们走的是远程／企业版路径，而不是你刚刚安装的本地二进制文件。

Agent	所需条件
Microsoft 365 Copilot / Copilot Studio	暂停支持，直到重新发布此连接器：Copilot Studio 需要 HTTPS 服务，而这个仅支持 stdio 的构建版本需要通过 stdio-to-HTTP 桥接器来接入，但这不会增加密码保护。请参阅 mcp-install.md 中的安全说明。
Google Gemini	Gemini CLI 可在本地运行，与 Claude Code 相同。Gemini 应用在远程运行，需要采用与 ChatGPT 相同的暂停远程路径。请参阅 mcp-install.md。

原生支持 Skill 的 Agent（也已涵盖）：Hermes 和 OpenClaw 可直接读取此 Skill 的 SKILL.md，也支持 MCP——请参阅下方的安装说明。通过 MCP 也支持 Cursor、Windsurf、Cline、Continue.dev 和 Zed。各工具的完整接入说明：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

Claude Desktop 安装包：.mcpb 可在 macOS（Intel 和 Apple Silicon）、Windows x64 和 Linux x64 上启动。每个工具都会调用配套的 blumira-cli。从 2026-09-18 起发布的版本会在安装包中附带该 CLI；较早的安装包仅包含 MCP 服务，因此如果你的安装包缺少配套 CLI，请先运行下方的路径 A 或路径 B 安装程序（或将 BLUMIRA_CLI_PATH 设置为现有二进制文件的路径）。详情： #331。

下载 Blumira MCP（.mcpb）——然后打开 Claude Desktop > 设置 > 扩展 并选择该文件。只需点击一次，无需 JSON 或命令行。（可在 releases page 浏览所有 Blumira 发布版本。）

更倾向于使用 Claude Code 插件？添加一次市场，然后安装即可——立即生效，无需列出目录：

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

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

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

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

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

blumira-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

Claude Desktop .mcpb 用户：下载最新的 .mcpb（见本节顶部），然后在 设置 > 扩展 中重新选择该文件。Claude Code 插件用户：/plugin update blumira@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 面板是最简单的方式；面向偏好编辑 JSON 的用户，MCP 配置块见 mcp-install.md。

为 Hermes 安装

在 Hermes CLI 中：

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

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/blumira --force

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

为 OpenClaw 安装

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

从 https://github.com/servosity/msp-skills/tree/main/skills/blumira 安装 blumira 技能。该技能会通过 openclaw: frontmatter 块说明如何安装其必需的 CLI（blumira-cli）。

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

进行身份验证

设置 CLI 所需的凭据（从你的 Blumira 门户获取）：

BLUMIRA_API_TOKEN=<value> BLUMIRA_CLIENT_ID=<value> BLUMIRA_CLIENT_SECRET=<value> blumira-cli doctor

doctor 会在你运行任何会访问数据的操作前，确认凭据有效。即使凭据被拒绝，它也会以 0 退出，因此脚本应添加 --fail-on error。

此技能的功能

MSP 经常提出的问题	命令
目前所有客户端账户中，最严重的未解决发现有哪些？	blumira-cli triage --status open
自上次同步以来有哪些变化：新增、已解决或状态发生变化的发现？	blumira-cli drift
本月每个账户的平均解决时间是多少？	blumira-cli velocity --by account --window 30d
哪些未解决发现即将违反基于时限的 SLA？	blumira-cli sla --breach-in 4h
与我们的基准规则集相比，哪些检测规则的覆盖范围有所下降？	blumira-cli coverage --against basis
所有账户中，哪些域控制器已过时或未受保护？	blumira-cli exposure --flag-dc-stale
哪些检测在多个账户中反复触发？	blumira-cli recurring --window 90d
哪些发现的证据中提到了此 IOC、主机名或用户？	blumira-cli evidence-search "<ioc>"

完整命令参考见：guide.md。AI Agent 操作规范（--agent、--dry-run，以及何时在执行更改前确认）见 AGENTS.md。

有何不同

大多数 Blumira 集成和 MCP 服务都会将每个问题转发为实时 API 调用。这对于单条记录来说没问题。但当规模扩大时就行不通了，例如你要问“目前所有 30 个客户端账户中有多少条未解决的严重发现，其中哪三个账户占了大多数”。

此技能会将 Blumira 同步到带有全文搜索功能的本地 SQLite 镜像中。聚合查询只需执行一次本地 SQL 联接：即时完成、无需联网，AI 看到的是答案，而不是原始数据。triage、coverage 和 velocity 等复合命令可一次性将所有账户中的发现与检测规则及 Agent 签到记录进行联接——这是无状态 API 封装器无法做到的。

解决的痛点

Blumira 主打无需完整 SOC 即可实现检测和响应，但 r/msp 上将它与其他 MDR/SIEM 方案进行比较的帖子，总会提到同一个运营问题：产品很容易部署，但第二天起的工作就是告警分流，而合作伙伴门户要求你一次只能处理一个账户的告警分流。切换当前组织、整理未处理的发现、记下最严重的问题，再切换到下一个组织。面对一批客户，既没有一个统一页面能汇总发现、检测覆盖情况和 Agent 健康状态，也就无法一目了然地回答“哪些账户的覆盖情况落后了”或“本周哪些域控制器失联了”，只能手动逐一检查，并在脑中记住结果。

此技能通过本地镜像进行跨账户读取，解决了这个问题：

• blumira-cli triage --status open - 跨所有客户账户，提供按全局优先级排序的未处理发现队列。
• blumira-cli coverage --against basis - 按账户列出相对于基准规则集缺失或已禁用的检测规则。
• blumira-cli exposure --flag-dc-stale - 优先呈现已过期或未受保护的域控制器。
• blumira-cli velocity --by account --window 30d - 按账户显示平均解决时间和未处理率，方便你找出不堪重负的账户。
• blumira-cli drift - 显示上次同步以来新增、已解决或状态发生变化的内容。

更完整的说明请参阅 pain-point.md。

常见问题

这适用于 ChatGPT 吗？

当前版本不适用。ChatGPT（Plus、Pro、Team、Business、Enterprise 和 Education 计划；Free 目前尚未开放 Developer Mode）只能连接通过 HTTPS 提供服务的远程 MCP 服务。Blumira MCP 服务仅支持 stdio，因此需要在前面加一个 stdio-to-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）。这两种方式都不需要编写代码。你只需输入一次 Blumira 凭据。

我的 Blumira 数据安全吗？

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

使用跨账户视图需要 Blumira 合作伙伴账户吗？

跨账户命令（triage、overview 以及覆盖所有客户的覆盖情况）会读取 Blumira 的MSP 子账户 API，因此需要拥有子账户访问权限的合作伙伴 API 凭据。单组织账户仍可使用所有直接组织命令、发现、证据搜索、Agent 和检测汇总，以及离线 sync。请在 Settings > Organization > Generate API Credentials 下生成凭据，然后运行 blumira-cli auth login。

这会取代 Blumira 门户或其自动化响应吗？

不会。Blumira 门户及其自动化检测和响应手册仍会照常运行。此技能通过 Blumira 的公共 API 读取相同的发现、检测和 Agent 信息，并增加门户无法汇总的跨账户视图。只有在你提出要求时，它才会进行写入操作（添加评论、解决问题或分配负责人）；建议先使用 --dry-run 预览这些写入操作。

这会触及我的 Blumira API 速率限制吗？

sync 会将每个账户同步到本地 SQLite，因此日常问题会查询镜像，而不是实时 API。你可以通过 sync 的 --rate-limit 和 --concurrency 控制请求频率，大多数分析命令（triage、coverage、velocity、drift）默认读取本地存储。

费用是多少？

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

安全模型

层级	示例	建议的 Agent 策略
读取	triage、overview、drift、velocity、sla、coverage、exposure、recurring、audit、search、evidence-search、sync	允许
写入（常规）	msp resolve-finding、msp set-finding-owners、msp add-account-finding-comment、org controller-direct-resolve-finding、org controller-direct-set-owners、org controller-direct-add-comment	使用 --dry-run 预览，然后经审核后写入
凭据 / 配置	凭据存放在 auth login / auth set-token 中；API 不提供删除或批量配置命令	仅限人在环路中操作

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

状态

Beta 版。已根据 Blumira API 功能进行验证，并正在每周 Build Sessions 中与使用自有生产租户运行该工具的 MSP 一起验证。请在 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-06-06。