AIRGAP StudioAIRGAP Studio

MCP 서버 설정

MCP 서버 설정 파일 편집 및 관리

설정 파일 위치

MCP 서버 설정은 JSON 파일로 관리됩니다. 설정 파일 위치는 범위에 따라 다릅니다.

범위파일 경로
전역 설정%APPDATA%\AIRGAP Studio\globalStorage\mcp-settings.json
프로젝트 설정프로젝트 루트\.vscode\mcp.json

프로젝트 설정이 전역 설정보다 우선합니다.

설정 파일 편집

명령 팔레트에서 열기

  1. Ctrl+Shift+P를 눌러 명령 팔레트를 엽니다.
  2. MCP를 검색합니다.
  3. MCP: Edit Settings 명령을 선택합니다.

직접 편집

설정 파일을 직접 열어 JSON을 편집할 수 있습니다.

설정 형식

기본 구조

{
  "mcpServers": {
    "서버이름": {
      "command": "실행 명령어",
      "args": ["인자1", "인자2"],
      "env": {
        "ENV_VAR": "값"
      },
      "disabled": false
    }
  }
}

설정 항목 상세

항목타입설명필수
commandstring서버 실행 파일 경로 또는 명령어필수
argsstring[]명령어에 전달할 인자 배열선택
envobject서버 프로세스에 설정할 환경 변수선택
disabledbooleantrue이면 서버를 로드하지 않음선택

설정 예시

Node.js MCP 서버

{
  "mcpServers": {
    "file-tools": {
      "command": "node",
      "args": ["C:/mcp-servers/file-tools/index.js"],
      "disabled": false
    }
  }
}

Python MCP 서버

{
  "mcpServers": {
    "data-analyzer": {
      "command": "python",
      "args": ["C:/mcp-servers/data-analyzer/server.py"],
      "env": {
        "PYTHONPATH": "C:/mcp-servers/data-analyzer"
      }
    }
  }
}

여러 서버 동시 설정

{
  "mcpServers": {
    "file-tools": {
      "command": "node",
      "args": ["C:/mcp-servers/file-tools/index.js"]
    },
    "db-connector": {
      "command": "node",
      "args": ["C:/mcp-servers/db-connector/index.js"],
      "env": {
        "DB_PATH": "C:/data/local.db"
      }
    },
    "unused-server": {
      "command": "node",
      "args": ["C:/mcp-servers/unused/index.js"],
      "disabled": true
    }
  }
}

서버 관리

서버 추가

  1. 설정 파일의 mcpServers 객체에 새 항목을 추가합니다.
  2. 파일을 저장합니다.
  3. AIRGAP Assistant가 자동으로 새 서버를 감지하고 시작합니다.

서버 제거

설정 파일에서 해당 서버 항목을 삭제하거나, "disabled": true를 설정하여 비활성화합니다.

서버 상태 확인

AIRGAP Assistant 설정 패널의 MCP 섹션에서 각 서버의 연결 상태를 확인할 수 있습니다.

  • Connected: 서버가 정상적으로 실행 중
  • Disconnected: 서버가 연결되지 않음
  • Error: 서버 시작 중 오류 발생

에어갭 환경 주의사항

에어갭 환경에서 MCP 서버를 사용할 때는 다음에 유의하세요.

  • 서버 실행 파일과 모든 의존성을 로컬에 미리 설치해야 합니다.
  • npm install이 필요한 서버는 오프라인 패키지를 준비합니다.
  • 외부 API를 호출하는 서버는 에어갭 환경에서 동작하지 않습니다.

관련 문서