Hudu MCP

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

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

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

包含所有 Hudu cmdlet，另有离线 SQLite 镜像、跨实体审计，以及 PowerShell 模块或只读 MCP 服务不具备的原生 Agent 输出。可与您已在使用的 AI 搭配使用 - 包括 ChatGPT（Plus/Pro+，通过托管 HTTPS 端点；请参阅 mcp-install.md）、Claude Desktop、Codex、Claude Code、Claude Cowork 和 GitHub Copilot，还可通过远程方式搭配 Microsoft 365 Copilot / Copilot Studio 和 Google Gemini。免费、开源，可在笔记本电脑上运行。专为 MSP 所有者打造。无需编写代码。

适用于您的 Agent

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

您的 AI Agent	如何安装 Hudu Skill
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 hudu-mcp（无需编辑 JSON）。
ChatGPT（付费方案）	运行安装程序，通过 HTTPS 和 bearer token 托管 hudu-mcp，并将其注册为 Developer Mode 连接器。请参阅 mcp-install.md。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 hudu-mcp，然后选择 Agent 模式。

ChatGPT 需要远程 HTTPS 服务，因此必须使用此连接器的 HTTP 模式：必须先设置 HUDU_MCP_HTTP_TOKEN 才能启动；每个请求都必须在 bearer 标头中发送该令牌；如果地址不是环回地址，还需要 --tls-cert 和 --tls-key。请参阅 mcp-install.md。

也适用于 Microsoft 和 Google 技术栈

这些平台的安装基数很大，但需要如实说明：它们采用的是远程 / 企业方式，而不是您刚安装的本地二进制文件。

Agent	所需条件
Microsoft 365 Copilot / Copilot Studio	通过 HTTPS 和 bearer token 托管 hudu-mcp（与 ChatGPT 使用相同的 HTTP 模式），然后在 Copilot Studio 中将其添加为 Model Context Protocol 工具。需要 Copilot Studio 许可证和租户管理员。请参阅 mcp-install.md。
Google Gemini	Gemini CLI 在本地运行 - 与 Claude Code 相同。Gemini app 通过远程方式运行，需要与 ChatGPT 相同的托管 HTTPS 端点。请参阅 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 上启动。每个工具都会调用配套的 hudu-cli。从 2026-09-18 起发布的版本会在安装包内包含该 CLI；较早的安装包只包含 MCP 服务，因此如果你的安装包缺少配套 CLI，请先运行下方的路径 A 或路径 B 安装程序（或者将 HUDU_CLI_PATH 设置为现有二进制文件的路径）。详情请见：#331。

下载 Hudu MCP（.mcpb） - 然后打开 Claude Desktop > Settings > Extensions 并选择该文件。一键完成，无需 JSON 或命令行。（在发布页面浏览所有 Hudu 版本。）

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

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

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

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

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

同一条提示词适用于任何能够运行 shell 的 Agent。

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

hudu-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

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

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/hudu --force

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

为 OpenClaw 安装

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

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

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

身份验证

设置 CLI 所需的凭据（从你的 Hudu 门户获取）。在 Admin -> API Keys 中创建密钥，并将 HUDU_BASE_URL 指向你实例的 /api/v1 URL：

HUDU_BASE_URL=https://<your-subdomain>.huducloud.com/api/v1 HUDU_API_KEY=<value> hudu-cli doctor

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

此技能的作用

运行一次 hudu-cli sync，在本地镜像您的实例，然后提出以下问题：

MSP 经常提出的问题	命令
哪些客户的文档完整度最差？	hudu-cli audit completeness --agent
所有客户中，未来 30 天内有哪些项目到期？	hudu-cli audit expirations --within 30d --agent
哪些密码库密码已过期，需要轮换？	hudu-cli audit stale-passwords --older-than 180d --agent
哪些知识库文章已经过时，很可能需要更新？	hudu-cli audit stale-articles --older-than 365d --agent
哪些资产与其布局的当前架构存在偏差？	hudu-cli audit layout-drift --agent
为我生成一份涵盖所有公司的卫生状况评分卡，并按最差项优先排序。	hudu-cli audit summary --agent
在所有已同步文档中查找包含某个关键词的内容。	hudu-cli search "vpn gateway" --agent
哪些 PSA/RMM 记录无法映射到现有的 Hudu 资产？	hudu-cli reconcile --agent
根据我们的标准模板，为新客户搭建文档框架。	hudu-cli onboard --company 42 --template msp-standard

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

与众不同之处

大多数 Hudu 集成和 MCP 服务都会将每个问题转发为一次实时 API 调用。查询单条记录时，这样没问题。但在规模扩大后就行不通了，例如在一轮业务回顾会（QBR）之前，您想知道“我的 50 个客户中，哪些客户的密码已过期、资产文档不完整，而且证书将在本月到期”。

此技能会将 Hudu 同步到本地 SQLite 镜像，并支持全文搜索。聚合类问题只需执行一次本地 SQL 联接：结果即时可得、无需联网，AI 看到的是答案，而不是原始数据。audit summary 和 audit completeness --cross-tenant 等复合命令会联接资产、布局、公司和密码库数据，并按最差项优先排列所有租户——这是无状态 API 包装器无法做到的。

