원격 MCP 서버 연결 - AIRGAP Studio 문서

개요

네트워크 접근이 가능한 환경에서는 원격 MCP 서버에 연결하여 AI 어시스턴트의 기능을 확장할 수 있습니다. 원격 MCP 서버는 팀 단위로 공유 도구를 제공하거나, 고성능 서버에서 무거운 작업을 처리할 때 유용합니다.

에어갭 환경: 완전한 에어갭 환경에서는 네트워크 접근이 불가능하므로 원격 MCP 서버를 사용할 수 없습니다. 이 경우 로컬 MCP 서버 설정을 참고하세요.

연결 설정

SSE (Server-Sent Events) 방식

원격 MCP 서버는 주로 SSE 프로토콜을 사용합니다.

{
  "mcpServers": {
    "remote-tools": {
      "url": "http://192.168.1.100:3000/mcp",
      "transportType": "sse"
    }
  }
}

설정 항목

항목	설명	필수
`url`	원격 서버 URL	필수
`transportType`	전송 프로토콜 (`sse`)	필수
`headers`	인증 헤더	선택
`timeout`	연결 타임아웃 (ms)	선택

인증이 필요한 서버

{
  "mcpServers": {
    "authenticated-server": {
      "url": "http://internal-server:3000/mcp",
      "transportType": "sse",
      "headers": {
        "Authorization": "Bearer your-token-here"
      }
    }
  }
}

보안 고려사항

내부 네트워크 전용

원격 MCP 서버는 반드시 신뢰할 수 있는 내부 네트워크 내에서만 연결하세요.

MCP 서버가 접근하는 데이터와 도구의 범위를 확인합니다.
HTTPS를 사용하여 통신을 암호화하는 것을 권장합니다.
인증 토큰은 정기적으로 갱신합니다.

방화벽 설정

조직의 방화벽에서 MCP 서버 포트를 허용해야 합니다. 보안 담당자와 협의하여 필요한 최소한의 포트만 개방하세요.

타임아웃 설정

네트워크 상태에 따라 연결 타임아웃을 조정할 수 있습니다.

{
  "mcpServers": {
    "remote-tools": {
      "url": "http://192.168.1.100:3000/mcp",
      "transportType": "sse",
      "timeout": 30000
    }
  }
}

기본 타임아웃은 환경에 따라 다릅니다. 네트워크가 느린 환경에서는 30,000ms(30초) 이상으로 설정하는 것을 권장합니다.

연결 확인

원격 서버 연결 후 AIRGAP Assistant에서 다음을 확인하세요.

설정 패널의 MCP 섹션에서 서버 상태가 Connected로 표시되는지 확인합니다.
서버가 제공하는 도구 목록이 나타나는지 확인합니다.
간단한 도구 호출을 테스트합니다.

문제 해결

증상	원인	해결 방법
연결 실패	URL 오류 또는 서버 미실행	URL 확인 및 서버 상태 점검
타임아웃	네트워크 지연	타임아웃 값 증가
인증 오류	토큰 만료 또는 누락	인증 헤더 확인 및 토큰 갱신
도구 미표시	서버 설정 오류	서버 측 로그 확인

개요