Cisco Meraki MCP

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

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

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

涵盖每项 Meraki Dashboard 操作，还提供读取所有页面的跨组织设备群视图，以及专为运营多个客户端组织的 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 工具 也可以使用您的凭据进行更改。如果您为远程 Agent 设置了隧道，请将其关闭。修复即将推出。

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

您的 AI Agent	Cisco Meraki Skill 的安装方法
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 cisco-meraki-mcp（无需编辑 JSON）。
ChatGPT（付费套餐）	在此连接器重新发布前暂停：ChatGPT 需要使用其 HTTP 模式，而此版本的该模式虽会检查令牌，但尚无请求大小或时限限制。参见 mcp-install.md 中的安全提示。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 cisco-meraki-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

下载 Cisco Meraki MCP (.mcpb)——然后打开 Claude Desktop > Settings > Extensions 并选择该文件。只需点击一次，无需 JSON，无需 Shell。（在发布页面浏览所有 Cisco Meraki 版本。）

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

/plugin marketplace add Servosity/msp-skills
/plugin install cisco-meraki@msp-skills

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

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

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

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

cisco-meraki-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

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

为 Hermes 安装

在 Hermes CLI 中：

hermes skills install servosity/msp-skills/skills/cisco-meraki --force

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/cisco-meraki --force

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

为 OpenClaw 安装

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

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

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

身份验证

生成 Dashboard API 密钥（Meraki Dashboard > My profile > API access）并设置该密钥：

export MERAKI_DASHBOARD_API_KEY=<your-api-key>
cisco-meraki-cli doctor
cisco-meraki-cli fleet health --limit 5

该密钥可以访问生成密钥的管理员所能看到的所有组织，并继承该管理员的权限——如果只需要生成报告，请使用只读管理员账号生成密钥。每个组织都需要启用 Dashboard API 访问权限（Organization > Settings）。doctor 会检查配置和连通性，并测试调用该密钥；请查看其 Credentials 行，因为即使密钥被拒绝，它也会以退出码 0 结束。在区域性 Dashboard 上，还需要设置 CISCO_MERAKI_BASE_URL（例如，加拿大使用 https://api.meraki.ca/api/v1）。

此技能的功能

MSP 常问的问题	命令
目前哪个客户组织的状况最糟？	cisco-meraki-cli fleet health --agent
所有组织中有哪些设备离线或正在告警？持续了多久？	cisco-meraki-cli fleet down --agent
哪些 MX WAN 上行链路发生故障？	cisco-meraki-cli fleet down --kind uplink --json
未来 90 天内有哪些许可证、订阅和支持终止日期到期？	cisco-meraki-cli fleet renewals --within 90d --agent
本周所有组织中，谁更改了什么？	cisco-meraki-cli fleet changes --since 7d --group-by admin --agent
这台设备离线前是否刚好有变更？	cisco-meraki-cli fleet blame "Q2QN-9J8L-SLPD" --window 2h --agent
这个 MAC、IP 或序列号属于哪个组织和网络？	cisco-meraki-cli fleet find "00:18:0a:12:34:56" --agent
哪些管理员未启用双重验证或访问权限已过期？离职技术人员在哪些地方仍有访问权限？	cisco-meraki-cli fleet admins --stale 90d --flagged --agent

除设备群组视图外，全部 1,035 项 Dashboard API 操作都已作为类型化命令提供，归属 organizations、networks、devices 和 administered 命令组；cisco-meraki-cli which "offline devices" 可以找到合适的命令。

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

有何不同

大多数 Meraki 集成和 MCP 服务都会把一个问题转发为针对一个组织的一次实时 API 调用，而且通常只读取列表的第一页。这对查询单条记录没问题。但到了 MSP 规模就行不通了：你要问的是“所有 30 个客户中，哪些出了问题，问题从什么时候开始？”

