Uso del servidor MCP de Juniper Mist con Claude Desktop

En este documento, se explica cómo conectar Claude Desktop al servidor MCP de Juniper Mist.

Descripción general

HPE Networks ha creado un servidor de protocolo de contexto de modelo (MCP) para conectar de forma segura el modelo de lenguaje grande (LLM) de escritorio Claude de Anthropic a sus organizaciones de Mist. Puede usar el MCP para ejecutar comandos de API y administrar, monitorear o solucionar problemas de su red inalámbrica administrada por Mist. Mientras que Claude se ejecuta en su escritorio local, el servidor MCP se encuentra en una nube privada de HPE, mientras que sus organizaciones permanecen en la nube de Mist.

Consideraciones de seguridad para MCP y asistentes de IA

Advertencia:

El servidor MCP de Juniper Mist ofrece a los asistentes de IA acceso a la configuración de su red y a los datos operativos, que pueden incluir información confidencial, como claves precompartidas (PSK), secretos de RADIUS y credenciales de SNMP. Antes de conectar el servidor MCP a cualquier asistente de IA, tenga en cuenta lo siguiente:

Sepa a dónde van sus datos. Algunos servicios de IA basados en la nube pueden usar datos de conversación, incluidas las respuestas de MCP, para entrenar modelos futuros. Utilice únicamente servicios de IA que hayan sido revisados y aprobados por los equipos de seguridad y cumplimiento de su organización.
Considere la IA autoalojada. Para evitar que los datos confidenciales de la red salgan de su entorno, considere las soluciones de LLM alojadas localmente (por ejemplo, Ollama, LM Studio) en lugar de los servicios basados en la nube.
Aplique privilegios mínimos. Utilice tokens de API con los permisos mínimos necesarios. Prefiera tokens de solo lectura y evite otorgar un acceso más amplio que el que exige la tarea.
Proteja su archivo de configuración. El archivo de configuración de Claude Desktop almacena su token de API en texto sin formato. Asegúrelo con los permisos de archivo adecuados y nunca lo comparta ni lo confirme en el control de versiones.

Requisitos previos

Para usar el MCP de Juniper Mist, necesita lo siguiente:

Tabla 1: Requisitos para el acceso a MCP de Mist
Requisitos	Notas
Cuenta de la nube de Juniper Mist.	https://manage.mist.com/signin.html#!signin
Un token de API de solo lectura para la autenticación en su organización.	Vea cómo crear un token de API desde el panel de control de Mist.
El punto de conexión de la API de su nube regional de Mist.	Mist tiene múltiples nubes regionales . Debe identificar a la persona que aloja su organización. Por ejemplo, `api.ac2.mist.com` es el punto de conexión para la nube regional Global 02, mientras que `https://manage.ac2.mist.com/admin/?org_id=xxxxxxx-xxxx-xxx` es la URL de administración.
Acceso al servidor MCP de Juniper Mist.	https://mcp.ai.juniper.net/mcp/mist
Un cliente MCP con soporte de servidor HTTP remoto.	El cliente actúa como la interfaz LLM local para el servidor MCP. Puede usar Claude Code, Claude Desktop, VSCode y la mayoría de los otros asistentes compatibles con MCP.

Instalar Claude Desktop

Claude Desktop se ejecuta en las siguientes plataformas:

MacOS 11 (Big Sur) o posterior
Windows 10 o posterior

Descargue la versión adecuada de Claude desktop para su computadora.
Ejecute el programa de instalación de Claude Desktop y siga el procedimiento de instalación.
Cuando haya terminado, cree o inicie sesión en su cuenta de Claude.

Instalar Node.js

Node.js es un entorno de ejecución que permite ejecutar JavaScript en una PC o Mac. Por lo general, node.js requeriría un navegador web para que el programa se ejecute. La instalación de Node.js en su computadora le permite evitar la necesidad de un host de navegador.

Descargar Node.js

Cree un token de API de la nube de Juniper Mist

Necesita un token de API de Mist para autenticarse con el servidor MCP. Puede ser un token de organización, que recomendamos si comparte la aplicación, o un token de API específico del usuario, que recomendamos si tiene varias organizaciones a las que desea acceder a través de Claude Desktop.

