SuperOps MCP

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

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

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

在终端中使用所有 SuperOps PSA+RMM 实体，还可借助本地 SQLite 镜像回答 Web UI 无法解答的跨实体问题。兼容你已在使用的 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	如何安装 SuperOps skill
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 superops-mcp（无需编辑 JSON）。
ChatGPT（付费套餐）	在此连接器重新发布前暂停使用：ChatGPT 需要 HTTP 模式，而此版本的该模式无需密码，会监听所有网络接口，且你打开的网页可以访问它。参见 mcp-install.md 中的安全说明。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 superops-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。

原生支持技能的 Agent（也涵盖在内）： Hermes 和 OpenClaw 会直接读取此技能的 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，然后运行各技能的安装程序来安装 CLI／MCP 二进制文件）。请参阅 docs/which-agent.md。

60 秒内完成安装

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

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

下载 SuperOps MCP (.mcpb) - 然后打开 Claude Desktop > Settings > Extensions 并选择该文件。只需点一下，无需 JSON，也无需使用 shell。（请在发布页面查看所有 SuperOps 版本。）

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

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

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

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

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

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

superops-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

Claude Desktop .mcpb 用户：下载最新的 .mcpb（位于本节顶部），并在 Settings > Extensions 中重新选择。Claude Code 插件用户：/plugin update superops@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/superops --force

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/superops --force

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

为 OpenClaw 安装

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

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

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

身份验证

设置 CLI 所需的凭据——SuperOps API token（Settings > My Profile > API token）和你的租户子域名（Settings > MSP Information）：

export SUPEROPS_API_TOKEN=<your api token>
export SUPEROPS_SUBDOMAIN=<your tenant subdomain>   # sent as the CustomerSubDomain header
export SUPEROPS_REGION=us                            # or eu for euapi.superops.ai (us is the default)
superops-cli doctor

doctor 会在你运行任何会操作数据的命令前确认凭据是否有效。即使凭据被拒绝，它也会以状态码 0 退出，因此脚本应添加 --fail-on error。 你创建的 token 的权限范围就是权限边界——CLI 只能执行该 token 获准执行的操作。

此技能的功能

MSP 经常提出的问题	命令
哪些工单即将违反 SLA，按技术人员分组？	superops-cli sla-watch --by tech --window 4h
哪些客户端仍有未解决的警报？	superops-cli alert-coverage --client Acme
哪些端点缺少关键补丁且正处于活动警报状态？	superops-cli at-risk-assets --client Acme
哪些未结工单已有一周无人处理？	superops-cli stale-tickets --days 7
某个客户端的所有信息——站点、用户、合同、工单、资产、未结发票？	superops-cli client-360 "Acme Corp"
本月开票前，可计费工时集中在哪里？	superops-cli unbilled --since 2026-05-01
为分诊 Agent 提供包含工时记录、客户端和 SLA 的单个工单信息？	superops-cli context-ticket 12345 --agent
搜索所有已同步的工单、资产和客户端	superops-cli search "disk full"

除了这些视图：所有 SuperOps PSA+RMM 实体——工单、资产、警报、客户端、站点、用户、合同、发票、工时记录、技术人员、服务项目、IT 文档、知识库——都有带类型的 list/get 子命令，而 raw query 可以执行带类型的命令未封装的任何 GraphQL 读取操作。每条命令也都可作为 MCP 工具使用。

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

有何不同

大多数 SuperOps 集成和 MCP 服务都会将每个问题转发为实时 GraphQL 调用。对于单条记录来说，这没问题。但当你要查询“所有客户端中哪些未结工单即将违反 SLA，以及由谁负责处理”时，这种方式就难以胜任——API 会限制读取频率，而且列表负载甚至不包含该问题所需的一些跨实体关联。

此技能会将 SuperOps 同步到带有全文搜索的本地 SQLite 镜像中。聚合查询只需执行一次本地 SQL 联接：即时、离线，AI 看到的是答案，而不是原始数据。sla-watch、client-360 和 at-risk-assets 等复合命令会联接工单、SLA、技术人员、客户端、合同、资产、警报和发票——无状态 API 封装无法做到这一点。

解决的痛点

