Claude 데스크톱과 함께 주니퍼 Mist MCP 서버 사용

이 문서에서는 Claude Desktop을 주니퍼 Mist MCP 서버에 연결하는 방법을 설명합니다.

개요

HPE Networks는 Anthropic의 Claude Desktop LLM(대규모 언어 모델)을 Mist 조직에 안전하게 연결할 수 있는 MCP(Model Context Protocol) 서버를 개발했습니다. MCP를 사용하여 API 명령을 실행하고 Mist 매니지드 무선 네트워크를 관리, 모니터링 또는 문제 해결할 수 있습니다. Claude는 로컬 데스크톱에서 실행되는 반면, MCP 서버는 프라이빗 HPE 클라우드에 위치하지만 조직은 Mist 클라우드에 유지됩니다.

MCP 및 AI 어시스턴트에 대한 보안 고려 사항

경고:

주니퍼 Mist MCP 서버는 사전 공유 키(PSK), RADIUS 비밀, SNMP 자격 증명과 같은 민감한 정보가 포함될 수 있는 네트워크 구성 및 운영 데이터에 대한 AI 어시스턴트의 액세스를 제공합니다. MCP 서버를 AI 어시스턴트에 연결하기 전에 다음 사항에 유의하세요.

  • 데이터가 어디로 이동하는지 파악하세요. 일부 클라우드 기반 AI 서비스는 MCP 응답을 포함한 대화 데이터를 사용하여 미래 모델을 학습시킬 수 있습니다. 조직의 보안 및 규정 준수 팀에서 검토하고 승인한 AI 서비스만 사용하십시오.

  • 자체 호스팅 AI를 생각해 보십시오. 민감한 네트워크 데이터가 사용자 환경을 벗어나지 않도록 하려면 클라우드 기반 서비스 대신 로컬에서 호스팅되는 LLM 솔루션(예: Ollama, LM Studio)을 고려하십시오.

  • 최소 권한을 적용합니다. 필요한 최소 권한이 있는 API 토큰을 사용합니다. 읽기 전용 토큰을 선호하며 작업에 요구되는 것보다 더 광범위한 액세스 권한을 부여하지 마십시오.

  • 구성 파일을 보호합니다. Claude Desktop 구성 파일은 API 토큰을 일반 텍스트로 저장합니다. 적절한 파일 권한으로 안전하게 보호하고 절대 공유하거나 버전 제어에 커밋하지 마십시오.

사전 요구 사항

주니퍼 Mist MCP를 사용하려면 다음이 필요합니다.

표 1: Mist MCP 액세스 요구 사항
요구 사항 노트
  • 주니퍼 Mist 클라우드 계정.
https://manage.mist.com/signin.html#!signin
  • 조직에 대한 인증을 위한 읽기 전용 API 토큰입니다.
Mist 대시보드 에서 API 토큰을 생성하는 방법을 참조하세요.
  • 지역 Mist 클라우드의 API 엔드포인트입니다.
Mist에는 여러 지역 클라우드가 있습니다 . 조직을 호스팅하는 네트워크를 식별해야 합니다. 예를 들어, api.ac2.mist.com 는 Global 02 지역 클라우드의 엔드포인트인 반면 https://manage.ac2.mist.com/admin/?org_id=xxxxxxx-xxxx-xxx , 은 관리 URL입니다.
  • 주니퍼 Mist MCP 서버 액세스.
https://mcp.ai.juniper.net/mcp/mist
  • 원격 HTTP 서버를 지원하는 MCP 클라이언트.

클라이언트는 MCP 서버에 대한 로컬 LLM 인터페이스 역할을 합니다. Claude Code, Claude Desktop, VSCode 및 대부분의 기타 MCP 지원 어시스턴트를 사용할 수 있습니다.

Claude Desktop 설치

Claude Desktop은 다음 플랫폼에서 실행됩니다.

  • MacOS 11(Big Sur) 이상

  • Windows 10 이상

  1. 컴퓨터에 적합한 버전의 Claude 데스크탑을 다운로드하십시오.

  2. Claude Desktop 설치 프로그램을 실행하고 설치 절차를 따릅니다.

  3. 완료되면 Claude 계정을 만들거나 로그온합니다.

설치 Node.js

Node.js는 PC 또는 Mac에서 JavaScript를 실행할 수 있게 해주는 런타임 환경입니다. 일반적으로 프로그램을 실행하려면 웹 브라우저node.js 필요합니다. 컴퓨터에 Node.js 설치하면 브라우저 호스트가 필요하지 않습니다.

Juniper Mist Cloud API 토큰 생성

