MSPbots MCP

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

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

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

这是我们能找到的首个 MSPbots 工具（2026 年 6 月）——支持易读筛选条件、以别名命名的资源、完整导出，以及 MSPbots 本身不会保留的 KPI 历史记录。可与您已在使用的 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	如何安装 MSPbots Skill
Claude Desktop	运行安装程序，然后在 Settings > Extensions 中注册 mspbots-mcp（无需编辑 JSON）。
ChatGPT（付费套餐）	在此连接器重新发布前暂停使用：ChatGPT 需要 HTTP 模式，而此版本的该模式无需密码保护，会监听所有网络接口，并且您打开的网页可以访问它。请参阅 mcp-install.md 中的安全提示。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 mspbots-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——请参阅下方的安装章节。还可通过 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 上启动。每个工具都会调用配套的 mspbots-cli。自 2026-09-18 起发布的版本会将该 CLI 一并打包；较早的安装包只包含 MCP 服务，因此如果你的安装包中没有配套 CLI，请先运行下方的路径 A 或路径 B 安装程序（或将 MSPBOTS_CLI_PATH 设置为现有二进制文件的路径）。详情请见 #331。

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

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

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

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

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

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

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

mspbots-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

Claude Desktop .mcpb 用户：下载最新的 .mcpb（见本节顶部），然后在 Settings > Extensions 中重新选择该文件。Claude Code 插件用户：运行 /plugin update mspbots@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-install.md 中查看 MCP 配置块。

为 Hermes 安装

在 Hermes CLI 中：

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

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/mspbots --force

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

为 OpenClaw 安装

向你的 OpenClaw Agent 发送以下内容（复制即可）：

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

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

验证身份

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

MSPBOTS_API_KEY=<value> mspbots-cli doctor

doctor 会检查配置、路径和 API 连通性，并报告是否已加载凭据。MSPBots API 未提供无需参数的 GET 端点，因此 doctor 无法验证密钥本身——它会显示 not verified，而不是声称一切正常。运行任意读取命令即可端到端确认密钥是否有效。

此技能的功能

MSP 团队经常提出的问题	命令
我们未结工单的积压量与上周相比是增加还是减少？	mspbots-cli trend open_tickets --agg count
自上次快照以来，未结工单有哪些变化？	mspbots-cli diff open_tickets
提取 6 月 1 日以来更新的未结工单	mspbots-cli pull open_tickets --where "Update Date >= 2026-06-01"
此数据集包含哪些列？各列的类型是什么？	mspbots-cli describe open_tickets
将整个数据集导出为 CSV，用于 QBR 演示文稿	mspbots-cli export open_tickets --format csv
记录今天的 KPI 快照（请安排定期执行，以积累历史记录）	mspbots-cli snapshot open_tickets
不再粘贴 19 位 ID——为数据集命名一次即可	mspbots-cli registry add open_tickets 1534956341424005122
我的 API 密钥和资源绑定是否正常？	mspbots-cli doctor

完整命令参考：guide.md。AI Agent 操作约定（--agent、--dry-run，以及何时在执行修改前进行确认）请参阅 AGENTS.md。

与众不同之处

它并没有可以用来做对比的 MSPbots 工具——截至 2026 年 6 月，我们未能找到适用于 MSPbots Public API 的公开 CLI、SDK 或 MCP 服务。薄薄一层封装也会继承该 API 的所有痛点：两个端点、19 位资源 ID、以逗号编码的筛选条件、没有列表端点、没有元数据、没有历史记录。你一问“我们未结工单的积压量与上周相比是增加还是减少？”，它就无能为力——API 只知道现在的情况。

此技能在本地补齐了缺失的功能层。registry add 为资源提供名称，不再使用难记的 ID。pull --where "Update Date >= 2026-06-01" 会将可读的谓词编译为线缆 DSL。export 会自动遍历所有分页结果。snapshot + diff + trend 则会在本地 SQLite 存储中保存带时间戳的副本——记录 MSPbots 本身不保留的 KPI 历史；所有计算均离线完成，不会调用 API。

