Auvik MCP

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

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

_{完整 Skill 页面 - 安装、使用效果、安全模型。}

将每个 Auvik 端点变成命令，还能提供 Auvik UI 和 API 无法给出的跨客户端答案。可与您已在使用的 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	如何安装 Auvik Skill
Claude Desktop	运行安装程序，然后通过 Settings > Extensions 注册 auvik-mcp（无需编辑 JSON）。
ChatGPT（付费套餐）	此连接器重新发布前暂停使用：ChatGPT 需要 HTTP 模式，而此版本的该模式无需密码保护，并且会监听所有网络接口。请参阅 mcp-install.md 中的安全提示。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 auvik-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 上启动。每个工具都会调用配套的 auvik-cli。2026-09-18 起发布的版本会将该 CLI 打包在安装包内；较早的安装包只包含 MCP 服务，因此如果你的安装包缺少配套 CLI，请先运行下面的路径 A 或路径 B 安装程序（或将 AUVIK_CLI_PATH 设置为现有二进制文件的路径）。详情： #331。

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

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

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

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

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

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

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

auvik-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

Claude Desktop .mcpb 用户：下载最新的 .mcpb（本节顶部），然后在 Settings > Extensions 中重新选择该文件。Claude Code 插件用户：/plugin update auvik@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 配置代码块（适用于偏好编辑 JSON 的用户）记录在 mcp-install.md 中。

为 Hermes 安装

在 Hermes CLI 中：

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

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/auvik --force

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

为 OpenClaw 安装

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

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

OpenClaw 尚未普遍开放；frontmatter 配置已预先提供，待 OpenClaw 发布后即可启用。

身份验证

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

AUVIK_USERNAME=<value> AUVIK_API_KEY=<value> auvik-cli doctor

doctor 会检查配置、路径和 API 连通性，然后通过一次经过身份验证的读取来验证凭据本身：如果凭据有效，会报告 valid；如果遭拒（HTTP 401），会报告 rejected (HTTP 401)；如果权限范围受限（HTTP 403），会报告 scope-limited (HTTP 403)；如果探测未到达能够检查凭据的端点，则会报告 not verified。即使凭据遭拒，它也会以退出代码 0 退出，因此脚本应添加 --fail-on error。

此技能的作用

MSP 一直在问的问题	命令
所有客户端中，哪些硬件已过支持期限？	auvik-cli eol --bucket expired
为季度业务回顾（QBR）演示文稿准备：未来 90 天内哪些设备将到期？	auvik-cli eol --within 90
哪些设备完全没有配置备份？	auvik-cli configuration audit --finding no_backup
自上次同步以来，整个设备群新增、更改或移除了哪些内容？	auvik-cli inventory diff --since 7d
哪些客户端的计费设备数量与其清单不一致？	auvik-cli usage reconcile --mismatch-only
Auvik 无法完整轮询哪些设备？哪个凭据验证失败？	auvik-cli device discovery-gaps --method snmp
哪些设备和客户端产生的告警噪声最多？	auvik-cli alert noise --since 30d --group-by client
哪些 SaaS 许可证无人使用？	auvik-cli asm shadow --finding unused_licenses

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

与众不同之处

大多数 Auvik 集成和 MCP 服务都会针对每个问题发起一次实时 API 调用。查询单条记录时这样做没问题。但在规模扩大时就行不通了，比如在季度业务回顾前一周，你要问“所有 40 个客户端中，哪些设备已过支持期限，其中哪些仍在保修期内”。

此技能会将 Auvik 同步到带有全文搜索的本地 SQLite 镜像中。聚合查询只需进行一次本地 SQL 联接：即时、离线，而且 AI 看到的是答案，而不是原始数据。eol、usage reconcile 和 changes 等复合命令会联接设备清单、生命周期和保修日期、计费使用记录、配置修订、实体审计记录及告警历史——这些工作是无状态 API 封装器无法完成的。

其中一个缺口是结构性的，而非便利性问题：Auvik 的 API 不会发出删除事件。filter[modifiedAfter] 只能显示新增和更改，因此退役设备会直接从列表响应中消失。只有保留自己此前的设备群视图，才能检测到移除；这正是 inventory diff --snapshot 记录的内容。

解决的痛点

Auvik 按可计费设备数量收费，而用于计算发票金额的数量只是屏幕上的一个数字。数量发生变化时，没有任何信息会告诉你是哪些设备导致了变化；实际处理方式也止步于工具所能提供的范围：导出数据，再手动计数。设备所有者向 Auvik 提出的各种问题都有同样的特点：数据是有的，但没有聚合结果。

