用途:为 Meraki 环境提供只读的组织与网络运维查询,是其他 Meraki 技能的前置入口,因为后续操作都需要组织 ID 和网络 ID。
主要能力:通过 MCP 服务器(端点 https://mcp.meraki.com/mcp,远程 HTTP,无需本地安装;自托管备选 CiscoDevNet/cisco-meraki-mcp-official,Apache-2.0)调用。只有两个工具:semantic_search 用于发现能力,execute_api 用于调用。所有 431 个变更类操作(174 个 POST、186 个 PUT、71 个 DELETE)都不在能力目录中,仅内置未弃用的 GET,因此 updateNetwork、rebootDevice、blinkDeviceLeds 等会返回 Capability not found。不要尝试或提供写入操作,变更必须在 Meraki 仪表盘直接完成。
使用方式:需环境变量 MERAKI_DASHBOARD_API_KEY,建议使用只读仪表盘密钥。两个可直接调用的能力 ID:execute_api 调用 getOrganizations 获取组织 ID,再用 getOrganizationNetworks 配合 organizationId 获取网络 ID;其余能力先用 semantic_search 描述意图获取排序后的 capability_id,再调用 execute_api 并传入其必需参数。应发现而非猜测能力 ID。
结果解读:execute_api 只返回单页数据;在支持时应请求有限页大小,不要把单页当作完整数据集。空结果不等于不存在:n=0 只表示该网络未报告,而非确实没有。三类错误需区分:Capability not found(ID 为变更类、已弃用或不存在,改用 semantic_search);Resource not found(ID 有效但组织/网络/序列号不符,重新推导 ID);Invalid parameters(ID 有效但缺少必需参数,查看该能力的参数)。三者都不可报告为“无数据”。实测中某组织设备、库存、客户端、组策略均为 0,但拥有完整配置的四产品网络和 15 个 SSID——已配置网络也可能报告为空。应按实际计数(含零)先报告,并记录每次发现运行。productTypes 决定交接给 meraki-wireless-ops、meraki-switch-ops 或 meraki-security-appliance 哪个技能,不要对无相应产品的网络运行其工作流。限制:不含 ServiceNow CR 路径,因为无写入可管控。