Kaseya BMS MCP

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

非官方。社区构建的 Claude Code Skill 和 Kaseya BMS API MCP 服务。与 Kaseya US LLC 无关联，也未获得其认可或赞助。

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

首个专为 Kaseya BMS 打造的 CLI 和 MCP 服务——涵盖完整的 PSA 功能，并支持离线同步、全文搜索，以及网页表格无法计算的队列、合同消耗和未计费工时分析。可与您已在使用的 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	如何安装 Kaseya BMS 技能
Claude Desktop	运行安装程序，然后通过 Settings > Extensions 注册 kaseya-bms-mcp（无需编辑 JSON）。
ChatGPT（付费套餐）	此连接器重新发布前暂停：ChatGPT 需要 HTTP 模式，而此版本的该模式无需密码，会监听所有网络接口，也可被您打开的网页访问。请参见 mcp-install.md 中的安全提示。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 kaseya-bms-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 应用则在远程运行，需要使用与 ChatGPT 相同的暂停使用的 HTTP 模式。请参阅 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，之后为 CLI／MCP 二进制文件运行各自的安装程序）。请参阅 docs/which-agent.md。

60 秒内完成安装

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

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

下载 Kaseya BMS MCP（.mcpb）——然后打开 Claude Desktop > Settings > Extensions 并选择此文件。一键完成，无需 JSON，也无需使用 shell。（在发布页面浏览所有 Kaseya BMS 版本。）

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

/plugin marketplace add Servosity/msp-skills
/plugin install kaseya-bms@msp-skills

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

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

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

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

kaseya-bms-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

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

为 Hermes 安装

在 Hermes CLI 中：

hermes skills install servosity/msp-skills/skills/kaseya-bms --force

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/kaseya-bms --force

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

为 OpenClaw 安装

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

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

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

身份验证

Kaseya BMS 会签发短期 JWT。最简单的方式是使用 BMS API 用户凭据生成一个 JWT，并让 CLI 保存：

export KASEYA_BMS_USERNAME="[email protected]"
export KASEYA_BMS_PASSWORD="<password>"   # env-only; never passed on the command line
export KASEYA_BMS_TENANT="yourmsp"        # your company/tenant name from My Settings
kaseya-bms-cli auth login                 # exchanges these for a JWT and saves it

已经有 JWT？跳过登录，直接传入即可：

KASEYA_BMS_TOKEN=<jwt> kaseya-bms-cli doctor

非美国租户？使用 KASEYA_BMS_BASE_URL 指定所在区域（默认为 https://api.bms.kaseya.com）。doctor 会在你运行任何会访问数据的命令前确认凭据有效；当命令开始返回 401 Security Error 时，再次运行 kaseya-bms-cli auth login 以刷新令牌。即使凭据被拒绝，它也会以 0 退出，因此脚本应添加 --fail-on error。

此 skill 的功能

MSP 经常提出的问题	命令
哪些队列积压严重？哪些事项会在晨会前过期？	kaseya-bms-cli queue-health --agent
哪些未结工单已经一周无人处理？按时间从久到近排列。	kaseya-bms-cli stale-tickets --days 7 --agent
谁的工作负荷过重？谁可以接下一个工单？	kaseya-bms-cli workload --agent
本季度每份合同的额度已消耗多少？	kaseya-bms-cli contract-burn --window-days 90 --agent
哪些已批准的可计费工时已可开票？按客户账户查看。	kaseya-bms-cli unbilled --agent
按阶段划分的未结销售管道情况如何？哪些交易已延期？	kaseya-bms-cli pipeline --agent
在整个租户中查找所有提及某个短语的工单	kaseya-bms-cli search "VPN outage"
将租户同步到本地镜像，以便即时离线查询	kaseya-bms-cli sync

除此之外，CLI 覆盖了 BMS 的全部功能范围——涵盖服务台、CRM、合同、财务、项目、库存和集成的 472 条命令。

完整命令参考：guide.md。有关 AI Agent 的操作约定（--agent、--dry-run，以及何时在变更前确认），请参阅 AGENTS.md。

有何不同

大多数 Kaseya BMS 集成和 MCP 服务都会将每个问题转发为实时 API 调用。查询单条记录时，这样做没问题。但遇到大规模查询时就行不通了，例如“本月所有客户尚未开票的已批准可计费工时总计是多少”或“哪些合同在续约前额度消耗最多”——而且 BMS API 每个端点每小时 1,500 次请求的限制，会让实时查询代价高昂。