• 发票争议。usage reconcile --mismatch-only 会将每个客户端的计费数量与同步后的清单并列显示，并列出差异双方对应的设备记录。
• 设备更新讨论。eol --within 90 会根据每台设备最早的支持终止日期、生命周期结束日期、销售终止日期和保修日期进行分类，一次涵盖所有客户端。
• 悄无声息的退役。inventory diff --since 7d 会报告已移除的设备，而 Auvik API 从不告知这些信息。
• 未备份的交换机。configuration audit --finding no_backup 会找出没有已存储配置备份、备份过期或未标记为正在运行的设备。
• 看不见的设备。device discovery-gaps 会将发现状态与凭据探测结果联接起来，因此“为什么无法轮询这台设备”只需一条命令，而不必查看三个界面。

更完整的说明请参阅 pain-point.md。

常见问题

这能与 ChatGPT 配合使用吗？

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

我的 Auvik 数据安全吗？

你的数据保留在自己的计算机上。CLI 和 MCP 服务都是本地二进制程序；除非你主动以 HTTP 模式启动 MCP 服务（使用 auvik-mcp --transport http 或 PP_MCP_TRANSPORT=http）以供远程 Agent 使用，否则 MCP 服务会通过 stdio 运行。请勿在当前版本中这样做：其 HTTP 模式无需密码即可访问，并会监听所有网络接口，因此在重新生成连接器之前，该模式已暂停（参见 mcp-install.md 中的安全说明）。SQLite 镜像存放在你用户帐户下的目录中。AI Agent 只能看到 CLI 返回的内容——通常是查询结果，而非原始批量数据。凭据从你的环境或 Agent 的配置中读取；MSP Skills 不会将凭据打包进此仓库，也不会将其传输到任何地方。

为什么需要同时提供用户名和 API 密钥？

Auvik 使用 HTTP Basic 进行身份验证：你的 Auvik 用户邮箱是用户名，API 密钥是密码。它不支持单令牌形式。你还需要选择正确的区域主机——AUVIK_BASE_URL 用于选择 us1、us2、eu1 等区域；如果指向错误的区域，就会返回与密钥错误完全相同的 401 错误。

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

基本不会，这正是使用镜像的目的。sync 负责读取数据；随后，八个跨客户端命令会从本地 SQLite 返回结果，完全不调用 API，因此再次提问不会产生任何上游开销。

这会取代 Auvik 门户吗？

不会。Auvik 仍用于查看实时网络状态和处理警报队列。此工具用于回答门户不便处理的问题：跨所有客户端，以及比较两个时间点的数据。

费用是多少？

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

安全模型

层级	示例	建议的 Agent 策略
读取	eol、configuration audit、inventory diff、usage reconcile、device discovery-gaps、alert noise、asm shadow、changes、sync、search、export、所有 list / get，以及所有 settings 和 stat SNMP-poller 命令（仅 GET，尽管看起来像设置命令）	允许
写入（常规）	alert dismiss-single 及其友好版本 alert dismiss——Auvik API 唯一支持的写入操作；将这两个名称都加入允许列表	使用 --dry-run 预览，然后执行经过审核的写入
凭据 / 安全	auth set-credentials（将凭据写入 CLI 的凭据文件）、auth logout	仅限人工参与
数据外传	在任何命令上使用 --deliver webhook:<url>（将该命令的输出 POST 到你指定的 URL）、feedback --send，以及当设置了 AUVIK_FEEDBACK_ENDPOINT 且 AUVIK_FEEDBACK_AUTO_SEND=true 时，直接运行 feedback——这对环境变量无需任何标志即可触发发送，因此两者都已设置时，将 feedback 加入仅限本地操作的允许列表并不安全（未设置 endpoint 时，feedback 只会写入本地文件）	仅限人工参与——webhook 接收端会将客户端数据传出设备

Auvik API 不提供删除或管理性写入操作，因此无需设置破坏性或管理层级的门禁。

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

状态

Beta 版，等待真实环境验证。命令界面根据 Auvik API 规范生成，跨客户端分析也已通过基于规范生成的测试固件进行单元测试，但目前尚无 MSP 在生产 Auvik 租户中运行此工具后提供完整闭环反馈，因此这里的任何内容都尚未经过真实 Auvik 响应的验证。如果你在自己的租户中运行它，可以通过「运行正常」表单将结果转化为徽章。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-08-15。