VWAY

뉴스룸
기술자료


기타[VisualPro Tech Insight] 터미널 AI 에이전트 Claude Code와 VisualPro의 지능형 MCP 연결 가이드

터미널 창과 VisualPro 서버가 화살표로 이어지고 방패·공장·안전모 아이콘이 둘러선 Claude Code 와 VisualPro 연동 가이드 표제 그림

VWAY VisualPro × Claude Code Integration Guide

터미널 AI 에이전트 Claude Code와 VisualPro의 지능형 MCP 연결 가이드

명령어 한 줄로 구축하는 MCP 기반 대화형 시스템 안전 분석 & FMEA/STPA/FTA/TARA 자동화 환경


01. VisualPro MCP 연동 개요 & 핵심 가치

Claude Code는 터미널에서 동작하는 Anthropic의 AI 에이전트로, MCP(Model Context Protocol) 표준을 통해 VisualPro MCP Server와 직접 연결됩니다. 설정 파일을 직접 편집할 필요 없이 명령어 한 줄로 등록이 완료됩니다.

💻 명령어 한 줄 등록

JSON 설정 파일 편집 없이 claude mcp add 명령 한 줄로 VisualPro MCP Server 등록 완료

대화형 FMEA / STPA / FTA 등 안전 및 보안 분석

자연어 질의를 통해 Safety Mechanism 추천 및 고장 네트워크 구성

🔒 사내 데이터 보안 및 로컬 분석

데이터 외부 유출 없이 사내 보안 가이드라인 준수 하에 실시간 엔지니어링 분석 수행


02. 사전 준비 사항 및 필수 요구 환경

VisualPro 솔루션 설치

VisualPro 최신 버전 및 VisualPro.McpServer.exe 바이너리 (기본 경로: C:\Program Files\VWAY\MCPServer\)

Claude Code CLI

Anthropic 공식 안내(claude.com/claude-code)에 따라 설치 및 로그인이 완료된 Claude Code 최신 버전

운영체제 및 권한

Windows 10 / 11 (64-bit), 터미널(PowerShell 등) 실행이 가능한 사용자 계정 권한


03. Claude Code 연동 5단계 가이드

STEP 1. Claude Code 사전 준비

Claude Code를 설치한 뒤 터미널(PowerShell)에서 claude 명령으로 실행하고 로그인합니다.

STEP 2. MCP 서버 등록 명령 실행

터미널에서 아래 명령어 한 줄을 실행하면 등록이 완료됩니다. '--' 구분자 뒤가 실제 서버 실행 명령이며, 공백이 포함된 경로는 반드시 따옴표로 감싸야 합니다.

claude mcp add --scope user --transport stdio visualpro -- "C:\ProgramFiles\VWAY\MCPServer\VisualPro.McpServer.exe"

STEP 3. 적용 범위(Scope) 선택

--scope 옵션으로 등록 범위를 지정합니다. VisualPro처럼 PC 전역에서 사용하는 도구는 user 범위를 권장합니다.

local (기본값)

현재 프로젝트에서 본인만 사용 (~/.claude.json에 저장)

project

프로젝트 루트의 .mcp.json 파일에 저장 — 저장소 공유를 통해 팀 전체가 동일 설정 사용 가능

user (권장)

모든 프로젝트에서 본인만 사용 (~/.claude.json에 저장)

STEP 4. MCP 연결 확인

아래 명령으로 등록 상태를 확인합니다. 대화 세션 중에는 /mcp 명령으로 연결 상태와 도구 개수를 바로 확인할 수 있습니다.

claude mcp list # 등록된 서버 목록 및 연결 상태

claude mcp get visualpro # 서버 상세 정보

claude mcp remove visualpro # 등록 해제

STEP 5. VisualPro AI 대화형 분석 시작

VisualPro를 실행한 상태에서 Claude Code 대화창에 'FMEA 고장모드 영향분석 실행', 'Safety Mechanism 검증' 등 자연어로 VisualPro 분석을 자유롭게 지시합니다.


04. 주의사항 및 참고

• '--' 구분자는 필수입니다. Claude Code의 옵션과 MCP 서버 실행 명령을 구분하는 역할을 합니다.

• VisualPro MCP Server는 로컬(stdio) 방식의 실행 파일로, 네트워크 연결 없이 PC 내부에서 하위 프로세스로 동작합니다.

• 분석을 시작하기 전에는 VisualPro가 실행 중이어야 합니다.

• project 범위 선택 시 아래와 같은 .mcp.json 파일이 프로젝트 루트에 생성되며, 팀 저장소에 포함해 공유할 수 있습니다.

{

"mcpServers": {

"VisualPro": {

"type": "stdio",

"command": "C:\\Program Files\\VWAY\\MCPServer\\VisualPro.McpServer.exe",

"args": []

}

}

}


💡 (주)브이웨이 VisualPro AI 솔루션 기술 지원 문의

VisualPro MCP 연동 및 기업용 커스텀 AI 구축 기술 지원 문의는 브이웨이 솔루션팀으로 언제든 연락해 주세요.

공식 웹사이트: www.vway.co.kr | 기술 지원 이메일: support@vway.co.kr