Cisco Meraki MCP

Cisco Meraki + AI - ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini、および MCP に対応するあらゆるエージェント向け

非公式です。Cisco Meraki API 用にコミュニティが開発した Claude Code スキルおよび 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 オーナー向けに構築されています。コードは不要です。

お使いのエージェントで利用できます

セキュリティに関する注意（このコネクターが再公開されるまで）。 HTTP モード (--transport http) は、localhost 上であっても実行しないでください。このビルドでは トークンを確認しますが、修正リリースで導入されたリクエストサイズと時間の制限が まだありません。また、MCP ツールはお客様の認証情報を使って変更を加えることもできます。 デフォルトの stdio トランスポートを使用してください。リモートエージェント用に トンネルを設定している場合は、停止してください。修正版は近日公開予定です。

MSP オーナーが実際に使用する 6 つのエージェント（セルフサービスで、今すぐ利用できます）：

お使いの AI エージェント	Cisco Meraki スキルのインストール方法
Claude Desktop	インストーラーを実行し、Settings > Extensions で cisco-meraki-mcp を登録します（JSON の編集は不要です）。
ChatGPT（有料プラン）	このコネクターが再公開されるまで一時停止中です。ChatGPT には HTTP モードが必要ですが、このビルドではトークンを確認する一方、リクエストサイズと時間の制限がまだありません。mcp-install.md のセキュリティに関する注意を参照してください。
Codex CLI	下記のインストール用プロンプトを貼り付けます。
Claude Code	下記のインストール用プロンプトを貼り付けます。
Claude Cowork	下記のインストール用プロンプトを貼り付けます。
GitHub Copilot（VS Code）	インストーラーを実行し、servers キーの下にある mcp.json に cisco-meraki-mcp を追加してから、Agent モードを選択します。

ChatGPT にはリモート HTTPS サーバーが必要です。つまり、このコネクターの HTTP モードが必要ですが、コネクターが再公開されるまで一時停止中です。このビルドではトークンを確認する一方、リクエストサイズと時間の制限がまだありません。mcp-install.md のセキュリティに関する注意を参照してください。

Microsoft と Google のスタック向けにも

大規模な導入実績がありますが、率直にお伝えすると、これらはリモート／エンタープライズ向けの方法であり、先ほどインストールしたローカルバイナリを使う方法ではありません。

エージェント	必要なもの
Microsoft 365 Copilot / Copilot Studio	このコネクターを再発行するまで一時停止中です。Copilot Studio では HTTP モードが必要ですが、このビルドでは、そのモードはトークンを確認するものの、リクエストサイズや時間の制限がまだありません。mcp-install.md のセキュリティに関する注意事項をご覧ください。
Google Gemini	Gemini CLI はローカルで動作し、Claude Code と同じです。Gemini アプリはリモートで動作するため、ChatGPT と同じく一時停止中の HTTP モードが必要です。mcp-install.md をご覧ください。

スキルネイティブのエージェント（こちらも対応）： Hermes と OpenClaw は、このスキルの SKILL.md を直接読み込み、MCP にも対応しています。以下のインストール手順をご覧ください。Cursor、Windsurf、Cline、Continue.dev、Zed でも MCP 経由で動作します。ツールごとの設定方法については、docs/which-agent.md をご覧ください。

複数のエージェントを使っていますか？ 1 つのコマンドで、対応している 51 以上のエージェントすべてにインストールできます：npx skills add Servosity/msp-skills@latest（Node.js が必要です。その後、CLI／MCP バイナリ用のスキル別インストーラーを実行してください）。docs/which-agent.md をご覧ください。

60 秒でインストール

Claude Desktop で最も簡単な方法 - ワンクリックの .mcpb

Cisco Meraki MCP（.mcpb）をダウンロードしてから、Claude Desktop > Settings > Extensions を開き、ファイルを選択します。ワンクリックで完了し、JSON もシェルも不要です。（Cisco Meraki のすべてのリリースはリリースページでご覧いただけます。）

Claude Code プラグインを使いたい場合は、マーケットプレイスを一度追加してからインストールしてください。すぐに使え、ディレクトリ一覧の確認は不要です。

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

方法 A - AI エージェントにプロンプトを 1 つ貼り付ける（推奨）

これを Claude Code、Codex CLI、または Claude Cowork にコピーします：

このエージェントのワークスペースに、Servosity/msp-skills から Cisco Meraki Skill と MCP サーバーをインストールしてください。このワークスペースで POSIX シェル（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 を実行して内容を確認してください。