解决的痛点

MSPbots 自己的公共 API 文档（wiki.mspbots.ai 的公共 API 文章，存档于 2024 年 4 月）介绍了整个编程接口：两个 GET 端点、需要从 Settings > Public API 中逐个复制资源 ID、在查询参数中用逗号分隔的规则编码筛选条件、未明确具体数值的速率限制，以及获取大型组件数据时偶尔出现的 HTTP 502。没有历史记录、没有枚举功能、没有工具，甚至连一段 curl 示例都没有。

因此，常看 MSPbots 仪表板的运维经理只能手动记录每周数据：周一截取组件截图，将计数粘贴到电子表格中，然后重复操作。一旦有人忘记，趋势记录就会中断。

• mspbots-cli snapshot open_tickets - 将任意数据集或组件的带时间戳副本保存到本地 SQLite。设置定时任务，历史记录便会不断累积。
• mspbots-cli trend open_tickets --agg count - 根据快照离线计算每周趋势。
• mspbots-cli diff open_tickets - 比较任意两个快照，逐行显示新增、删除和变更。
• mspbots-cli pull open_tickets --where "Update Date >= 2026-06-01" - 将易读的筛选条件编译为逗号编码的 DSL，确保一次通过。
• mspbots-cli export open_tickets --format csv - 自动翻页导出完整表格；达到页数上限时会如实标记部分导出。

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

常见问题

这能与 ChatGPT 搭配使用吗？

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

我的 MSPbots 数据安全吗？

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

这能向 MSPbots 写入数据吗？

不能。MSPbots 公共 API 只读——只能读取数据集和组件，不能写入。此技能只会在本地写入别名注册信息、快照以及你自己的 SQLite 存储中的同步缓存。没有任何命令可以更改 MSPbots 租户中的内容。

我需要哪些凭据？

你需要 MSPbots API 密钥：管理员可在 MSPbots 应用中的 Settings > Public API 创建密钥，并将每个数据集或组件绑定到该密钥。在环境中设置 MSPBOTS_API_KEY，或运行 mspbots-cli auth set-token。绑定决定了权限范围——密钥只能读取明确绑定到它的资源，而全局 Enable Public API 开关会控制所有访问。

为什么拉取数据集前要先注册？

公共 API 没有列表端点——它无法告知哪些资源已绑定到你的密钥。你需要从 Settings > Public API 中复制每个资源 ID 一次，使用 mspbots-cli registry add open_tickets <resourceId> 注册；之后的所有命令都可以使用该别名。

这会触发 MSPbots 速率限制吗？

API 文档说明了速率限制，但没有公布具体数值。CLI 内置了 --rate-limit 限流功能，export 使用 --max-pages 限制分页遍历，并会在达到上限时报告；历史查询（trend、diff）完全基于本地快照运行——采集完成后不会再调用 API。

它既支持 widget，也支持数据集吗？

支持——pull、export、snapshot、describe 和 registry add 都接受 --type widget。API 文档中有一项例外：带有 measure 或 calculate 层的 widget 不受 Public API 本身支持。

费用是多少？

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

安全模型

层级	示例	建议的 Agent 策略
读取（实时 API）	mspbots-cli pull、export、describe、dataset、widget、doctor	允许
仅限本地写入（绝不接触租户）	mspbots-cli registry add、snapshot、sync——所有写入都保存在本地 SQLite 存储中；API 没有写入端点	允许——可安全地设为定时任务
凭据／本地配置	mspbots-cli auth set-token、auth logout、registry rm	仅限人工参与

最有力的控制措施是你授予 MSPbots 凭据的权限范围——CLI 只能执行这些凭据获准执行的操作。有关完整详情（包括如何锁定权限），请参阅 governance.md。

状态

Beta。已根据 MSPbots 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-05。