Sherweb MCP

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

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

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

涵盖 Sherweb Partner API 的所有功能，另有本地 SQLite 存储、离线分析，以及其他 Sherweb 工具都不具备的利润率／偏差／孤立项联查功能。可与您已在使用的 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	如何安装 Sherweb Skill
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 sherweb-mcp（无需编辑 JSON）。
ChatGPT（付费方案）	此连接器重新发布前暂停使用：ChatGPT 需要 HTTP 模式，而此版本的该模式无需密码，会监听所有网络接口，并且您打开的网页可以访问它。请参阅 mcp-install.md 中的安全提示。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 sherweb-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 上启动。每个工具都会调用配套的 sherweb-cli。2026-09-18 起发布的版本会将该 CLI 一并打包；较早版本的安装包只包含 MCP 服务。如果你的安装包缺少配套 CLI，请先运行下方的路径 A 或路径 B 安装程序（或将 SHERWEB_CLI_PATH 设置为现有二进制文件的路径）。详情：#331。

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

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

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

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

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

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

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

sherweb-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

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

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/sherweb --force

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

为 OpenClaw 安装

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

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

OpenClaw 目前尚未全面开放；frontmatter 配置已预先提供，OpenClaw 一经发布便会立即启用。

进行身份验证

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

SHERWEB_CLIENT_ID=<value> SHERWEB_CLIENT_SECRET=<value> SHERWEB_OAUTH_SCOPE=<value> SHERWEB_SUBSCRIPTION_KEY=<value> sherweb-cli doctor

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

此技能的功能

MSP 经常提出的问题	命令
本月每位客户的净利润是多少——应收款减去应付款？	sherweb-cli margin --month 2026-04
哪些客户的利润逐月下滑，可能导致账户转为负数？	sherweb-cli margin-trend --last 6
我正在为哪些有效订阅向 Sherweb 付款，却没有向客户收费？	sherweb-cli orphans
哪些按量计费的用量由我承担，却从未转嫁给客户？	sherweb-cli usage-leak
哪些订阅的付费席位数高于实际使用数？	sherweb-cli right-size
自上次同步以来，我的应付款项有哪些变化？	sherweb-cli drift
本月我的全部客户账目中，新增、取消或调整了哪些项目？	sherweb-cli sub-changes --since 30d
我在所有客户处总共持有各产品的多少个席位？	sherweb-cli fleet-subs --product "Microsoft 365"
提交变更前，调整席位数量会产生多少费用？	sherweb-cli amend-preview --sub "SUB123" --qty 25

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

有何不同

大多数 Sherweb 集成和 MCP 服务都会将每个问题转发为一次实时 API 调用。查询单条记录时，这种方式没问题；但规模一大就行不通了。例如，当你询问“本月 80 位客户的净利润总额是多少”时，答案需要将分销商账单端点与每位客户的应收费用、订阅和用量逐一拼接起来。

此技能会将 Sherweb 同步到带有全文搜索的本地 SQLite 镜像中。汇总类问题只需执行一次本地 SQL 联接：响应迅速、无需联网，AI 看到的是答案，而非原始数据。margin、orphans 和 usage-leak 等复合命令会联接应付费用、应收费用、订阅和按量计费用量——这是无状态 API 封装无法完成的。

要解决的痛点

Sherweb Partner API 将账单分散在两个界面：Distributor API 返回应付款费用（即你欠 Sherweb 的款项），而 Service Provider API 返回应收款费用和订阅（即你向客户收取的费用）。门户中没有页面能将两者整合起来，因此每到结账时，都得在电子表格中手动重新计算每位客户的净利润。r/msp 中常见的情况是“许可证泛滥”——客户缩减规模后，Sherweb 端的订阅仍保持活动状态，你却继续为那些从未向客户转收费的席位付款。此技能通过你同步的镜像数据弥合这一差距：

• sherweb-cli margin - 按客户计算净利润（应收款减去应付款），并按利润最低优先排序。
• sherweb-cli orphans - 没有任何应收费用的活动订阅：你在为其付费，却从未向客户收费的席位。
• sherweb-cli usage-leak - 没有匹配应收费用的计量用量：由你承担的消耗。
• sherweb-cli right-size - 已付费席位数与计量得出的已用席位数不一致的订阅。
• sherweb-cli margin-trend --last 6 - 显示每位客户近期结账周期的利润变化，并按降幅最大优先排序。

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

常见问题

这能与 ChatGPT 配合使用吗？

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

我的 Sherweb 数据安全吗？

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

我需要成为 Sherweb 合作伙伴吗？它会使用哪些凭据？

需要——此工具会使用你自己的合作伙伴凭据，通过 composed authentication 访问 Sherweb Partner API。你需要一个带作用域的 OAuth2 客户端凭据 Client ID 和 Secret，用于获取 bearer token，另外还需要一个随每次调用一同发送的 APIM 网关订阅密钥。在 cumulus.sherweb.com 的 Security > APIs 中创建 OAuth2 应用并复制订阅密钥，然后设置 SHERWEB_CLIENT_ID、SHERWEB_CLIENT_SECRET、SHERWEB_OAUTH_SCOPE 和 SHERWEB_SUBSCRIPTION_KEY。凭据本身的权限才是真正的边界——请将作用域限制在你希望 AI 访问的范围内。

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

执行 deep-sync 后，分析命令（margin、margin-trend、orphans、usage-leak、right-size、drift、sub-changes、fleet-subs、amend-preview）会基于本地 SQLite 镜像运行，不会调用 API。实时调用会遵循 --rate-limit 限流设置；sync 支持断点续传和增量同步——只获取自上次检查点以来发生变化的数据。

这会取代 Sherweb 门户吗？

不会。配置、订购和订阅管理仍在门户中完成。此技能可以回答门户无法集中处理的跨实体利润率和账单问题——净利润率、孤立订阅、用量流失、席位数量优化——可在终端或 Agent 中使用。

费用是多少？

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

安全模型

层级	示例	建议的 Agent 策略
读取	margin、margin-trend、orphans、usage-leak、right-size、drift、sub-changes、fleet-subs、amend-preview、distributor，以及 service-provider list-* / get-* / validate-order 查询	允许
写入（常规）	service-provider amend-subscriptions（更改席位数量）、service-provider place-order（市场订单）、import（对每条记录发送 POST）——写入会立即发送；--dry-run 是可选的预览模式，并非默认行为	使用 --dry-run 预览，然后在审核后写入
破坏性操作 / 凭据	service-provider cancel-subscriptions（取消客户的订阅）；auth login / auth logout / auth set-token（更改凭据）	仅限人工参与

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

状态

Beta 版。已根据 Sherweb 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-06-06。