シェルを実行できるエージェントであれば、同じプロンプトを使えます。

方法 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 を通じてスキルを検出します。

確認：

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 クライアントに追加する

インストーラーの実行後、エージェントごとの設定方法（GitHub Copilot の servers キーや、Microsoft 365 Copilot／Copilot Studio のリモート向け手順を含む）については、mcp-install.md と docs/which-agent.md をご覧ください。エージェントごとにセクションが分かれています。Claude Desktop では、Settings > Extensions パネルを使うのが最も簡単です。JSON の編集を希望する方向けの MCP 設定ブロックは、mcp-install.md に記載されています。

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 エージェントに次の内容を伝えてください（コピーして使用できます）。

https://github.com/servosity/msp-skills/tree/main/skills/cisco-meraki から cisco-meraki スキルをインストールしてください。このスキルでは、必要な CLI（cisco-meraki-cli）のインストール方法を openclaw: フロントマターブロックで定義しています。

OpenClaw はまだ一般公開されていません。フロントマターの連携設定はあらかじめ含まれており、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 は設定と接続状況を確認し、キーをテスト呼び出しします。キーが拒否されても終了コードは 0 になるため、Credentials の行を確認してください。地域別のダッシュボードを使用する場合は、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

フリートビューに加えて、Dashboard API の全 1,035 件の操作が、organizations、networks、devices、administered の下に型付きコマンドとして用意されています。cisco-meraki-cli which "offline devices" を使うと、適切なコマンドが見つかります。

コマンドの完全なリファレンスは guide.md をご覧ください。AI エージェントの操作契約（--agent、--dry-run、変更を適用する前に確認すべきタイミング）については、AGENTS.md をご覧ください。

これが他と異なる点

ほとんどの Meraki 統合機能や MCP サーバーは、1つの質問を1つの組織に対する1回のライブ API 呼び出しに中継し、多くの場合、リストの最初のページしか読み取りません。1件のレコードなら問題ありません。しかし、「30社すべてについて、何が停止していて、いつからなのか？」と尋ねる MSP 規模では通用しません。

このスキルは、その質問に答えるために作られています。fleet コマンドは、1つのレート制限のもとでキーからアクセスできるすべての組織を対象に実行され、Link ヘッダーのすべてのページをたどります。また、応答に失敗した組織をデバイス数ゼロとして数えることはありません。fleet health では到達不能な組織も行として残し、その他の fleet コマンドではその組織名を stderr に出力します。複合ビューでは、ステートレスなラッパーでは実現できない結合を行います。fleet down はデバイスのステータスを組織名とネットワーク名に結合してダウンタイムを算出し、fleet blame は各障害とその直前に行われた設定変更を照合し、fleet renewals は3種類のライセンスモデルとハードウェアのサポート終了日を、日付順の1つのリストにまとめます。fleet ビューは Dashboard にライブで問い合わせます。sync は組織レベルのデータのローカル SQLite ミラーも保持するため、search "Acme" --data-source local、fleet find、fleet changes --data-source local はオフラインでも応答できます。MCP サーバー経由で単一エンドポイントを読み取ると、Meraki にさらにページがある場合（has_more と再開用カーソル、または1つの結果に収まらない大きさのページを再リクエストする方法）が通知されます。

解決する課題

Meraki の MSP Portal（現在の Global Overview ページ）には、Meraki のドキュメントにあるとおり、各クライアント組織のデバイス数、ライセンスのステータス、co-term の有効期限が一覧表示されます。しかし、組織をまたいで停止中のデバイスを一覧表示する方法、組織をまたぐ変更ログ、組織横断の管理者管理については記載されていません。そのため、「今、すべてのクライアントで何が壊れているのか？」を知るには、依然として各組織をクリックして調べる必要があります。スクリプトで対処しようとしても、API の構造が障壁になります。ページ分割されたリストは、Link ヘッダーだけでページを指定する配列として返されるため、1回の呼び出しだけを行うスクリプトは気付かないうちに最初のページで止まってしまいます（Meraki Community Developers & APIs の掲示板には、まさにこの問題を扱う「Using Powershell how to paginate thru pages」のようなスレッドがあります）。さらに、すべての処理に組織ごとに毎秒10回までというレート制限があります。

