Usando o servidor Juniper Mist MCP com Claude Desktop

Este documento explica como conectar o Claude Desktop ao servidor Juniper Mist MCP.

Visão geral

A HPE Networks criou um servidor de protocolo de contexto de modelo (MCP) para conectar com segurança o Claude Desktop Large Language Model (LLM) da Antropic às suas organizações Mist. Você pode usar o MCP para executar comandos de API e gerenciar, monitorar ou solucionar problemas de sua rede sem fio gerenciada pela Mist. Enquanto o Claude é executado em seu desktop local, o servidor MCP está localizado em uma nuvem HPE privada, enquanto suas organizações permanecem na nuvem Mist.

Considerações de Segurança para MCPs e Assistentes de IA

Atenção:

O servidor Juniper Mist MCP oferece aos assistentes de IA acesso aos dados operacionais e de configuração de rede, que podem incluir informações confidenciais, como chaves pré-compartilhadas (PSKs), segredos RADIUS e credenciais SNMP. Antes de conectar o servidor MCP a qualquer assistente de IA, lembre-se do seguinte:

Saiba para onde vão seus dados. Alguns serviços de IA baseados em nuvem podem usar dados de conversação, incluindo respostas do MCP, para treinar modelos futuros. Use apenas serviços de IA que tenham sido revisados e aprovados pelas equipes de segurança e conformidade da sua organização.
Considere a IA auto-hospedada. Para impedir que dados confidenciais da rede saiam do seu ambiente, considere soluções LLM hospedadas localmente (por exemplo, Ollama, LM Studio) em vez de serviços baseados em nuvem.
Aplique privilégios mínimos. Use tokens de API com as permissões mínimas necessárias. Prefira tokens somente leitura e evite conceder acesso mais amplo do que as demandas da tarefa.
Proteja seu arquivo de configuração. O arquivo de configuração do Claude Desktop armazena seu token de API em texto simples. Proteja-o com as permissões de arquivo apropriadas e nunca o compartilhe ou confirme no controle de versão.

Pré-requisitos

Para usar o MCP Juniper Mist, você precisa do seguinte:

Tabela 1: Requisitos para acesso ao Mist MCP
Requerimentos	Anotações
Conta de nuvem da Juniper Mist.	https://manage.mist.com/signin.html#!signin
Um token de API somente leitura para autenticação em sua organização.	Veja como criar um token de API a partir do painel do Mist.
O endpoint da API da sua nuvem Mist regional.	Mist tem várias nuvens regionais . Você precisa identificar quem hospeda sua organização. Por exemplo, `api.ac2.mist.com` é o endpoint para a nuvem regional Global 02, enquanto `https://manage.ac2.mist.com/admin/?org_id=xxxxxxx-xxxx-xxx` é a URL de gerenciamento.
Juniper Mist acesso ao servidor MCP.	https://mcp.ai.juniper.net/mcp/mist
Um cliente MCP com suporte a servidor HTTP remoto.	O cliente atua como a interface LLM local para o servidor MCP. Você pode usar Claude Code, Claude Desktop, VSCode e a maioria dos outros assistentes compatíveis com MCP.

Instale o Claude Desktop

O Claude Desktop é executado nas seguintes plataformas:

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

Baixe a versão apropriada do desktop Claude para o seu computador.
Execute o programa de instalação do Claude Desktop e siga o procedimento de instalação.
Quando terminar, crie ou faça logon em sua conta Claude.

Instale Node.js

Node.js é um ambiente de tempo de execução que possibilita a execução de JavaScript em um PC ou Mac. Normalmente, node.js exigiria um navegador da Web para que o programa fosse executado. Instalar Node.js em seu computador permite que você ignore a necessidade de um host de navegador.

Baixar Node.js

Criar um token de API da Juniper Mist Cloud

Você precisa de um token de API do Mist para se autenticar com o servidor MCP. Pode ser um token de organização, que recomendamos se você estiver compartilhando o aplicativo, ou um token de API específico do usuário, que recomendamos se você tiver várias organizações que deseja acessar por meio do Claude Desktop.

