Liongard MCP

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

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

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

覆盖 Liongard 的所有端点，还能离线保存整个 MSP 资产环境的副本，让你通过一条命令进行关联、搜索和漂移检查。可与您已在使用的 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	如何安装 Liongard skill
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 liongard-mcp（无需编辑 JSON）。
ChatGPT（付费套餐）	此连接器重新发布前暂停：ChatGPT 需要 HTTP 模式，而此版本的该模式无需密码，会监听所有网络接口，并且你打开的网页可以访问它。请参阅 mcp-install.md 中的安全说明。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 liongard-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，然后运行每个 Skill 的安装程序来安装 CLI/MCP 二进制文件）。请参阅 docs/which-agent.md。

60 秒内完成安装

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

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

下载 Liongard MCP (.mcpb)——然后打开 Claude Desktop > Settings > Extensions 并选择该文件。单击即可完成，无需 JSON 或 shell。（可在发布页面查看所有 Liongard 版本。）

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

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

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

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

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

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

liongard-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

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

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/liongard --force

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

为 OpenClaw 安装

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

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

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

身份验证

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

LIONGARD_INSTANCE=<your-subdomain> LIONGARD_API_KEY=<value> liongard-cli doctor

• LIONGARD_INSTANCE（必填）是你的 Liongard 子域名，也就是 https://acme.app.liongard.com 中的 acme。它用于构建 API URL；如果未设置， CLI 会回退到占位值 example.app.liongard.com，这将无法访问你的数据，因此请务必设置。 （高级用法：改为设置 LIONGARD_BASE_URL，指向完整的自定义 URL。）

• 凭据（必填）有两种形式，你只能设置其中一种。可以设置 LIONGARD_API_KEY，即预先编码为 base64 的 X-ROAR-API-KEY（见上方一行）；也可以设置 LIONGARD_ACCESS_KEY_ID + LIONGARD_ACCESS_KEY_SECRET 这一对值， 也就是 Liongard 提供给你的两个字符串，CLI 会为你进行编码：

  LIONGARD_INSTANCE=<your-subdomain> LIONGARD_ACCESS_KEY_ID=<value> LIONGARD_ACCESS_KEY_SECRET=<value> liongard-cli doctor
  

  请勿同时设置两种形式：只要 LIONGARD_API_KEY 非空，就会优先使用它，并忽略 ID/密钥对。

• LIONGARD_ENDPOINTS_API_KEY（可选）仅在使用 Liongard Endpoints API 时才需要；如果你不使用该 API，请保持未设置。

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

此技能的功能

先运行一次 liongard-cli sync——以下跨资产命令（drift、health、coverage、过期/离线/失败汇总以及 metrics pivot）会读取本地镜像，因此在首次同步填充镜像前，返回结果都为空。

MSP 经常提出的问题	命令
过去 24 小时内，我所有客户的环境发生了哪些变化？	liongard-cli drift --since 24h
哪些收集器（launchpoints）已过期？	liongard-cli launchpoints stale --older-than 7d
哪些 Agent 已离线？它们服务于谁的环境？	liongard-cli agents offline
给我一份覆盖整个资产的健康评分卡。	liongard-cli health --agent
用一条命令查看某个客户的完整情况。	liongard-cli environments overview 42
整个资产中有哪些检查失败或出错？	liongard-cli detections failures --since 7d
提取每个系统中的一项指标，生成可用于报告的 CSV。	liongard-cli metrics pivot "MFA Enabled Count" --csv
哪些系统超出阈值（例如补丁已超过 30 天未更新）？	liongard-cli metrics breach "Patch Age Days" --op gt --value 30
哪些地方存在监控盲区？	liongard-cli coverage
哪些环境仍缺少指定的检查器？	liongard-cli inspectors coverage --inspector "Microsoft 365"

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

有何不同

大多数 Liongard 集成和 MCP 服务都会将每个问题转发为实时 API 调用。查询一条记录还可以。但当你要问“本周所有 40 个客户有哪些变化”或“我的 600 个 launchpoint 中，哪些已过期”时，就难以应付了——这类问题需要调用数十次分页 API。

此技能会将 Liongard 同步到带有全文搜索功能的本地 SQLite 镜像中。聚合查询只需执行一次本地 SQL 联接：即时、离线，而且 AI 看到的是答案，而不是原始数据。drift、health 和 metrics pivot 等复合命令可以一次性联接环境、系统、launchpoint、Agent 和检测数据——无状态 API 包装器无法做到这一点。

解决的痛点

Liongard 是 MSP 技术栈中数据最丰富的工具之一，也是最难转化为实际价值的工具之一。r/msp 讨论串中反复出现的主题都一样：它收集了海量配置和变更数据，但这些价值都被锁在逐个点击环境的操作中。两个痛点一再出现：

• 悄然失效。 launchpoint 过期或 Agent 离线后，就会停止收集数据。没人会注意到，直到季度业务回顾（QBR）或审计需要这些数据时，才发现“文档”早已悄然过时。liongard-cli launchpoints stale 和 liongard-cli agents offline 可用一条命令呈现整个资产中的相关情况。
• 报告依赖手动操作。 要查看每个系统的一项指标，或整个资产中所有失败的检查，就得逐个点击环境，或者编写一次性 API 脚本。liongard-cli metrics pivot、liongard-cli detections failures 和 liongard-cli health 只需一行命令即可给出答案。

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

常见问题

这能与 ChatGPT 配合使用吗？

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

我的 Liongard 数据安全吗？

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

我需要是 Liongard 客户吗？这会触及我的 API 限额吗？

需要——你使用自己的 Liongard 实例和访问密钥，因此此技能只能访问你的凭据已获准访问的数据。由于它只会同步一次到本地镜像，并从镜像中回答大多数问题，因此相比每个问题都调用实时 API 的包装器，它发出的 API 请求少得多，在生成报告和准备 QBR 时也能轻松避开速率限制。

这会取代我的 Liongard 门户吗？

不会，它是对门户的补充。门户适合一次查看一个环境；而这项技能可以通过一条命令回答跨整个资产的问题（偏移、过期的采集器、离线的 Agent、覆盖缺口，以及每个系统中的同一指标），还可将结果通过管道传递到报告中，或交给你的 AI Agent。

费用是多少？

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

安全模型

层级	示例	建议的 Agent 策略
读取	drift、health、coverage、launchpoints stale、agents offline、detections failures、metrics pivot、search，以及所有 get/list/count 命令	允许
写入（常规）	environments create/update、launchpoints launchpoint/update/update-bulk、metrics create/update、users create/update、agents update、import，以及检查触发器（launchpoints run/bulk-run/run-stale、agents flush job-queue）	使用 --dry-run 预览，然后进行经审核的写入
破坏性操作 / 凭据	environments delete、launchpoints delete/bulk-delete、metrics delete、users delete、agents delete、access-keys create/delete，以及 authentication/auth 令牌命令	仅限人工参与

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

状态

Beta 版。已针对 Liongard API 功能进行验证。下一步是在每周 Build Sessions 中，由 MSP 使用自己的生产租户进行实时验证——请前往 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-06。