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

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

개요

주니퍼 네트웍스는 주니퍼 Mist API를 위한 MCP(Model Context Protocol) 서버를 만들었습니다. 이 솔루션은 귀하가 담당하는 주니퍼 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 Desktop 구성 파일은 API 토큰을 일반 텍스트로 저장합니다. 적절한 파일 권한으로 안전하게 보호하고 절대 공유하거나 버전 제어에 커밋하지 마십시오.

사전 요구 사항

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

표 1: Mist MCP 액세스 요구 사항
요구 사항	노트
주니퍼 Mist 클라우드 계정	https://manage.mist.com/signin.html#!signin
주니퍼 Mist MCP 서버 액세스	https://mcp.ai.juniper.net/mcp/mist
Claude 데스크탑	MCP에 대한 로컬 LLM 인터페이스
Node.js (버전 18 이상)	웹 브라우저 외부에서 PC에서 JavaScript를 실행할 수 있는 런타임 환경입니다.

Claude Desktop 설치

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

macOS 11(Big Sur) 이상
Windows 10 이상

컴퓨터에 적합한 버전의 Claude Desktop 을 다운로드합니다.
Claude Desktop 설치 프로그램을 실행하고 설치 절차를 따릅니다.
완료되면 Claude 계정을 만들거나 로그온합니다.

설치 Node.js

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

Node.js 다운로드

Juniper Mist Cloud API 토큰 생성

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

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

API 토큰으로 작업할 때는 다음 모범 사례에 유의하세요.

API 토큰을 절대 공유하지 말고 토큰을 암호처럼 취급하십시오.
가능하면 공유 응용 프로그램에 대한 조직 토큰을 사용합니다.
보안 강화를 위해 정기적으로 토큰을 회전시킵니다.
Mist 포털에서 토큰 사용량을 모니터링합니다.
토큰을 생성할 때 필요한 최소 권한을 사용합니다.

Claude 데스크탑 구성 파일

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

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

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

%APPDATA%\Claude\claude_desktop_config.json

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

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

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

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

샘플 구성 파일 참고 사항

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용 샘플 구성 파일

macOS용 샘플 구성 파일

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

Mist MCP 서버와 함께 Claude Desktop 사용

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

내 조직의 상태 표시
내 조직의 모든 사이트 목록을 제공해 주세요.

Claude 로그 파일 보기

Claude 로그 파일을 보려면,

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

맥OS: ~/Library/Logs/Claude
윈도우: %APPDATA%\Claude\logs