解决的痛点

“我们的文档总是过时”是 r/msp 上最常见的抱怨之一：资产创建时，许多必填字段都空着；密码几年都不轮换；没人能同时监控所有租户的续订日期，导致证书过期。Hudu 存储着所有这些信息，但要回答“哪些地方出了问题？”，就得逐个点击查看公司；而 Hudu 本身根本没有密码过期跟踪功能。

此技能将这些常见问题分别转化为一条命令：

• hudu-cli audit completeness --agent - 按必填文档的实际填写完整度为客户排序。
• hudu-cli audit stale-passwords --older-than 180d --agent - 找出无人轮换的密码库凭据，并按公司分组（在本地计算；绝不显示、存储或缓存密码库密码和 OTP 密钥）。
• hudu-cli audit expirations --within 30d --agent - 以统一列表列出所有租户即将到期的 SSL、域名、保修和密码。
• hudu-cli audit summary --agent - 生成一份按最差项优先排列的卫生状况评分卡，帮助您确定应先处理哪个客户。

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

常见问题

支持 ChatGPT 吗？

支持 Plus、Pro、Team、Business、Enterprise 和 Education 计划（Free 计划目前尚不提供 Developer Mode）。ChatGPT 只能通过 HTTPS 连接远程 MCP 服务，因此您需要以 HTTP 模式托管 hudu-mcp：必须设置 HUDU_MCP_HTTP_TOKEN 才能启动；每个请求都必须在 bearer 请求头中发送此令牌；如果使用的地址不是 loopback 地址，还必须提供 --tls-cert 和 --tls-key。只有当连接器的身份验证设置能够发送该 bearer 令牌时，连接器才能正常工作，因此请先检查您的设置。分步说明请参阅 mcp-install.md。

这适用于 Codex、Cursor、Windsurf、Cline、Copilot 或 Gemini 吗？

适用——它们都支持 MCP。上方的对照表中提供了跨工具安装命令，详见 docs/which-agent.md。

我需要会编程吗？

不需要。推荐的安装方式是将一句话粘贴到 Claude Code 或 Codex 中——你的 Agent 会读取 SKILL.md 并完成安装。备用方式是每种操作系统各有一条安装命令（bash 或 PowerShell）。这两种方式都不需要编写代码。你只需输入一次 Hudu 凭据。

我的 Hudu 数据安全吗？

你的数据保留在自己的机器上。CLI 和 MCP 服务都是本地二进制文件。SQLite 镜像存放在你用户账户下的目录中。AI Agent 只能看到 CLI 返回的内容——通常是查询结果，而不是原始批量数据。保管库密码和 OTP 密钥绝不会显示、存储或缓存：CLI 仅保留每个保管库条目的元数据（名称、用户名、URL、文件夹、日期），如需获取密钥，请前往 Hudu 门户。密码类型资产字段的值也会以相同方式隐藏（读取时显示 [withheld: password field]），而保管库或资产请求出错时只会显示其 HTTP 状态。你的 Hudu API 密钥从 HUDU_API_KEY（你的环境或 Agent 配置）读取；如果你通过 auth set-token 保存，则从 CLI 数据目录中的 credentials.toml（仅所有者可访问）读取；MSP Skills 绝不会将其打包到此仓库中，也不会将其传输到任何地方。

公司范围的 Hudu API 密钥能用吗？

大部分情况下可以。审计和搜索会针对已同步的所有内容运行，因此任何密钥都能使用。唯一的限制是：Hudu 的全局资产列表端点需要全局密钥（而非公司范围的密钥）——使用范围受限的密钥时，请改用 hudu-cli assets list-by-company <company_id>。onboard --apply 写入操作也需要全局密钥。

这会取代 Hudu 门户吗？

不会。它是你现有 Web 应用的补充，后者仍用于编辑和日常文档管理。该技能会回答跨租户卫生状况问题，并将结果交给你的 AI Agent；你仍需使用 Hudu 的 UI 来创建内容和浏览。

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

此工具经过专门设计，旨在避免这种情况。hudu-cli sync 会将你的实例一次性拉取到本地 SQLite 镜像中（支持可恢复的增量同步），之后的每次审计、搜索和解析都会针对该镜像离线运行，因此重复提问不会产生任何 API 调用。

费用是多少？

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

安全模型

等级	示例	推荐的 Agent 策略
读取	audit completeness、audit stale-passwords、audit expirations、audit summary、search、resolve、reconcile、companies list、assets list-by-company、sync、doctor	允许
写入（常规）	assets create、assets update、articles create、articles update、companies create、companies update、asset-layouts create、onboard --apply	使用 --dry-run 预览，然后经审核后写入
销毁性操作／凭据操作	assets delete、articles delete、companies delete、asset-passwords delete、asset-passwords get、asset-passwords list、auth set-token、auth logout	仅限人工参与

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

状态

已在生产环境验证。@Xenith-B（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-06。