这项技能就是为回答这个问题而构建的。fleet 命令会在一个速率限制器下遍历密钥可访问的所有组织，跟进 Link 响应头中的每一页，并且绝不会把未能响应的组织算作零台设备：fleet health 会将其保留为无法访问的行，其他 fleet 命令则会在 stderr 中列出该组织。组合视图可以完成无状态封装器无法完成的联结：fleet down 将设备状态与组织和网络名称联结起来，并计算停机时长；fleet blame 会将每次中断与中断前刚做的配置更改对应起来；fleet renewals 则将三种授权模式与硬件终止支持日期合并成按日期排序的列表。fleet 视图会实时查询 Dashboard；sync 还会在本地 SQLite 镜像中保存组织级数据，因此 search "Acme" --data-source local、fleet find 和 fleet changes --data-source local 即使离线也能响应。通过 MCP 服务读取单个端点时，会提示 Meraki 是否还有更多页面（has_more，并提供可继续读取的游标；或者说明如何重新请求超出单次结果容量的页面）。

解决的痛点

Meraki 的 MSP Portal（现为 Global Overview 页面）会按 Meraki 的文档说明，列出每个客户组织的设备数量、许可证状态和一个共期限到期日期。文档并未说明如何跨组织列出故障设备、查看跨组织更改日志或跨组织管理管理员，因此，“现在每个客户那里都有什么问题？”仍意味着要逐个点击进入组织。编写脚本也会碰上 API 的设计限制：分页列表会以普通数组形式返回，只有 Link 响应头提供分页信息，因此只调用一次的脚本会悄无声息地停在第一页（Meraki Community Developers & APIs 论坛上就有“Using Powershell how to paginate thru pages”之类的讨论）。此外，每个组织的 API 速率限制为每秒 10 次调用。

• cisco-meraki-cli fleet down --agent - 早间故障分诊列表：所有离线或触发警报的设备和故障上行链路，并附网络名称和停机时长。
• cisco-meraki-cli fleet renewals --within 90d --agent - 汇总共期限、按设备和订阅组织的续订事项，以及即将终止支持的硬件。
• cisco-meraki-cli fleet blame "Q2QN-9J8L-SLPD" --window 2h --agent - 通过列出每次中断前刚做的更改，回答“是不是技术人员把它弄坏了？”
• cisco-meraki-cli fleet admins --email "[email protected]" --json - 列出仍授予已离职技术人员访问权限的所有组织。

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

常见问题

这能与 ChatGPT 配合使用吗？

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

我的 Cisco Meraki 数据安全吗？

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

API 密钥可以访问哪些内容？

Meraki API 密钥拥有生成该密钥的管理员帐户在其可见的所有组织中的 Dashboard 权限。如果你只需要报告，请使用具有只读访问权限的管理员帐户生成密钥。每个组织还必须启用 Dashboard API 访问权限（Organization > Settings）；未启用的组织会在 fleet health 中显示为 reachable: false，而不会消失。

这会触及 Meraki API 速率限制吗？

Meraki 允许每个组织每秒约 10 次调用。CLI 默认将请求速率控制在每秒 10 次（可通过 --rate-limit 更改）；当 Meraki 返回 HTTP 429 时，CLI 会等待 Retry-After 标头指定的时间后再重试。跨多个组织运行的 Fleet 命令耗时更长：每次运行都有一个总 --timeout（默认 1m），因此大型 Fleet 可调高此值（例如 --timeout 10m）。超时的组织会作为失败对象显示在 stderr 中，而不会被静默跳过。

它适用于加拿大、中国、印度或 FedRAMP Dashboard 吗？

适用。将 CISCO_MERAKI_BASE_URL 设置为所在地区的 API 主机：https://api.meraki.ca/api/v1（加拿大）、https://api.meraki.cn/api/v1（中国）、https://api.meraki.in/api/v1（印度）或 https://api.gov-meraki.com/api/v1（FedRAMP）。不设置时将使用全球 Dashboard。

Agent 会不会意外更改我客户的网络？

调用写入操作时会立即发送，不会提示确认，因此请让自主 Agent 只执行读取操作和 --dry-run 预览。批量工具 fleet push 默认会预览每个网络的差异，除非添加 --apply，否则不会发送任何内容。在 MCP 服务上设置 CISCO_MERAKI_MCP_READ_ONLY=1，即可直接拒绝所有写入操作。下方的安全模型说明了哪些命令应由人工把关。

