VisualPro User Guide

VisualPro MCP 통합 설정 가이드VisualPro MCP Integrated Setup Guide

버전Version V1.3 발행일Published 2026-08-21 발행처Publisher VWAY

AI 에이전트와 VisualPro를 완벽하게 연결하는 방법How to connect VisualPro with your AI agent

SECTION 01

공통 준비사항Common Prerequisites

모든 도구에서 공통으로 사용하는 VisualPro MCP Server 실행 파일 경로입니다. VisualPro 설치 시 함께 설치되며, 시작 전에 아래 경로에 파일이 있는지 확인하세요.Every tool uses the same VisualPro MCP Server executable path. It is installed together with VisualPro — before you begin, make sure the file exists at the path below.

MCP Server 실행 파일MCP Server Executable

C:\Program Files\VWAY\MCPServer\VisualPro.McpServer.exe

① 도구 설치① Install the tool→② MCP 서버 등록② Register the MCP server→③ 앱 재실행③ Restart the app→④ 연결 확인 후 분석 시작④ Verify and start analysis

💡 분석을 시작하기 전에는 VisualPro가 실행 중이어야 합니다.VisualPro must be running before you start an analysis.

ℹ️ 연결 방식 안내Connection Type VisualPro MCP Server는 PC에서 직접 실행되는 로컬(stdio) 방식의 실행 파일(.exe)입니다. 이 가이드의 도구들은 모두 로컬 MCP 서버 연결을 지원하는 데스크톱 앱 기준입니다.
웹 브라우저에서 사용하는 SaaS형 AI 서비스는 HTTPS URL 형식의 원격(Remote) MCP 서버를 요구하는 경우가 있으며, 이 경우 본 가이드의 방법으로는 직접 연결할 수 없습니다. (터널링 등 별도 구성이 필요하므로 필요 시 문의해 주세요.)The VisualPro MCP Server is a local (stdio) executable (.exe) that runs directly on your PC. All tools in this guide are desktop apps that support local MCP server connections.
Some web-based (SaaS) AI services require a remote MCP server with an HTTPS URL — those cannot be connected using this guide alone. (Additional setup such as tunneling is required; contact us if needed.)

SECTION 02

도구별 설정Tool-Specific Setup

Claude Desktop 기준 설정Claude Desktop Setup

Claude Desktop 준비Prepare Claude Desktop

우선 PC에 Claude Desktop 앱을 설치하고 실행합니다.
다운로드: claude.com/download
First, install and launch the Claude Desktop app on your PC.
Download: claude.com/download
설정 파일(claude_desktop_config.json) 수정Edit claude_desktop_config.json
Claude 설정 파일을 열어 VisualPro MCP Server 정보를 추가합니다.
아래 경로의 claude_desktop_config.json 파일에 코드를 추가한 뒤 저장합니다.
Open the Claude configuration file and add the VisualPro MCP Server information.
Add the code below to the claude_desktop_config.json file at the following path, then save it.

설정 파일 경로Configuration File Path
%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json
claude_desktop_config.json
```
{
  "mcpServers": {
    "VisualPro": {
      "command": "C:\\Program Files\\VWAY\\MCPServer\\VisualPro.McpServer.exe",
      "args": []
    }
  }
}
```
앱 재실행Restart the App

설정이 완료되면 팝업 안내창의 설명에 따라 Claude Desktop 앱을 완전히 종료한 후 다시 실행합니다.
After completing the setup, follow the pop-up instructions and fully quit and restart the Claude Desktop app.
MCP 연결 확인Verify MCP Connection

채팅창의 '+' 아이콘을 누르고 커넥터(Connector) 목록을 확인합니다.
목록에 VisualPro MCP가 추가된 것을 볼 수 있습니다.
Click the '+' icon in the chat window and check the connector list.
You will see VisualPro MCP added to the list.
VisualPro 분석 시작Start VisualPro Analysis

VisualPro 커넥터의 스위치가 On 상태라면 준비 완료입니다!
이제 VisualPro를 실행하고 Claude Desktop과 대화하며 스마트한 분석을 시작하세요.
If the VisualPro connector switch is On, you are all set!
Now launch VisualPro and start smart analysis by chatting with Claude Desktop.

