Atera MCP

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

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

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

涵盖每个 Atera RMM + PSA 端点，还提供本地 SQLite 镜像，可回答单次 API 调用无法解答的资产群健康状况、SLA 和业务组合问题。兼容你已在使用的 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	如何安装 Atera Skill
Claude Desktop	运行安装程序，然后转到 Settings > Extensions 注册 atera-mcp（无需编辑 JSON）。
ChatGPT（付费方案）	在此连接器重新发布前暂停：ChatGPT 需要使用其 HTTP 模式，而此版本的该模式无需密码，会监听所有网络接口，并且你打开的网页可以访问它。请参阅 mcp-install.md 中的安全说明。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 atera-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 上启动。每个工具都会调用配套的 atera-cli。从 2026-09-18 起发布的版本会在安装包内附带该 CLI；较早的安装包只包含 MCP 服务，因此如果你的安装包缺少配套 CLI，请先运行下方的路径 A 或路径 B 安装程序（或将 ATERA_CLI_PATH 设置为现有二进制文件的路径）。详情请参阅 #331。

下载 Atera MCP（.mcpb）——然后打开 Claude Desktop > Settings > Extensions 并选择该文件。点击一次，无需 JSON，也无需 shell。（前往发布页面浏览所有 Atera 版本。）

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

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

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

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

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

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

atera-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

Claude Desktop .mcpb 用户：下载最新的 .mcpb（位于本节顶部），并在 Settings > Extensions 中重新选择该文件。Claude Code 插件用户：运行 /plugin update atera@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 配置块见 mcp-install.md。

为 Hermes 安装

在 Hermes CLI 中：

hermes skills install servosity/msp-skills/skills/atera --force

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/atera --force

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

为 OpenClaw 安装

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

从 https://github.com/servosity/msp-skills/tree/main/skills/atera 安装 atera 技能。该技能定义了如何通过 openclaw: 前置元数据块安装其所需的 CLI（atera-cli）。

OpenClaw 目前尚未普遍开放；前置元数据配置已预先提供，并将在 OpenClaw 发布时立即启用。

身份验证

在 Atera 门户的 Admin → API 下创建 API 密钥，然后设置密钥并确认其可用：

ATERA_API_KEY=<your-key> atera-cli doctor

doctor 会在你运行任何会操作数据的命令之前，确认凭据有效且 API 可访问。即使凭据遭拒，它也会以状态码 0 退出，因此脚本应添加 --fail-on error。你也可以使用 atera-cli auth set-token 持久保存密钥。

此技能的功能

MSP 经常提出的问题	命令
哪些 Agent 已离线或停止报告状态？	atera-cli agents stale --days 30
哪些未结工单最接近违反 SLA？	atera-cli tickets sla
当前服务台哪些人的工作负荷过重？	atera-cli tickets workload
哪些客户拥有受管 Agent，却没有有效合同？	atera-cli customers coverage
未来 60 天内有哪些合同到期？	atera-cli contracts expiring --days 60
按客户和合同组合划分的完整业务情况是什么？	atera-cli customers book
哪些长期存在问题的设备产生了最多警报？	atera-cli agents noisy --days 7
整个设备群的补丁合规情况如何？	atera-cli agents patch-status
哪些设备运行的是已停止支持的操作系统？	atera-cli agents inventory --eol
自昨天以来，Agent、工单和警报有哪些变化？	atera-cli since 24h

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

与众不同之处

大多数 Atera 集成和 MCP 服务都会将每个问题转发为实时 API 调用。查询单条记录时，这种方式没问题；但在规模扩大后就难以胜任，例如要回答“所有 40 个客户中，哪些客户拥有受管 Agent，却没有有效合同”或“哪些项目即将违反 SLA”。

此技能会将 Atera 同步到带全文搜索的本地 SQLite 镜像中。汇总类问题只需执行一次本地 SQL 联接：响应即时、无需联网，而且 AI 看到的是答案，而非原始数据。customers coverage、customers book 和 agents noisy 等组合命令会联接客户、合同、Agent 和警报数据——无状态 API 封装器无法做到这一点。

此工具解决的痛点

在 G2 和 Capterra 的评价中，Atera 的报告功能一直饱受诟病：自定义报告需要各种变通方法，筛选功能死板，导出操作繁琐，而更深入的跨客户端分析则要升级到更高等级的套餐才能使用。它没有一个页面能同时回答所有客户端的“哪些机器停止了报告”“哪些工单即将违反 SLA”或“哪些客户的合同覆盖不足”等问题——你只能手动拼凑，逐个切换门户标签页。

此工具通过对本地镜像离线执行跨客户端汇总来弥补这一空白：

• atera-cli agents stale --days 30 - 在客户端打电话之前，找出那些悄然停止报告的机器。
• atera-cli tickets sla - 按距离违反 SLA 的分钟数排序待处理工单，最紧急的排在最前。
• atera-cli customers coverage - 找出由你管理却没有向你付费的客户：有受管 Agent，但没有有效合同。
• atera-cli contracts expiring --days 60 - Atera 从未提供统一视图的续约日历。
• atera-cli agents patch-status - 汇总整个设备群缺少的补丁；API 没有提供对应的单一端点。

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

常见问题

可以与 ChatGPT 配合使用吗？

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

我的 Atera 数据安全吗？

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

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

很少。大多数问题会在一次性执行 sync 后通过本地 SQLite 镜像处理，因此不会发出任何 API 调用。少数获取实时数据的命令（例如 agents patch-status）会控制请求频率，低于 Atera 每分钟 700 次请求的限制。

我必须是 Atera 合作伙伴吗？

不需要。你只需拥有 Atera 帐户，并在 Admin → API 下创建 API 密钥。任何开放 API 的套餐都适用；这里的功能不要求特殊的合作伙伴等级。

这会取代我的 Atera 门户吗？

不会——它是对门户的补充。门户仍是你的记录系统和远程访问控制台；此工具增加了门户所不具备的跨客户端、终端与 AI 查询层。

费用是多少？

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

安全模型

层级	示例	推荐的 Agent 策略
读取	agents stale、tickets sla、customers coverage、contracts expiring、since、search、sync、所有 get-/rollup 命令	允许
写入（常规）	tickets post/put、contacts post/put、customers post/put、contracts post/update、alerts post/resolve、devices create-*、customvalues set-*、import	使用 --dry-run 预览，然后进行经过审核的写入
破坏性操作 / 配置	agents delete、tickets delete、customers delete、devices delete-* 以及凭据变更（auth set-token、auth setup、auth logout）	仅限人工参与

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

状态

Beta 版。已根据 Atera API 功能范围完成验证，目前正通过每周 Build Sessions，与在自己的生产租户中运行该工具的 MSP 一起进行验证。请在 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。