Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
このページの内容
 

Claude Desktop(ベータ版)でジュニパー Mist MCP サーバーを使用する

このドキュメントでは、Claudeデスクトップをジュニパー Mist MCPサーバーに接続する方法について説明します。

概要

ジュニパーネットワークスは、ジュニパー Mist API 用のモデルコンテキストプロトコル(MCP)サーバーを作成しました。あなたが担当するジュニパーMist組織専用で、Claude Desktopなどのエージェント型AIと連携します。MCP を使用して、ネットワークとクライアントの問題を管理、監視、トラブルシューティングできます。

MCP と AI アシスタントのセキュリティに関する考慮事項

警告:

ジュニパー Mist MCP サーバーを使用すると、AI アシスタントはネットワーク構成や運用データにアクセスできます。これらのデータには、事前共有キー(PSK)、RADIUS シークレット、SNMP 認証情報などの機密情報が含まれる場合があります。MCP サーバーを AI アシスタントに接続する前に、次の点に留意してください。

  • データの行き先を把握する。 一部のクラウドベースのAIサービスでは、MCP応答を含む会話データを使用して、将来のモデルをトレーニングする場合があります。組織のセキュリティおよびコンプライアンス チームによってレビューおよび承認された AI サービスのみを使用してください。

  • セルフホスト型AIについて考えてみましょう。 機密性の高いネットワークデータが環境外に流出ないようにするには、クラウドベースのサービスではなく、ローカルでホストされるLLMソリューション(Ollama、LM Studioなど)を検討してください。

  • 最小権限を適用します。 必要最小限の権限を持つAPIトークンを使用します。読み取り専用トークンを選択し、タスクで要求されるよりも広いアクセス権を付与することは避けてください。

  • 設定ファイルを保護します。 Claudeデスクトップ設定ファイルは、APIトークンをプレーンテキストで保存します。適切なファイル権限で保護し、決して共有したり、バージョン管理にコミットしたりしないでください。

前提条件

ジュニパー Mist MCP を使用するには、以下のものが必要です。

表1:Mist MCPアクセスの要件
要件 注記
  • ジュニパー Mist クラウドアカウント
 https://manage.mist.com/signin.html#!signin
  • ジュニパー Mist MCP サーバーへのアクセス
 https://mcp.ai.juniper.net/mcp/mist
MCPへのローカルLLMインターフェイス
  • Node.js (バージョン18以降)
Web ブラウザーの外部で PC 上で JavaScript を実行するためのランタイム環境。

Claudeデスクトップをインストールする

Claudeデスクトップは以下のプラットフォームで動作します。

  • macOS 11(Big Sur)以降

  • Windows 10以降

  1. お使いのコンピュータに適したバージョンの Claudeデスクトップ をダウンロードします。

  2. Claude Desktopセットアッププログラムを実行し、インストール手順に従います。

  3. 完了したら、Claudeアカウントを作成するかログオンします。

インストールNode.js

Node.js は、PC または Mac で JavaScript を実行できるようにするランタイム環境です。JSでは、プログラムを実行するにはWebブラウザが必要です。コンピューターにNode.jsをインストールすると、ブラウザホストが不要になります。

Juniper Mist Cloud APIトークンを作成する

MCPサーバーで認証するには、Mist APIトークンが必要です。これは、アプリケーションを共有する場合に推奨される組織トークン、またはClaudeデスクトップを介してアクセスしたい複数の組織がある場合に推奨されるユーザー固有のAPIトークンのいずれかです。

以下の説明に従って、組織またはユーザーのAPIトークンを作成します: Juniper Mist Cloud APIトークンを作成します。

APIトークンを使用する際には、次のベストプラクティスに留意してください。

  • APIトークンは決して共有しないでください。トークンをパスワードのように扱いましょう。
  • 可能な場合は、共有アプリケーションに組織トークンを使用します。
  • セキュリティを強化するためにトークンを定期的にローテーションします。
  • Mistポータルでトークンの使用状況を監視します。
  • トークンを作成する際には、必要最小限の権限を使用します。

Claudeデスクトップ設定ファイル

Claudeデスクトップをインストールすると、さまざまなパラメーターを保存するために使用する claude_desktop_config.json という設定ファイルが作成されました。カスタム値を含めるようにファイルを編集する必要があります。

  • Claudeデスクトップから、 設定>開発者>設定の編集をクリックします。

Claude Desktopから設定ファイルにアクセスできない場合は、テキストエディタを使用して作成する必要があります。Windowsコンピューターの場合、ファイルは通常次の場所にあります。

  • %APPDATA%\Claude\claude_desktop_config.json

Mac コンピュータの場合、ファイルは通常次の場所にあります。

  • ~/library/application support/Claude/claude_desktop_config.json

以下のサンプル設定のいずれかをコピー&ペーストし、お使いの環境に合わせて変更します。完了したら、ファイルをWindowsまたはMacの場所に保存します。

注:新しい設定を読み込むには、Claude Desktopを終了し(バックグラウンドで実行されないように完全に閉じ)、再起動する必要があります。

サンプル設定ファイルのメモ

Mist MCPサーバーを設定するには、npx引数を定義する必要があります。

  • MCP サーバー URL Mistジュニパー — https://mcp.ai.juniper.net/mcp/mist

  • 作成したAPIトークンを含む認証ヘッダー—認証:ベアラ

  • X-Mist-Base-URLヘッダー—X-Mist-Base-URL:https://api.mist.com

  • (オプション)MCPを特定のMist組織に制限するためのX-Mist-Org-IDヘッダー—X-Mist-Org-ID:

SSL傍受が企業のプロキシ、ファイアウォール、またはラップトップによって実行されている場合、Node.js企業証明書を信頼できるように、「env」セクションに追加パラメーターを指定する必要がある場合があります。

  • 値が「--use-system-ca」のNODE_OPTIONS
  • NODE_EXTRA_CA_CERTSをSSL傍受CA証明書へのパスに置き換えます

Windows用サンプル設定ファイル

macOS用サンプル設定ファイル

macOS向けSSL傍受用サンプル設定ファイル

Mist MCPサーバーでのClaude Desktopの使用

すべての設定が完了したので、次は機能を確認します。Claudeデスクトップで、新しい会話を開始し、ClaudeにいくつかのMistタスクを実行するように依頼します。

  • 組織のステータスを表示

  • 組織内のすべてのサイトの一覧を教えてください

Claudeログファイルの表示

Claudeログファイルを表示するには、

  1. Claudeデスクトップアプリを起動し、 Settings ウィンドウに移動して開発者設定を開きます。
  2. 設定パネルで、[ Local MCP Servers ]セクションを選択します。
  3. リストからジュニパー Mist MCPサーバーを選択し、 Open Logs Folder ボタンをクリックしてログファイルの場所を開きます。

  • macOS:~/Library/Logs/Claude

  • Windows: %APPDATA%\Claude\logs