Claude Code 기준 설정Claude Code Setup

설정 방식 선택Choose Your Setup Method

Claude Code는 두 가지 방식으로 설정할 수 있습니다.
방법 A — VS Code 확장(권장): Visual Studio Code 안에서 GUI로 사용하는 방식입니다. 화면을 보며 진행할 수 있어 처음 사용하는 분께 권장합니다.
방법 B — 터미널 단독: VS Code 없이 터미널(PowerShell)만으로 설정하는 방식입니다.
두 방법 모두 같은 명령으로 MCP를 등록하므로 하나만 진행하면 됩니다.
You can set up Claude Code in one of two ways.
Method A — VS Code Extension (recommended): use Claude Code inside Visual Studio Code with a GUI. Recommended for first-time users since you can follow along visually.
Method B — Terminal only: set up using only the terminal (PowerShell), without VS Code.
Both methods register MCP with the same command, so complete only one of them.
방법 A · VS Code 설치Method A · Install VS Code

code.visualstudio.com에서 Visual Studio Code를 다운로드하여 설치합니다.
VS Code 기반의 다른 IDE(Cursor, Google Antigravity 등)에서도 동일한 방식으로 사용할 수 있습니다 — 기타 MCP 지원 도구 탭을 참고하세요.
Download and install Visual Studio Code from code.visualstudio.com.
Other VS Code-based IDEs (Cursor, Google Antigravity, etc.) work the same way — see the Other Tools tab.
방법 A · Claude Code 확장 설치Method A · Install the Claude Code Extension

VS Code 좌측의 Extensions(사각형 아이콘)를 클릭해 확장 창을 열고, claude code로 검색하여 Anthropic이 게시한 Claude Code for VS Code 확장을 Install 합니다.
Click the Extensions icon (squares) on the left side of VS Code, search for claude code, and Install the Claude Code for VS Code extension published by Anthropic.

게시자 확인 대화상자가 표시되면 Trust Publisher & Install을 클릭합니다.
If the publisher confirmation dialog appears, click Trust Publisher & Install.
방법 A · 작업 폴더 열기Method A · Open a Working Folder

File > Open Folder 메뉴로 작업 폴더를 선택합니다.
💡 분석에 참고할 자료(규격 문서, 기존 분석 결과 등)를 이 폴더에 넣어두면, AI에게 폴더의 자료를 참고하도록 지시할 수 있습니다.
Select a working folder via the File > Open Folder menu.
💡 If you place reference materials (standards, previous analysis results, etc.) in this folder, you can instruct the AI to consult them during analysis.
방법 A · Claude Code 실행과 로그인Method A · Launch Claude Code & Sign In

우측 상단의 Claude 아이콘을 클릭하면 Claude Code 창이 열리고, Account 인증(로그인) 절차를 거치면 사용 가능한 상태가 됩니다.
💡 세션은 현재 열린 폴더 기준으로 생성되므로, 폴더별로 작업 세션을 다르게 관리할 수 있습니다.
Click the Claude icon at the top right to open the Claude Code panel, then complete the account sign-in to start using it.
💡 Sessions are created per opened folder, so you can manage separate work sessions for each folder.
방법 A · MCP 서버 등록Method A · Register the MCP Server
상단 Terminal 메뉴(또는 Toggle Panel 버튼)로 하단에 터미널 창을 열고, 아래 명령어를 입력한 뒤 Enter 키를 누르면 등록이 진행됩니다.
Open the terminal at the bottom via the Terminal menu (or the Toggle Panel button), type the command below, and press Enter to register.
Terminal
```
claude mcp add --scope user --transport stdio visualpro -- "C:\Program Files\VWAY\MCPServer\VisualPro.McpServer.exe"
```
⚠️ -- 구분자는 필수이며 그 뒤가 실제 서버 실행 명령입니다. 공백이 포함된 경로(Program Files)는 반드시 따옴표로 감싸야 합니다.
⚠️ The -- separator is mandatory — everything after it is the actual server command. Paths containing spaces (Program Files) must be wrapped in quotes.