SuperOps 的卖点是用一个数据库同时管理 PSA 和 RMM——这一点确实如此。但控制台仍然一次只能回答一个实体的问题，而正如第三方评测者所说，该平台自带的 AI「更像路线图，而非现实」（Flamingo，《SuperOps Review for MSPs》，2026 年）。因此，你在月底或 QBR 前真正会问的问题，仍然是任何一个控制台页面都无法汇总回答的跨实体问题：哪些工单即将违反 SLA、由谁负责处理；某个客户有多少可计费工时尚未核对；哪些终端既未安装补丁，又正在触发警报。GraphQL API 让自行实现更加麻烦——它会限制读取频率，还缺少回答这些问题所需的一些关联数据（资产与工单的关联、聚合后的子活动时间戳），因此任何脚本都必须在本地获取、缓存并关联数据。

此技能的解决方式：

• superops-cli sla-watch --by tech --window 4h——列出所有已超时或即将超过解决 SLA 的未结工单，并按技术人员分组。用于调度人员的晨间分诊。
• superops-cli client-360 "Acme Corp"——将客户及其站点、用户、合同、未结工单、资产和未结发票打包展示。用一条命令查看原本需要打开六个控制台标签页才能看到的信息。
• superops-cli at-risk-assets --client Acme——找出补丁状态显示缺少关键补丁、且同时存在未解决警报的终端。按优先级安排修复。
• superops-cli unbilled --since 2026-05-01——按客户汇总已记录的可计费工时（即对账目标），让你在开具发票前了解可计费时间集中在哪些客户。

首次运行时，sync 会将你的租户数据拉取到本地 SQLite；之后，这些视图便可离线运行，响应即时，且不受频率限制。

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

已知不足（如实说明限制）

这些视图根据 SuperOps 列表 API 实际提供的数据计算而来，CLI 对其使用的代理指标也会如实说明：

• unbilled 显示每位客户已记录的可计费时间，而非严格的「工时记录减去发票」差额——API 不提供每条记录是否「已开票」的标记。
• at-risk-assets 和 alert-coverage 使用未解决警报作为「当前正在造成问题」的代理指标，因为列表数据中没有资产与工单的关联信息。
• context-ticket 会打包同步后的工单、工时记录、客户和 SLA；对话及备注线程则通过 superops-cli tickets <id> 实时获取。

常见问题

这能与 ChatGPT 配合使用吗？

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

我的 SuperOps 数据安全吗？

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

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

本地镜像的作用是让读取操作不再调用 API。首次执行 sync 后，跨实体视图（sla-watch、client-360、at-risk-assets、alert-coverage、unbilled、stale-tickets）会在本地 SQLite 上运行，不会调用 API。实时调用遵守 --rate-limit 限流设置；sync 是增量且可恢复的，只会获取发生变化的内容，并会将令牌无法访问的资源视为警告，而非失败。

它支持美国和欧盟地区的 SuperOps 吗？

支持。默认使用美国主机；设置 SUPEROPS_REGION=eu 即可指向欧盟主机（euapi.superops.ai）。将租户子域名填入 SUPEROPS_SUBDOMAIN，CLI 会在每个请求中将其作为 CustomerSubDomain 标头发送。

它能创建或更新工单吗？

这些类型化命令按设计均为只读，用于检查、导出、同步和分析。唯一的写入途径是 raw mutation，它是用于执行类型化命令未封装操作的受支持扩展方式（例如 createTicket、updateTicket、resolveAlerts）。搭配 --dry-run 可预览确切的 GraphQL 请求，并确保有人参与审核。raw query 则是对应的只读方式。

它会取代我的 SuperOps 控制台吗？

不会，它的目标也不是如此。控制台仍最适合应用内工作流，例如派单、工时录入和开票。此技能可将租户数据提供给你现有的 AI Agent，并回答跨实体问题——汇总 PSA 和 RMM 数据，而目前没有任何单个控制台页面能做到这一点。

费用是多少？

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

安全模型

层级	示例	建议的 Agent 策略
读取	所有类型化命令 + raw query - sla-watch、client-360、at-risk-assets、alert-coverage、unbilled、stale-tickets、tickets list、assets list、search、sync	允许
写入（变更扩展途径）	raw mutation - 唯一的写入途径；用于执行只读类型化命令未涵盖的操作（createTicket、updateTicket、resolveAlerts）	使用 --dry-run 预览，再经审核后写入
破坏性操作	没有类型化的破坏性命令；删除操作必须通过 raw mutation 显式执行破坏性 GraphQL 操作	必须有人参与审核

所有类型化命令均为只读；二进制程序唯一能远程修改数据的途径是 raw mutation，而 --dry-run 会打印确切的 GraphQL 请求，但不会发送。请在 Agent 策略中设置把关流程：预览、展示请求、获取批准，然后执行。

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

状态

已在实际环境中验证。@AvlCompCo（MSP）已使用其生产租户进行确认（验证记录）。还有更多 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-06-05。