费用是多少？

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

安全模型

等级	示例	建议的 Agent 策略
读取	fleet health、fleet down、fleet renewals、fleet changes、fleet find、fleet fanout（在包含密钥的路径上除外，包括 configurationChanges 和 apiRequests）、fleet admins、fleet flaps、fleet blame、不带 --apply 的 fleet push（当前凭据字段会显示为 [redacted]），以及除包含密钥的接口外的所有 GET 请求	允许
凭据（包括返回密钥的读取操作）	auth set-token、administered generate-identities-me-api-keys、管理员和 SAML 写入操作、organizations login-security update-organization（IP 范围和双重验证：可能导致所有管理员和 API 密钥被锁在外面）、organizations update（api.enabled=false 会使所有 API 密钥失效），以及返回有效密钥的读取操作：networks wireless get-network-ssids（Wi-Fi PSK）、networks wireless get-network-ssid-identity-psks、networks snmp get-network、organizations snmp get-organization、organizations appliance get-organization-vpn-third-party-vpnpeers、organizations sm get-organization-vpp-accounts（Apple VPP 令牌）、organizations configuration-changes get-organization（原始变更日志包含 API 请求正文；fleet changes 显示的是已脱敏视图）、organizations action-batches get-organization-action-batch（会返回每个已推送操作的正文）、networks webhooks get-network-payload-templates（标头模板可能包含 Authorization 值）、networks webhooks get-network-http-servers 和 organizations webhooks get-organization-logs、告警配置文件读取操作（例如 organizations alerts get-organization-profiles；传入 Webhook URL，或可编码该 URL 的 HTTP 服务器 ID，均属于凭据）、organizations api-requests get-organization（请求路径可能包含这些 ID）、许可证密钥读取操作（例如 organizations licenses get-organization），以及返回有时限链接的命令（organizations devices generate-organization-packet-capture-capture-download-url、devices camera generate-device-snapshot、devices camera clip-device、networks floor-plans get-network、organizations branding-policies get-organization，以及会回显此类链接的楼层平面图、品牌策略和自定义分析工件写入操作）	仅限人工参与——CLI 不会对这些读取操作进行脱敏；完整列表请参阅 governance.md
写入（常规）	networks update、networks wireless update-network-ssid、networks appliance update-network-vlan、devices update（删除任何内容、替换成员列表、更改可登录或调用 API 的人员，或影响电源、固件或连接状态的写入操作绝不属于常规操作；任何以 /bind、/move 或 /remove 等操作结尾的 POST 也不属于常规操作——请参阅 governance.md）	使用 --dry-run 预览，然后执行经过审核的写入操作
批量及会中断设备运行的操作	fleet push --apply、organizations action-batches create-organization-action-batch、networks devices vmx-network-claim、devices reboot device、devices switch cycle-device-ports、networks firmware-upgrades update-network、networks firmware-upgrades create-network-rollback、分阶段固件事件写入操作（networks firmware-upgrades create-network-staged-event 等）、devices sensor create-device-command（MT40 电源循环），以及 networks switch create-network-stack / add-network-stack（组成堆叠会重启交换机）	仅限人工参与
破坏性操作	所有删除操作、networks devices remove-network、organizations inventory release-from-organization、networks sm wipe-network-devices、networks switch update-network-stack（members 列表会替换整个堆叠）、organizations wireless create-organization-zigbee-disenrollment、所有 .../bulkDelete 和 .../batchDelete POST 请求	仅限人工参与，并需明确确认
最强的控制措施是API 密钥背后的 Dashboard 管理员——CLI 只能执行该管理员获准执行的操作，因此请使用只读管理员生成密钥。对于绝不应执行写入操作的 MCP Agent，还应设置 CISCO_MERAKI_MCP_READ_ONLY=1：此时，服务会拒绝所有非 GET 调用以及 fleet push --apply。包括如何锁定权限在内的完整详情，请参阅 governance.md。

状态

Beta 版。已根据 Cisco Meraki 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-10-13。