💡 터미널 사용이 어렵다면, Claude Code 채팅창에 본 가이드 주소와 함께 연결을 지시해도 됩니다. 예: "https://www.vwaycorp.com/vpmcp 이 페이지를 참고해서 VisualPro MCP와 연결해줄래?"
아래 화면처럼 에이전트가 가이드를 직접 읽고 등록부터 연결 확인까지 스스로 완료합니다.
💡 If you are not comfortable with the terminal, you can simply ask in the Claude Code chat, including this guide's URL. e.g., "Please refer to https://www.vwaycorp.com/vpmcp and connect the VisualPro MCP for me."
As shown below, the agent reads the guide itself and completes everything from registration to connection check.

프롬프트 한 줄로 에이전트가 가이드를 읽고 등록 → 연결 확인(✓ Connected)까지 완료한 실제 화면
An actual run: one prompt, and the agent reads the guide and completes registration → connection check (✓ Connected)
방법 A · MCP 연결 확인Method A · Verify the MCP Connection

Claude Code 채팅창에 /mcp를 입력하면 현재 연결된 MCP Server 목록이 표시됩니다. visualpro ✓ Connected가 보이면 연결 완료입니다.
필요에 따라 Jira 등 다른 MCP Server를 함께 연결해 사용할 수도 있습니다.
Type /mcp in the Claude Code chat to list the connected MCP servers. When visualpro ✓ Connected appears, the connection is complete.
You can also connect additional MCP servers (such as Jira) alongside VisualPro as needed.
방법 B · Claude Code 준비 (터미널)Method B · Prepare Claude Code (Terminal)

방법 A로 이미 등록했다면 방법 B는 건너뛰어도 됩니다.
우선 PC에 Claude Code를 설치하고(claude.com/claude-code 안내 참조), 터미널(PowerShell)에서 claude 명령으로 실행해 로그인합니다.
Claude Code는 별도 GUI 없이 터미널에서 동작하는 AI 에이전트로, 설정 파일을 직접 편집할 필요 없이 명령어 한 줄로 MCP 서버를 등록할 수 있습니다.
If you already registered via Method A, you can skip Method B.
First, install Claude Code on your PC (see claude.com/claude-code), then run it with the claude command in your terminal (PowerShell) and sign in.
Claude Code is an AI agent that runs directly in the terminal without a separate GUI — you can register an MCP server with a single command, no configuration file editing required.
방법 B · MCP 서버 등록 명령 실행Method B · Run the MCP Registration Command
터미널에서 아래 명령어 한 줄을 실행하면 등록이 완료됩니다.
Run the single command below in your terminal to complete registration.
Terminal
```
claude mcp add --scope user --transport stdio visualpro -- "C:\Program Files\VWAY\MCPServer\VisualPro.McpServer.exe"
```
⚠️ -- 구분자는 필수이며 그 뒤가 실제 서버 실행 명령입니다. 공백이 포함된 경로(Program Files)는 반드시 따옴표로 감싸야 합니다.
⚠️ The -- separator is mandatory — everything after it is the actual server command. Paths containing spaces (Program Files) must be wrapped in quotes.

적용 범위(Scope) 선택 — 방법 A·B 공통Choose the Scope — Common to A & B

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

범위	저장 위치	특징
local (기본값)	~/.claude.json	현재 프로젝트에서 본인만 사용
project	프로젝트 루트의 .mcp.json	저장소 공유를 통해 팀 전체가 동일 설정 사용
user (권장)	~/.claude.json	모든 프로젝트에서 본인만 사용

Specify the registration scope with the --scope option. For tools used across your entire PC like VisualPro, the user scope is recommended.

Scope	Stored in	Usage
local (default)	~/.claude.json	Personal use in the current project only
project	.mcp.json at the project root	Share via your repository so the whole team uses the same setup
user (recommended)	~/.claude.json	Personal use across all your projects

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

With the project scope, the following .mcp.json file is created at the project root and can be shared via your team repository.

.mcp.json

{
  "mcpServers": {
    "VisualPro": {
      "type": "stdio",
      "command": "C:\\Program Files\\VWAY\\MCPServer\\VisualPro.McpServer.exe",
      "args": []
    }
  }
}

