Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
ON THIS PAGE
 

Using the Juniper Mist MCP Server with Claude Desktop (Beta)

This document explains how to connect Claude Desktop to the Juniper Mist MCP server.

Overview

Juniper Networks has created a Model Context Protocol (MCP) server for Juniper Mist APIs. It’s dedicated to the Juniper Mist organizations you are responsible for, and works with agentic AIs such as Claude Desktop. You can use the MCP to manage, monitor, and troubleshoot network and client issues.

Prerequisites

To use the Juniper Mist MCP, you need the following:

Table 1: Requirements for Mist MCP Access
Requirements Notes
  • Juniper Mist cloud account
 https://manage.mist.com/signin.html#!signin
  • Juniper Mist MCP server access
 https://mcp.ai.juniper.net/mcp/mist
Local LLM interface to the MCP
Runtime environment to run JavaScript on PC, outside a web browser.

Install Claude Desktop

Claude Desktop runs on the following platforms:

  • macOS 11 (Big Sur) or later

  • Windows 10 or later

  1. Download the appropriate version of Claude Desktop for your computer:

  2. Run the Claude Desktop setup program and follow the installation procedure.

  3. When finished, create or log on to your Claude account.

Install Node.js

Node.js is a run-time environment that makes it possible to run JavaScript on a PC or Mac. Typically, node..js would require a web browser in order for the program to run. Installing Node.js on your computer lets you bypass the need for a browser host.

Create a Juniper Mist Cloud API Token

You need a Mist API token to authenticate with the MCP server. This can be either an organization token, which we recommend if you are sharing the application, or a user specific API token, which we recommend if you have multiple organizations that you want to access through the Claude Desktop.

Create an organization or user API token, as described here: Create a Juniper Mist Cloud API Token.

When working with API tokens, keep in mind these best practices:

  • Never share your API token—treat a token like a password.
  • Use organization tokens for shared applications when possible.
  • Regularly rotate tokens for enhanced security.
  • Monitor token usage in the Mist portal.
  • Use minimum required permissions when creating tokens.

Claude Desktop Configuration File

When you installed the Claude Desktop, it created a configuration file called claude_desktop_config.json that it uses to store various parameters. You need to edit the file to include your custom values.

  • From Claude Desktop, click Settings > Developer > Edit Config.

If you can't access the configuration file from Claude Desktop, you'll need to create it using a text editor. For Windows computers, the file is typically located here:

  • %APPDATA%\Claude\claude_desktop_config.json

For Mac computers, the file is typically located here:

  • ~/Library/Application Support/Claude/claude_desktop_config.json

Copy and paste one of the sample configurations below, and then modify it as per your environment. When done, save the file to the Windows or Mac location.

Note: To load the new configuration, you must exit Claude Desktop (close it completely so it's not running in the background) and then restart.

Sample Configuration File Notes

To configure the Mist MCP Server, you need to define the npx arguments.

  • The Juniper Mist MCP Server URL— https://mcp.ai.juniper.net/mcp/mist

  • The Authorization header with the API token you created—Authorization: Bearer <MIST_API_TOKEN>

  • The X-Mist-Base-URL header—X-Mist-Base-URL: https://api.mist.com

  • (Optional) The X-Mist-Org-ID header to limit the MCP to a specific Mist Org—X-Mist-Org-ID:<YOUR_ORG_ID>

In case SSL interception is being performed by a corporate proxy, firewall or on your laptop, you may need to specify additional parameters in the "env" section to allow Node.js to trust the corporate certificates.

  • NODE_OPTIONS with the value "--use-system-ca"
  • NODE_EXTRA_CA_CERTS with the path to the SSL interception CA certificate

Sample Configuration File for Windows

Sample Configuration File for macOS

Sample Configuration File for SSL Interception for macOS

Using Claude Desktop with the Mist MCP Server

Now that everything is set up it's time to see it work. In Claude Desktop, start a new conversation and ask Claude to perform some Mist tasks, for example,

  • Show me the status of my organization

  • Give me a list of all the sites in my organization

Viewing Claude Log Files

To view Claude log files,

  1. Launch the Claude Desktop app and navigate to the Settings window to open the Developer settings.
  2. In the settings panel, select the Local MCP Servers section.
  3. Select the Juniper Mist MCP server from the list and click the Open Logs Folder button to open the log file location:

  • macOS: ~/Library/Logs/Claude

  • Windows: %APPDATA%\Claude\logs