• cisco-meraki-cli fleet down --agent — 朝のトリアージリストです。オフラインまたはアラート中のすべてのデバイスとアップリンクの障害を、ネットワーク名とダウンタイムとともに表示します。
• cisco-meraki-cli fleet renewals --within 90d --agent — co-term、デバイスごとのライセンス、サブスクリプション型の組織に加え、サポート終了が近いハードウェアを含む更新パイプラインです。
• 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 サーバーのみです。つまり、Cisco Meraki MCP サーバーを HTTP モードで実行する必要があります。このビルドの HTTP モードではトークンの確認は行いますが、リクエストサイズや時間の制限はまだありません。そのため、コネクターが再公開されるまでは実行したり、トンネルの背後に配置したりしないでください。その理由については、mcp-install.md のセキュリティに関する注意事項で説明しています。それまでは Claude Desktop、Claude Code、または Codex を使用してください。

Codex、Cursor、Windsurf、Cline、Copilot、Gemini で動作しますか？

はい。いずれも MCP に対応しています。ツール横断のインストールコマンドは上の表に、詳しい説明は docs/which-agent.md にあります。

コーディングの知識は必要ですか？

いいえ。推奨されるインストール方法は、Claude Code または Codex に1文を貼り付けることです。エージェントが SKILL.md を読み込み、インストールを実行します。別の方法として、OS ごとの1行インストーラー（bash または PowerShell）も利用できます。どちらの方法でも、コードを書く必要はありません。Cisco Meraki の認証情報を一度入力します。

Cisco Meraki のデータは安全ですか？

データはお使いのマシンにとどまります。CLI と MCP サーバーはローカルバイナリです。SQLite ミラーは、ユーザーアカウント内のディレクトリに保存されます。AI エージェントが参照するのは CLI が返す情報だけで、通常はクエリ結果であり、生の一括データではありません。認証情報は環境またはエージェントの設定から読み込まれ、このリポジトリに含まれたり、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 を返した場合は、Retry-After ヘッダーで指定された時間だけ待ってから再試行します。多数の組織を対象とするフリートコマンドは、より時間がかかります。各実行には全体の --timeout（既定値は1m）が設定されているため、大規模なフリートでは（たとえば --timeout 10m のように）値を大きくしてください。時間切れになった組織は、黙って除外されるのではなく、失敗した組織として stderr に表示されます。

カナダ、中国、インド、または FedRAMP のダッシュボードでも動作しますか？

はい。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）を指定します。グローバルダッシュボードを使う場合は、設定を空のままにしてください。

エージェントが誤ってクライアントのネットワークを変更することはありますか？

書き込みは呼び出し時に即時送信され、確認プロンプトは表示されません。そのため、自律型エージェントには読み取り操作と --dry-run によるプレビューのみを許可してください。一括操作ツールの fleet push は、既定ではネットワークごとの差分をプレビューし、--apply を追加しない限り何も送信しません。MCP サーバーに CISCO_MERAKI_MCP_READ_ONLY=1 を設定すると、書き込み操作はすべて拒否されます。以下の安全性モデルでは、人間の確認を必須にすべきコマンドを説明しています。

費用はかかりますか？

無料です。Apache-2.0 ライセンスで提供されています。費用がかかるのは、お使いの AI エージェント（Claude、ChatGPT、Codex など）だけです。その料金は当社ではなく、AI プロバイダーから請求されます。

安全性モデル

ティア	例	推奨されるエージェントのポリシー
読み取り	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、またはそれを含む 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（スタックの作成時にスイッチが再起動します）	人間の介在が必須
破壊的操作	すべての delete、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 エージェントには、CISCO_MERAKI_MCP_READ_ONLY=1 も設定してください。MCP サーバーはすべての GET 以外の呼び出しと fleet push --apply を拒否します。制限方法を含む詳細は、governance.md をご覧ください。

ステータス

ベータ版です。Cisco Meraki API の機能に照らして検証済みで、毎週開催している Build Sessions では、本番テナントに対して実際に運用している MSP とともに検証を進めています。compoundingteams.com/build-sessions から参加登録してください。

---

標準規格。 オープンな Agent Skills spec（Anthropic、2025 年 12 月、40 以上のエージェント）に準拠しています。MCP に対応しており、Hermes を含む、MCP 対応のあらゆるエージェントで動作します。OpenClaw に対応済みです（フロントマターの設定済み。OpenClaw のリリース待ち）。

Servosity がメンテナンスしています。Apache-2.0 ライセンスです。CLI Printing Press を使用して構築されています。最終更新日：2026-10-13。