방법 B · MCP 연결 확인Method B · Verify the MCP Connection
아래 명령으로 등록 상태를 확인합니다. 대화 세션 중에는 /mcp 명령으로 연결 상태와 도구 개수를 바로 확인할 수 있습니다.
Check the registration status with the commands below. During a session, type /mcp to instantly check the connection status and the number of tools.
Terminal
```
claude mcp list              # List registered servers & status
claude mcp get visualpro     # Server details
claude mcp remove visualpro  # Unregister
```
VisualPro 분석 시작Start VisualPro Analysis

이제 VisualPro를 실행한 상태에서 Claude Code 대화창에 자연어로 VisualPro 분석을 지시합니다. Claude Code가 VisualPro MCP 도구를 호출해 분석을 수행합니다.
Now, with VisualPro running, instruct analyses in the Claude Code session using natural language. Claude Code will call the VisualPro MCP tools to perform the analysis.

Codex(ChatGPT) 기준 설정Codex (ChatGPT) Setup

ChatGPT 앱(Codex) 준비Prepare the ChatGPT App (Codex)

우선 PC에 ChatGPT 데스크톱 앱을 설치하고 실행한 뒤, 앱 안에서 Codex 화면을 선택합니다.
※ 2026년 7월부터 Codex 앱이 ChatGPT 앱으로 통합되었습니다. 화면 구성은 앱 버전에 따라 다소 다를 수 있습니다.
다운로드: developers.openai.com/codex
First, install and launch the ChatGPT desktop app on your PC, then select the Codex view inside the app.
※ As of July 2026, the Codex app has been merged into the ChatGPT app; screens may differ slightly by app version.
Download: developers.openai.com/codex
설정 파일(config.toml) 수정Edit config.toml
Codex 설정 파일을 열어 VisualPro MCP Server 정보를 추가합니다.
아래 경로의 config.toml 파일에 TOML 코드를 추가한 뒤 저장합니다.
Open the Codex configuration file and add the VisualPro MCP Server information.
Add the TOML code below to the config.toml file at the following path, then save it.

설정 파일 경로Configuration File Path
%USERPROFILE%\.codex\config.toml
config.toml
```
[mcp_servers.VisualPro]
command = 'C:\Program Files\VWAY\MCPServer\VisualPro.McpServer.exe'
args = []
```
앱 재실행Restart the App

설정이 완료되면 ChatGPT(Codex) 앱을 완전히 종료한 후 다시 실행합니다.
After completing the setup, fully quit and restart the ChatGPT (Codex) app.
MCP 등록 확인Verify MCP Registration

Codex에서 VisualPro MCP Server가 정상적으로 등록되었는지 확인합니다.
MCP 도구 목록에 VisualPro가 표시되면 연결 준비가 완료된 상태입니다.
Check that the VisualPro MCP Server is registered correctly in Codex.
When VisualPro appears in the MCP tool list, the connection is ready.
VisualPro 분석 시작Start VisualPro Analysis

이제 VisualPro를 실행하고 Codex에서 VisualPro MCP 도구를 호출해 분석을 시작합니다.
Now launch VisualPro and start your analysis by calling the VisualPro MCP tools from Codex.

Opencode 기준 설정Opencode Setup

Opencode Desktop 준비Prepare Opencode Desktop

우선 PC에 Opencode 앱을 설치하고 실행합니다.
다운로드: opencode.ai
First, install and launch the Opencode app on your PC.
Download: opencode.ai
설정 파일(opencode.jsonc) 수정Edit opencode.jsonc
Opencode 설정 파일을 열어 VisualPro MCP Server 정보를 추가합니다.
아래 경로의 opencode.jsonc 파일에 JSONC 코드를 추가한 뒤 저장합니다.
Open the Opencode configuration file and add the VisualPro MCP Server information.
Add the JSONC code below to the opencode.jsonc file at the following path, then save it.

설정 파일 경로Configuration File Path
%USERPROFILE%\.config\opencode\opencode.jsonc
opencode.jsonc
```
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "VisualPro": {
      "type": "local",
      "command": [
        "C:\\Program Files\\VWAY\\MCPServer\\VisualPro.McpServer.exe"
      ],
      "enabled": true,
      "environment": {}
    }
  }
}
```
앱 재실행Restart the App