MCP 서버에 인증하려면 Mist API 토큰이 필요합니다. 이는 애플리케이션을 공유하는 경우 권장하는 조직 토큰이거나 Claude Desktop을 통해 액세스하려는 조직이 여러 개 있는 경우 권장하는 사용자별 API 토큰일 수 있습니다.

여기에 설명된 대로 조직 또는 사용자 API 토큰을 만듭니다. Juniper Mist Cloud API 토큰을 만듭니다.

Claude 데스크탑 구성 파일

Claude Desktop을 설치하면 다양한 매개변수를 저장하는 데 사용하는 claude_desktop_config.json 라는 구성 파일이 생성되었습니다. 사용자 지정 값을 포함하도록 파일을 편집해야 합니다.

  • Claude Desktop에서 설정 > 개발자 > 구성 편집을 클릭합니다.

Claude Desktop에서 구성 파일에 액세스할 수 없는 경우 텍스트 편집기를 사용하여 생성해야 합니다. Windows 컴퓨터의 경우 파일은 일반적으로 다음 위치에 있습니다.

  • %APPDATA%\Claude\claude_desktop_config.json

Mac 컴퓨터의 경우 파일은 일반적으로 다음 위치에 있습니다.

  • ~/라이브러리/애플리케이션 지원/Claude/claude_desktop_config.json

샘플 구성 파일 참고 사항

Mist MCP 서버를 구성하려면 npx 인수를 정의해야 합니다.

  • 주니퍼 Mist MCP 서버 URL — https://mcp.ai.juniper.net/mcp/mist

  • 사용자가 만든 API 토큰이 있는 Authorization 헤더(Authorization: Bearer <MIST_API_TOKEN>

  • X-Mist-Base-URL 헤더—X-Mist-Base-URL: https://api.mist.com

  • (선택 사항) MCP를 특정 Mist 조직으로 제한하기 위한 X-Mist-Org-ID 헤더—X-Mist-Org-ID:<YOUR_ORG_ID>

SSL 가로채기가 회사 프록시, 방화벽 또는 노트북에서 수행되는 경우 Node.js가 회사 인증서를 신뢰할 수 있도록 "env" 섹션에 추가 매개 변수를 지정해야 할 수 있습니다.

  • 값이 "--use-system-ca"인 NODE_OPTIONS
  • SSL 가로채기 CA 인증서에 대한 경로로 NODE_EXTRA_CA_CERTS

아래 샘플 구성 중 하나를 복사하여 붙여넣은 다음 환경에 맞게 수정합니다. 완료되면 파일을 Windows 또는 Mac 위치에 저장합니다.

참고: 새 구성을 로드하려면 Claude Desktop을 종료한 다음(백그라운드에서 실행되지 않도록 완전히 닫아야 함) 다시 시작해야 합니다.

예: Windows용 새 구성 파일

아래 예제는 새 JSON 파일 또는 빈 JSON 파일에 대한 형식이 지정되었습니다.

예: Windows용 병합된 구성 파일

기존 MCP 서버 항목이 있는 파일에 Mist MCP를 추가하는 경우 섹션(7-17행)만 mist-cloud 복사하여 해당 섹션을 기존 mcpServers 개체 안에 붙여넣습니다. 새 mist-cloud 섹션과 기존 섹션을 쉼표로 구분해야 합니다.

macOS용 샘플 구성 파일

macOS용 SSL 가로채기를 위한 샘플 구성 파일

Mist MCP 서버와 함께 Claude Desktop 사용

이제 모든 것이 설정되었으므로 이제 작동을 확인할 차례입니다. Claude Desktop에서 새 대화를 시작하고 Claude에게 몇 가지 Mist 작업을 수행하도록 요청합니다. 예:

  • 내 조직의 상태 표시

  • 내 조직의 모든 사이트 목록을 제공해 주세요.

  • 지난 한 주 동안 특정 사용자의 연결 문제를 확인합니다.

  • 사용자의 Wi-Fi 구성을 확인하고 필요한 경우 최적화 제안

Claude 로그 파일 보기

Claude 로그 파일을 보려면,

  1. Claude Desktop 앱을 실행하고 창으로 Settings 이동하여 개발자 설정을 엽니다.
  2. 설정 패널에서 섹션을 선택합니다.Local MCP Servers
  3. 목록에서 주니퍼 Mist MCP 서버를 선택하고 버튼을 Open Logs Folder 클릭하여 로그 파일 위치를 엽니다.
  • 맥 OS : ~/Library/Logs/Claude

  • 윈도우: %APPDATA%\Claude\logs