Cree un token de API de organización o usuario, como se describe a continuación: Cree un token de API de la nube de Juniper Mist.

Archivo de configuración de Claude Desktop

Cuando instaló Claude Desktop, creó un archivo de configuración llamado claude_desktop_config.json que utiliza para almacenar varios parámetros. Debe editar el archivo para incluir sus valores personalizados.

Desde Claude Desktop, haga clic en Configuración > Desarrollador > Editar configuración.

Si no puede acceder al archivo de configuración desde Claude Desktop, deberá crearlo con un editor de texto. Para computadoras con Windows, el archivo generalmente se encuentra aquí:

%APPDATA%\Claude\claude_desktop_config.json

Para computadoras Mac, el archivo generalmente se encuentra aquí:

~/Biblioteca/Soporte de aplicaciones/Claude/claude_desktop_config.json

Notas del archivo de configuración de ejemplo

Para configurar el servidor MCP de Mist, debe definir los argumentos npx.

La Juniper Mist URL del servidor MCP: https://mcp.ai.juniper.net/mcp/mist
El encabezado Authorization con el token de API que creó: Authorization: Bearer <MIST_API_TOKEN>
El encabezado X-Mist-Base-URL—X-Mist-Base-URL: https://api.mist.com
(Opcional) El encabezado X-Mist-Org-ID para limitar el MCP a una organización de Mist específica: X-Mist-Org-ID:<YOUR_ORG_ID>

En caso de que la interceptación SSL la realice un proxy corporativo, un firewall o en su computadora portátil, es posible que deba especificar parámetros adicionales en la sección "env" para permitir que Node.js confíe en los certificados corporativos.

NODE_OPTIONS con el valor "--use-system-ca"
NODE_EXTRA_AC_CERTS con la ruta al certificado de AC de interceptación SSL

Copie y pegue una de las configuraciones de ejemplo a continuación y luego modifíquela según su entorno. Cuando haya terminado, guarde el archivo en la ubicación de Windows o Mac.

Nota: Para cargar la nueva configuración, debe salir de Claude Desktop (cerrarlo por completo para que no se ejecute en segundo plano) y luego reiniciar.

Ejemplo: Nuevo archivo de configuración para Windows
Ejemplo: archivo de configuración combinado para Windows
Archivo de configuración de ejemplo para macOS
Archivo de configuración de ejemplo para la interceptación de SSL para macOS

Ejemplo: Nuevo archivo de configuración para Windows

El siguiente ejemplo tiene el formato de un archivo JSON nuevo o vacío.

Ejemplo: archivo de configuración combinado para Windows

Si va a agregar el MCP de Mist a un archivo con entradas del servidor MCP existentes, copie solo la mist-cloud sección (líneas 7 a 17) y pegue esa sección dentro del objeto existente mcpServers . Asegúrese de separar por comas la nueva mist-cloud sección de la que sale.

Archivo de configuración de ejemplo para macOS

Archivo de configuración de ejemplo para la interceptación de SSL para macOS

Uso de Claude Desktop con el servidor MCP de Mist

Ahora que todo está configurado, es hora de ver cómo funciona. En Claude Desktop, inicie una nueva conversación y pídale a Claude que realice algunas tareas de Mist, por ejemplo,

Mostrarme el estado de mi organización
Dame una lista de todos los sitios de mi organización
Comprobar los problemas de conectividad de un usuario determinado durante la última semana
Verifique la configuración de Wi-Fi de los usuarios y, cuando esté justificado, sugiera optimizaciones

Visualización de archivos de registro de Claude

Para ver los archivos de registro de Claude,

Inicie la aplicación Claude Desktop y navegue hasta la Settings ventana para abrir la configuración del desarrollador.
En el panel de configuración, seleccione la Local MCP Servers sección.
Seleccione el servidor MCP de Juniper Mist de la lista y haga clic en el Open Logs Folder botón para abrir la ubicación del archivo de registro:

MacOS:~/Library/Logs/Claude
Ventanas: %APPDATA%\Claude\logs