설정이 완료되면 Opencode 앱을 완전히 종료한 후 다시 실행합니다.
After completing the setup, fully quit and restart the Opencode app.
MCP 등록 확인Verify MCP Registration

Opencode에서 VisualPro MCP Server가 정상적으로 등록되었는지 확인합니다.
MCP 도구 목록에 VisualPro가 표시되면 연결 준비가 완료된 상태입니다.
Check that the VisualPro MCP Server is registered correctly in Opencode.
When VisualPro appears in the MCP tool list, the connection is ready.
VisualPro 분석 시작Start VisualPro Analysis

이제 VisualPro를 실행하고 Opencode에서 VisualPro MCP 도구를 호출해 분석을 시작합니다.
Now launch VisualPro and start your analysis by calling the VisualPro MCP tools from Opencode.

Deepseek GUI(KUN) 기준 설정Deepseek GUI(KUN) Setup

Deepseek GUI(KUN) 준비Prepare Deepseek GUI(KUN)

우선 PC에 Deepseek GUI(KUN) 앱을 설치하고 실행합니다.
Deepseek GUI는 첫 실행 시 Deepseek API 연결을 요구합니다.
다운로드: github.com/XingYu-Zhong/DeepSeek-GUI (Releases)
First, install and launch the Deepseek GUI(KUN) app on your PC.
Deepseek GUI requires a Deepseek API connection on first launch.
Download: github.com/XingYu-Zhong/DeepSeek-GUI (Releases)
mcp.json 파일 수정Edit mcp.json
옵션 메뉴를 통해 MCP 설정 파일(mcp.json)을 열어 VisualPro MCP Server 정보를 추가합니다.
Open the MCP configuration file (mcp.json) from the options menu and add the VisualPro MCP Server information.

① Plugins 클릭 ② Manage 클릭
① Click Plugins ② Click Manage

① mcp.json 파일을 우클릭하여 메모장으로 편집 클릭
② 표시된 부분에 붙여넣기
① Right-click the mcp.json file and open it with Notepad
② Paste the code into the highlighted area
mcp.json
```
"VisualPro": {
  "command": "C:\\Program Files\\VWAY\\MCPServer\\VisualPro.McpServer.exe",
  "args": [],
  "enabled": true
}
```
앱 재실행Restart the App

설정이 완료되면 Deepseek GUI(KUN) 앱을 완전히 종료한 후 다시 실행합니다.
After completing the setup, fully quit and restart the Deepseek GUI(KUN) app.
MCP 등록 확인Verify MCP Registration

Deepseek GUI(KUN)에서 VisualPro MCP Server가 정상적으로 등록되었는지 확인합니다.
Plugins를 클릭하면 VisualPro가 Connected로 표시됩니다.
Check that the VisualPro MCP Server is registered correctly in Deepseek GUI(KUN).
Click Plugins and VisualPro will be shown as Connected.
VisualPro 분석 시작Start VisualPro Analysis

이제 VisualPro를 실행하고 Deepseek GUI(KUN)에서 VisualPro MCP 도구를 호출해 분석을 시작합니다.
Now launch VisualPro and start your analysis by calling the VisualPro MCP tools from Deepseek GUI(KUN).

Zcode 기준 설정Zcode Setup

Zcode 준비Prepare Zcode

우선 PC에 Zcode 앱을 설치하고 실행합니다.
입력창 하단의 모델 선택 메뉴에서 사용할 모델(GLM-5.2 등)을 선택할 수 있습니다.
다운로드: zcode.z.ai
First, install and launch the Zcode app on your PC.
You can select the model to use (GLM-5.2, etc.) from the model selector below the input box.
Download: zcode.z.ai
MCP 서버 추가Add MCP Server
설정 메뉴에서 MCP Servers 화면을 열어 VisualPro MCP Server 정보를 추가합니다.
Open the MCP Servers screen from the settings menu and add the VisualPro MCP Server information.

① 좌측 하단 설정(⚙) 버튼 클릭 ② MCP Servers 클릭 ③ 우측 상단 + 버튼 클릭
① Click the settings (⚙) button at the bottom left ② Click MCP Servers ③ Click the + button at the top right