Crie um token de API de organização ou usuário, conforme descrito aqui: Crie um token de API da Juniper Mist Cloud.

Arquivo de configuração da área de trabalho Claude

Quando você instalou o Claude Desktop, ele criou um arquivo de configuração chamado claude_desktop_config.json que ele usa para armazenar vários parâmetros. Você precisa editar o arquivo para incluir seus valores personalizados.

No Claude Desktop, clique em Configurações > Desenvolvedor > Editar configuração.

Se você não conseguir acessar o arquivo de configuração do Claude Desktop, precisará criá-lo usando um editor de texto. Para computadores Windows, o arquivo normalmente está localizado aqui:

%APPDATA%\Claude\claude_desktop_config.json

Para computadores Mac, o arquivo normalmente está localizado aqui:

~/Biblioteca/Suporte a aplicativos/Claude/claude_desktop_config.json

Notas do arquivo de configuração de amostra

Para configurar o Mist MCP Server, você precisa definir os argumentos npx.

O Juniper Mist URL do servidor MCP— https://mcp.ai.juniper.net/mcp/mist
O cabeçalho Authorization com o token de API que você criou — Authorization: Bearer <MIST_API_TOKEN>
O cabeçalho X-Mist-Base-URL — X-Mist-Base-URL: https://api.mist.com
(Opcional) O cabeçalho X-Mist-Org-ID para limitar o MCP a uma organização Mist específica — X-Mist-Org-ID:<YOUR_ORG_ID>

Caso a interceptação SSL esteja sendo executada por um proxy corporativo, firewall ou em seu laptop, talvez seja necessário especificar parâmetros adicionais na seção "env" para permitir que Node.js confie nos certificados corporativos.

NODE_OPTIONS com o valor "--use-system-ca"
NODE_EXTRA_CA_CERTS com o caminho para o certificado de CA de interceptação SSL

Copie e cole uma das configurações de exemplo abaixo e modifique-a de acordo com seu ambiente. Quando terminar, salve o arquivo no local do Windows ou Mac.

Observação: Para carregar a nova configuração, você deve sair do Claude Desktop (fechá-lo completamente para que não seja executado em segundo plano) e reiniciar.

Exemplo: Novo arquivo de configuração para Windows
Exemplo: Arquivo de configuração mesclado para Windows
Exemplo de arquivo de configuração para macOS
Exemplo de arquivo de configuração para SSL Interception para macOS

Exemplo: Novo arquivo de configuração para Windows

O exemplo abaixo é formatado para um arquivo JSON novo ou vazio.

Exemplo: Arquivo de configuração mesclado para Windows

Se você estiver adicionando o MCP do Mist a um arquivo com entradas de servidor MCP existentes, copie apenas a seção (linhas 7 a 17) e cole essa seção dentro do mist-cloud objeto existente mcpServers . Certifique-se de separar a nova mist-cloud seção da que está saindo.

Exemplo de arquivo de configuração para macOS

Exemplo de arquivo de configuração para SSL Interception para macOS

Usando o Claude Desktop com o Mist MCP Server

Agora que tudo está configurado, é hora de ver funcionar. No Claude Desktop, inicie uma nova conversa e peça a Claude para executar algumas tarefas do Mist, por exemplo,

Mostre-me o status da minha organização
Dê-me uma lista de todos os sites da minha organização
Verificar os problemas de conectividade de um determinado usuário na semana passada
Verifique a configuração de Wi-Fi dos usuários e, quando necessário, sugira otimizações

Exibindo arquivos de log Claude

Para visualizar os arquivos de log Claude,

Inicie o aplicativo Claude Desktop e navegue até a Settings janela para abrir as configurações do desenvolvedor.
No painel de configurações, selecione a Local MCP Servers seção.
Selecione o servidor Juniper Mist MCP na lista e clique no Open Logs Folder botão para abrir o local do arquivo de log:

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