IT Glue MCP

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

非官方。由社区构建的 Claude Code Skill 和 IT Glue API 的 MCP 服务。 与 Kaseya US LLC 无关联，未获其认可或赞助。

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

涵盖 IT Glue 的每种资源，还提供离线 SQLite 镜像、跨资源的全局搜索，以及其他 IT Glue 工具都不具备的文档维护分析。可搭配你现有的 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	如何安装 IT Glue 技能
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 itglue-mcp（无需编辑 JSON）。
ChatGPT（付费套餐）	在此连接器重新发布前暂停：ChatGPT 需要 HTTP 模式，而此版本的该模式无需密码，会监听所有网络接口，并且你打开的网页可以访问它。参见 mcp-install.md 中的安全提示。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 itglue-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 上启动。每个工具都会调用配套的 itglue-cli。从 2026-09-18 起发布的版本会在安装包中附带该 CLI；较早版本的安装包只包含 MCP 服务，因此如果你的安装包缺少配套 CLI，请先运行下方的路径 A 或路径 B 安装程序（或将 ITGLUE_CLI_PATH 设置为现有二进制文件的路径）。详情：＃331。

下载 IT Glue MCP（.mcpb）——然后打开 Claude Desktop > 设置 > 扩展 并选择该文件。点击一次即可，无需 JSON 或 Shell。（在 releases 页面浏览所有 IT Glue 版本。）

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

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

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

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

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

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

itglue-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

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

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/itglue --force

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

为 OpenClaw 安装

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

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

OpenClaw 尚未全面推出；frontmatter 接入配置已预先提供，将在 OpenClaw 发布时立即启用。

身份验证

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

ITGLUE_API_KEY=<value> itglue-cli doctor

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

此技能的功能

MSP 经常提出的问题	命令
这台设备、这个序列号或这个联系人属于哪个客户端？	itglue-cli search "Fortinet"
哪些客户端的文档不够完善？从最不完善的开始列出。	itglue-cli coverage --below 1
按客户端列出哪些凭据已有一年未轮换？	itglue-cli passwords stale --days 365
自给定日期以来，所有客户端有哪些变更？	itglue-cli changes --since 2026-05-01
哪些联系人在多个客户端之间或同一客户端内重复？	itglue-cli contacts dupes
如何一次离线读取某个客户端的所有已知信息？	itglue-cli org show "12345"
客户端结束合作后，哪些记录成了孤立记录？	itglue-cli orphans
列出账户中的所有组织。	itglue-cli organizations list

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

有何不同

大多数 IT Glue 集成和 MCP 服务都会将每个问题转发为一次实时 API 调用。查询一条记录时这样做没问题；但规模扩大后就行不通了，例如你要问“我的 200 个客户端中，哪些缺少已记录的防火墙信息”或“整个设备群中，哪些凭据已有一年未轮换”——这类问题需要针对 IT Glue 发起数千次调用，而其速率上限为 5 分钟 3000 次，且每次只能处理一个组织和一项资源。

此技能会将 IT Glue 同步到带有全文搜索功能的本地 SQLite 镜像中。聚合查询只需执行一次本地 SQL 联接：响应即时、离线可用，AI 看到的是答案，而不是原始数据。coverage、passwords stale 和 orphans 等复合命令会跨组织、联系人、密码、配置和文档进行联接——无状态 API 封装器无法完成这类工作。

解决的痛点

IT Glue 是整个客户群的权威记录系统，但一次只显示一个组织。它没有内置的评分卡来显示哪些客户的文档不完整，因此文档缺失问题往往在发生故障或进行 QBR 时才暴露，而不是提前发现——保持 IT Glue 信息最新是 r/msp 上反复被提及的一项日常难题。凭据卫生状况更糟：SOC2 和网络保险审计会询问特权凭据最近一次轮换的时间，但 IT Glue 没有一个统一界面列出所有客户的过期密码，而且实时扫描会触及每 5 分钟 3000 个请求的 API 上限。更深层的问题是，API 没有提供“哪些联系人重复了”或“哪些记录指向已不存在的组织”这类查询接口——PSA 同步重叠和客户退订后留下的混乱便无从清理。

此技能可通过一条命令，从本地镜像中解答上述所有问题：

• itglue-cli coverage --below 1 - 找出缺少整个文档类别的客户，在 QBR 发现问题之前提前处理。
• itglue-cli passwords stale --days 365 - 列出所有超过轮换期限的凭据，按客户分组，仅显示元数据——满足审计所需。
• itglue-cli search "Fortinet" - 一次搜索所有已同步的组织，找出设备、联系人或序列号属于哪个客户。
• itglue-cli contacts dupes - 找出 PSA 同步重叠留下的重复联系人。
• itglue-cli orphans - 找出所属组织已不存在的配置、联系人、密码和文档。

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

常见问题

这适用于 ChatGPT 吗？

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

我的 IT Glue 数据安全吗？

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

我需要哪些凭据？

需要在 IT Glue 帐户设置中生成的 IT Glue API 密钥（Account > Settings > API Keys）。在环境中设置 ITGLUE_API_KEY，或运行 itglue-cli auth set-token。IT Glue API 密钥适用于整个帐户，而非单个用户：只有 Administrator 可以创建密钥，且该密钥可访问 IT Glue 帐户中的所有组织。IT Glue 提供的唯一密钥级限制是 Password Access 复选框——除非需要使用 passwords get/list，否则请勿勾选；勾选后，这些命令会返回已存储的机密。

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

IT Glue 的 API 速率限制约为 每 5 分钟 3000 次请求。本地镜像用于避免读取操作调用 API：首次运行 sync 后，search、coverage、passwords stale、changes、contacts dupes、org show 和 orphans 都会使用本地 SQLite，不会调用 API；同步是增量的，只会获取自上次检查点以来发生变化的内容。

它支持 IT Glue 的 EU 或 AU 数据区域吗？

支持。IT Glue 在区域 API 端点托管数据；将 ITGLUE_BASE_URL 设为所在区域的 API URL，CLI 就会使用该地址。默认目标为 US 端点。

它能删除我的文档吗？

不能。CLI 可以读取数据，也可以创建或更新联系人、密码、配置和文档——它不提供删除任何 IT Glue 资源的功能。coverage 和 passwords stale 审计仅读取元数据；不会读取或打印密码机密值。

费用是多少？

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

安全模型

层级	示例	建议的 Agent 策略
读取	search、coverage、passwords stale（仅元数据）、changes、contacts dupes、org show、orphans、organizations list/get、configurations/contacts/documents list/get	允许
写入（常规）	configurations create/update、contacts create/update、documents create/update、organizations relationships create-organization-contact	使用 --dry-run 预览，然后经审核后写入
凭据／敏感操作	passwords get 和 passwords list（如果 API 密钥具有密码访问权限，可能会返回已存储的机密）、passwords create、passwords update；CLI 不提供删除任何 IT Glue 资源的功能	仅限人工介入

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

状态

Beta 版。已针对 IT Glue 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。