① JSON 탭 선택
② 아래 설정 코드를 Full configuration 영역에 붙여넣기
③ Add 버튼 클릭
① Select the JSON tab
② Paste the configuration code below into the Full configuration area
③ Click the Add button
New MCP server (JSON)
```
{
  "VisualPro": {
    "type": "stdio",
    "command": "C:\\Program Files\\VWAY\\MCPServer\\VisualPro.McpServer.exe",
    "args": []
  }
}
```
앱 재실행Restart the App

설정이 완료되면 Zcode 앱을 완전히 종료한 후 다시 실행합니다.
After completing the setup, fully quit and restart the Zcode app.
MCP 등록 확인Verify MCP Registration

Zcode에서 VisualPro MCP Server가 정상적으로 등록되었는지 확인합니다.
설정의 MCP Servers 목록(Configured MCP servers)에 VisualPro가 초록색 상태 표시와 함께 6 tools로 표시됩니다.
Check that the VisualPro MCP Server is registered correctly in Zcode.
In the MCP Servers list (Configured MCP servers), VisualPro appears with a green status indicator and 6 tools.
VisualPro 분석 시작Start VisualPro Analysis

이제 VisualPro를 실행하고 Zcode에서 VisualPro MCP 도구를 호출해 분석을 시작합니다.
Now launch VisualPro and start your analysis by calling the VisualPro MCP tools from Zcode.

기타 MCP 지원 도구 (Google Antigravity · Cursor · LM Studio 등)Other MCP-Compatible Tools (Google Antigravity · Cursor · LM Studio, etc.)

공통 MCP 설정 코드Common MCP Configuration
이 가이드에 없는 범용 MCP 지원 도구를 사용하는 경우에도, 해당 앱의 MCP Server 설정 메뉴(JSON 에디터)에 아래 코드를 붙여넣으면 동일하게 연결됩니다.
Even if you use a general MCP-compatible tool not covered in this guide, you can connect the same way by pasting the code below into the app's MCP Server settings (JSON editor).
mcp_config.json
```
{
  "mcpServers": {
    "VisualPro": {
      "command": "C:\\Program Files\\VWAY\\MCPServer\\VisualPro.McpServer.exe",
      "args": []
    }
  }
}
```
적용 예시 화면Example Screens

아래는 대표적인 도구들의 MCP 설정 화면 예시입니다. 메뉴 이름은 달라도 JSON에 서버 항목을 추가하는 방식은 동일합니다.
Below are example MCP settings screens from popular tools. Menu names differ, but the approach — adding a server entry to the JSON — is the same.

① Google Antigravity ② Cursor ③ LM Studio
① Google Antigravity ② Cursor ③ LM Studio

SECTION 03

FAQ · 문제 해결FAQ · Troubleshooting

빠른 진단표Quick Diagnosis Table

증상Symptom	원인Cause	해결Fix
도구 목록에 VisualPro가 안 보임VisualPro missing from the tool list	설정 파일 경로 오타 또는 JSON 문법 오류Typo in the config path or JSON syntax error	'경로 복사' 버튼으로 정확한 경로 사용, 쉼표·따옴표·역슬래시(\\) 확인 후 앱 완전 재시작Use the 'Copy Path' button for the exact path; check commas, quotes, and backslashes (\\); fully restart the app
도구는 보이는데 호출이 실패함Tools are visible but calls fail	VisualPro 앱이 실행되어 있지 않음The VisualPro app is not running	VisualPro를 먼저 실행한 뒤 다시 시도Launch VisualPro first, then try again
설정을 저장해도 반영되지 않음Saved settings are not applied	대부분의 클라이언트는 시작 시에만 설정을 읽음Most clients read the configuration only at startup	AI 도구를 트레이 아이콘까지 완전히 종료 후 재시작Fully quit the AI tool (including the tray icon) and restart
`400 … defer_loading: Extra inputs are not permitted` (AWS Bedrock 환경)`400 … defer_loading: Extra inputs are not permitted` (AWS Bedrock)	Claude Code의 Tool Search 기능이 Bedrock API와 비호환Claude Code's Tool Search feature is incompatible with the Bedrock API	`~/.claude/settings.json`의 env에 `"ENABLE_TOOL_SEARCH": "false"` 추가 후 재시작Add `"ENABLE_TOOL_SEARCH": "false"` to env in `~/.claude/settings.json` and restart
`401 api key is expired` (AWS Bedrock 환경)`401 api key is expired` (AWS Bedrock)	AWS 임시 자격증명(SSO/STS) 또는 Bedrock API 키 만료 — Anthropic 키 문제가 아님Expired AWS temporary credentials (SSO/STS) or Bedrock API key — not an Anthropic key issue	`aws sso login` 재로그인 또는 키 재발급 후 Claude Code 재시작Re-run `aws sso login` or reissue the key, then restart Claude Code