此 skill 会将 Kaseya BMS 同步到带有全文搜索功能的本地 SQLite 镜像。聚合查询只需执行一次本地 SQL 联接：即时、离线，而且 AI 看到的是答案，而不是原始数据。workload（将未结工单与每位技术人员登记的工时联接）和 contract-burn（通过工单关联的合同汇总时间记录）等复合命令，会跨工单、时间记录和合同进行联接——这是无状态 API 封装无法做到的。

要解决的痛点

问任何一位使用 Kaseya BMS 的 MSP，他们怎么看报表，r/msp 和 MSPGeek 社区的回答都一致：这是薄弱环节。服务台每天早上都会问的问题——哪些队列积压严重，哪些工单已经搁置，谁忙得不可开交，谁能接手下一项升级——都得先导出到 Excel 再做数据透视表，无法一点即得。月底也一样麻烦：为开票而逐个客户提取已批准但尚未开票的工时，并在续约沟通前查看客户已用掉多少预付合同额度。

此技能将这些操作分别简化为一条命令，从本地镜像获取结果：

• kaseya-bms-cli queue-health --agent - 按队列、优先级和状态统计未结工单数量，并在每日站会前标出搁置工单数量。
• kaseya-bms-cli stale-tickets --days 7 --agent - 列出一周内无人处理的具体未结工单，按搁置时间从长到短排序。
• kaseya-bms-cli workload --agent - 汇总各技术人员的未结工单负载和已记录工时，方便你安排下一项派单。
• kaseya-bms-cli unbilled --agent - 按客户账户汇总已批准、可计费但尚未开票的工时，以小时为单位，供开票前审核。
• kaseya-bms-cli contract-burn --window-days 90 --agent - 按合同查看已用工时和已过周期百分比，优先显示有风险的合同。

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

常见问题

这能与 ChatGPT 配合使用吗？

此版本不支持。ChatGPT（Plus、Pro、Team、Business、Enterprise 和 Education 计划；Free 目前尚未开放 Developer Mode）只能通过 HTTPS 连接到远程 MCP 服务，这意味着需要以 HTTP 模式运行 Kaseya BMS 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）。这两种方式都不需要编写代码。你只需输入一次 Kaseya BMS 凭据。

我的 Kaseya BMS 数据安全吗？

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

这会触及 Kaseya BMS API 的速率限制吗？

很少。BMS 对每个端点每小时允许 1,500 次请求。读取操作默认使用本地 SQLite 镜像（--data-source auto），因此日常查询不会消耗 任何 API 调用；只有在执行 sync 或通过 --data-source live 明确查询实时数据时，才会消耗配额。

我需要是 Kaseya 客户吗？如何进行身份验证？

需要——你必须拥有 Kaseya BMS 租户和 API 用户。此技能使用该用户通过 kaseya-bms-cli auth login 进行身份验证（需要提供 BMS 用户名、密码和租户名称），或者你也可以粘贴预先签发的 JWT，并通过 KASEYA_BMS_TOKEN 使用。它只能执行该 BMS 用户获准执行的操作。

这会取代我的 Kaseya BMS 门户吗？

不会。它能更快地回答你每天都会问的问题——队列健康状况、未开票工时、管道等——也能让 AI Agent 操作服务台。BMS 门户仍然是你的记录系统。

费用是多少？

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

安全模型

层级	示例	建议的 Agent 策略
读取（243）	queue-health、stale-tickets、unbilled、pipeline、servicedesk get-ticket、search	允许
写入 - 常规（124）	servicedesk post-ticket、servicedesk assign-ticket、crm post-account、finance mark-invoices-as-sent、import	使用 --dry-run 预览，然后经审核后写入
凭据 / 安全	integrations get-itgpassword-value、integrations get-vsa-access-info、security refresh-token、auth login	仅限人工介入
破坏性操作（21）	servicedesk delete-ticket、crm delete-contact、system delete-attachment	仅限人工介入
管理（75）	admin 组：webhooks、工作流、服务、K1 访问控制、Teams 频道	仅限操作员，不适用于 Agent

每个 GET 命令上的 mcp:read-only 注解可让 MCP 客户端自动限制写入操作；常规写入层级涵盖所有 POST/PUT/PATCH 命令，以及没有动词的 import。最有效的控制措施是你授予 Kaseya BMS 凭据的权限范围——CLI 只能执行这些凭据获准执行的操作。完整详情（包括如何收紧权限）请见 governance.md。

状态

Beta 版。已根据 Kaseya BMS API 范围进行验证，目前正与 MSP 合作，在每周的 Build Sessions 中使用其生产租户进行验证。请在 compoundingteams.com/build-sessions RSVP。

---

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

由 Servosity 维护。采用 Apache-2.0 许可证。使用 CLI Printing Press 构建。上次更新：2026-06-07。