FAQ

Q. 설정을 저장했는데 도구 목록에 VisualPro가 보이지 않아요.I saved the configuration, but VisualPro does not appear in the tool list.

앱을 트레이 아이콘까지 완전히 종료한 후 다시 실행했는지 확인하세요. 그래도 보이지 않으면 설정 파일의 문법 오류(쉼표 누락, 괄호 짝 등)를 확인하세요. JSON에서는 경로 구분자를 \\(역슬래시 2개)로 적어야 합니다.Make sure you fully quit the app (including the tray icon) and restarted it. If it still does not appear, check the configuration file for syntax errors (missing commas, unmatched brackets, etc.). In JSON, path separators must be written as \\ (double backslashes).

Q. MCP 서버 실행 파일을 찾을 수 없다는 오류가 나요.I get an error saying the MCP server executable cannot be found.

C:\Program Files\VWAY\MCPServer\VisualPro.McpServer.exe 경로에 파일이 실제로 있는지 확인하세요. 없다면 VisualPro를 최신 버전으로 다시 설치하세요.Check that the file actually exists at C:\Program Files\VWAY\MCPServer\VisualPro.McpServer.exe. If not, reinstall the latest version of VisualPro.

Q. VisualPro 도구는 보이는데 분석 요청이 실패해요.The VisualPro tools are visible, but analysis requests fail.

MCP 도구를 호출하려면 VisualPro가 실행 중이어야 합니다. VisualPro를 먼저 실행한 뒤 다시 시도하세요.VisualPro must be running for the MCP tools to work. Launch VisualPro first, then try again.

Q. 웹 기반(SaaS) AI 서비스에서도 VisualPro MCP를 쓸 수 있나요?Can I use VisualPro MCP with web-based (SaaS) AI services?

본 가이드는 로컬 실행 파일(stdio) 방식 기준이라 데스크톱 앱에서만 바로 연결됩니다. HTTPS 원격 MCP 서버를 요구하는 서비스는 터널링 구성 등 별도 작업이 필요합니다.This guide covers the local executable (stdio) method, so it works out of the box only with desktop apps. Services that require a remote MCP server over HTTPS need additional setup, such as tunneling.

Q. 어떤 도구를 사용하는 것이 좋나요?Which tool should I use?

모두 표준 MCP 프로토콜을 사용하므로 기능은 동일합니다. 이미 사용 중인 AI 도구가 있다면 해당 탭의 안내를 따라 설정하시면 됩니다.All tools use the standard MCP protocol, so the functionality is identical. If you already use one of these AI tools, just follow the instructions in its tab.

Q. 사내 AWS Bedrock 경유로 Claude Code를 쓰는데 MCP 추가 후 400/401 오류가 나요.I use Claude Code via AWS Bedrock at work, and I get 400/401 errors after adding MCP.

Bedrock 경유 환경 특유의 문제이며 VisualPro MCP 서버의 문제가 아닙니다. 400 defer_loading 오류는 Tool Search 기능과 Bedrock API의 비호환이 원인이므로 설정 파일에 ENABLE_TOOL_SEARCH=false를 추가하고, 401 api key is expired는 AWS 자격증명 만료이므로 재로그인/키 갱신 후 재시작하세요. 자세한 절차는 위의 빠른 진단표를 참고하세요.These are specific to Bedrock-based environments and not a problem with the VisualPro MCP server. The 400 defer_loading error is caused by an incompatibility between the Tool Search feature and the Bedrock API — add ENABLE_TOOL_SEARCH=false to your settings. 401 api key is expired means your AWS credentials expired — re-login or renew the key, then restart. See the quick diagnosis table above for details.