MongoDB MCP 서버 보안 권장사항

JSON 구성 파일 예시

다음 예시 Claude Desktop 클라이언트 애플리케이션 의 MCP 클라이언트 JSON 구성 파일 에 있는 --readOnly 을(를) 보여줍니다.

{
   "mcpServers": {
      "MongoDB": {
         "type": "stdio",
         "command": "npx",
         "args": [
            "-y",
            "mongodb-mcp-server@latest",
            "--readOnly"
         ],
         "env": {
            "MDB_MCP_CONNECTION_STRING":
            "mongodb://localhost:27017/myDatabase"
         }
      }
   }
}

다른 예시 클라이언트 JSON 구성 파일은 MCP 서버 구성을 참조하세요.

명령줄 예시

다음 예시 Atlas cluster 에 연결하기 위해 Unix 환경 변수에 MCP 서버 연결 문자열 정의합니다.

export MDB_MCP_CONNECTION_STRING="mongodb://localhost:27017/myDatabase"

다음 예시 에서는 이전 환경 변수를 사용하고 추가 명령줄 옵션도 설정합니다.

npx -y mongodb-mcp-server@latest --readOnly

비밀 및 환경 변수

로그인 자격 증명 및 연결 정보와 같은 민감한 구성 설정에는 명령줄 인수 대신 환경 변수를 사용합니다. 예시 들어 API 클라이언트 설정에는 MDB_MCP_API_CLIENT_ID 및 MDB_MCP_API_CLIENT_SECRET 를 사용하고 연결 문자열에는 MDB_MCP_CONNECTION_STRING 를 사용합니다.

환경 변수는 명령줄 인수보다 안전합니다. 명령줄 인수를 추적하고, 캐시하고, 프로세스 목록에 포함하고, 다양한 위치에 기록할 수 있습니다.

다음 예시 MDB_MCP_READ_ONLY 환경 변수를 true 로 설정하고 MDB_MCP_CONNECTION_STRING 환경 변수를 설정합니다.

"MongoDB": {
   "type": "stdio",
   "command": "npx",
   "args": [
      "-y",
      "mongodb-mcp-server@latest",
   ],
   "env": {
      "MDB_MCP_READ_ONLY": "true",
      "MDB_MCP_CONNECTION_STRING":
      "mongodb://127.0.0.1:27019/?directConnection=true"
   }
}

환경 변수에 대한 자세한 내용은 운영 체제에서 MCP 서버 환경 변수 정의를 참조하세요.

로컬 MCP 서버

로컬 MCP 서버에서 MCP 서버와 클라이언트 애플리케이션 동일한 컴퓨터에서 실행 .

로컬 MCP 서버를 사용하면 설치 환경을 제어할 수 있습니다.

• 구성 및 종속성: MCP 서버 소프트웨어 종속성을 관리 . MCP 서버 매개변수 및 데이터베이스 연결을 정의하려면 로컬 컴퓨터에서 파일을 편집합니다.

• 자격 증명 보안: API 키 및 연결 문자열에 대한 민감한 정보는 구성 파일 또는 환경 변수에 로컬로 저장됩니다. 자격 증명 보호합니다.

• 수동 소프트웨어 업데이트: 새 MCP 서버 버전이 출시되면 사용자는 MCP 서버 소프트웨어를 다운로드 하여 설치할 수 있습니다. 이로 인해 사용자가 다른 MCP 서버 버전을 실행 수 있습니다.

원격 MCP 서버

원격 MCP 서버 배포서버 에서 MCP 서버는 cloud 의 컴퓨터 또는 온프레미스 서버 에서 실행됩니다.

클라이언트 애플리케이션은 네트워크를 통해 MCP 서버에 연결하고 Streamable HTTP 사용합니다. 이를 통해 여러 사용자, 자동화된 시스템, 애플리케이션 및 AI 에이전트가 액세스할 수 있는 중앙 공유 환경을 제공합니다.

MCP 서버 원격 배포의 경우 다음 사항을 고려하세요.

• 원격 배포서버 에는 예비 보안 위험이 있으며 보안 구성이 필요합니다.

• 최소한 cloud 또는 온프레미스에서 네트워크 격리, MCP 서버에 대한 인증 구성하고 시크릿 관리 설정하다 해야 합니다.

위임된 권한 부여

위임된 권한 부여 에서 사용자는 자신의 권한 중 일부를 에이전트 에게 위임합니다. MongoDB MCP 서버와 함께 OAuth 2.1 을 사용할 것을 권장합니다.

MCP 서버로 작동하려면 배포서버 인증된 사용자 계정으로 보호되는 OAuth 권한 부여 서버(AS)와 OAuth 리소스 서버(RS)로 작동하는 MCP 서버 앞에 프록시가 있어야 합니다. 에이전트 OAuth 클라이언트 로 작동합니다.

OAuth 위임은 다음과 같이 작동합니다.

1. 에이전트가 MCP 서버에 대한 액세스 요청합니다. MCP 서버는 프록시로 보호됩니다.

2. 프록시는 에이전트 AS로 보내고, AS는 권한 부여 요청 시작합니다.

3. 사용자는 AS에 로그인하고 에이전트 가 MCP 서버를 보호하는 프록시인 RS 액세스 할 수 있는 권한을 부여합니다.

4. 에이전트는 RS에 액세스 할 수 액세스 토큰을 받습니다.

5. 에이전트는 액세스 토큰을 사용하여 프록시를 통해 MCP 서버를 호출합니다.

6. 프록시는 액세스 토큰의 유효성을 검사하고 MCP 서버에 대한 호출을 허용합니다.

7. MCP 서버는 프록시 요청 수신하고 정적으로 구성된 보안 연결을 통해 데이터베이스 에서 명령을 실행합니다.

MCP 서버와 데이터베이스 액세스 토큰을 읽지 않습니다. 프록시는 MCP 서버를 보호하기 위해 신뢰할 수 있습니다. 프록시를 우회하면 MCP 서버 및 MCP 서버가 액세스 할 수 있는 데이터베이스에 액세스 .

토큰의 형식이 숨겨집니다. JWT 는 프록시가 AS에서 발급한 토큰을 독립적으로 확인할 수 있는 일반적인 형식입니다.

직접 인증

직접 인증 권장되지 않습니다.

직접 인증 사용하면 에이전트 프록시에 자격 증명 제공합니다. 프록시가 자격 증명 인증합니다. 자격 증명 API 키 또는 에이전트 식별하는 기타 자격 증명일 수 있습니다. 패턴 간단하지만 다음과 같은 문제가 있습니다.

• 에이전트 만 식별되고 에이전트 대신해 역할을 하는 사용자는 식별되지 않습니다.

• MCP 서버를 통해 누가 어떤 조치 취하고 있는지 감사 방법은 없습니다.

• 액세스는 일반적으로 모든 사용자에 대해 중앙에서 제어되거나 프록시에서 직접 제어됩니다.

사용자 가장

사용자 가장을 사용하지 마세요.

사용자 가장을 사용하면 사용자는 에이전트 에게 직접 자격 증명 제공합니다. 에이전트 인증 위해 자격 증명 프록시로 보냅니다. 사용자 가장에는 다음과 같은 문제가 있습니다.

• 사용자만 식별됩니다. 에이전트 사용자를 대신하여 행동한다는 사실은 숨겨져 있습니다.

• 사용자 자격 증명 중간 시스템으로 유출되었습니다. 이로 인해 사용자 계정이 위험에 노출될 수 있습니다.

• 사용자가 수행할 수 있는 작업은 에이전트 에 대해 허용되며 제한된 기능 출시하다 불가능합니다.

• 에이전트 연결을 해제하려면 사용자 자격 증명 교체해야 하며, 이로 인해 사용자 계정과 시스템이 중단됩니다.

• 피싱 및 재생 불가 자격 자격 증명 작동할 수 없습니다.

통과 인증

통과 인증 사용하지 마세요.

통과 인증 에서 에이전트 데이터베이스 에 액세스 위한 자격 증명 얻어 프록시에 전달합니다. 프록시는 자격 증명 유효성을 검사하고 자격 증명 MCP 서버에 전달합니다. MCP 서버는 자격 증명 사용하여 데이터베이스 에 연결합니다. 통과 인증 에는 다음과 같은 문제가 있습니다.

• 복사 및 재생 가능한 자격 증명 만 작동할 수 있으므로 연결이 보안 수준이 낮은 옵션으로 제한됩니다.

• 연결 체인은 시스템에서 숨겨집니다.

• 누구나 체인의 다음 부분을 생략할 수 있습니다.

데이터베이스 인증 및 권한 부여

MCP 서버는 다음과 같은 데이터베이스 인증 방법을 지원합니다.

• LDAP, X.509 인증서, OIDC 및 Kerberos 사용한 엔터프라이즈 인증 .

• 강력한 비밀번호 인증 제공하기 위한 기본 SCRAM-SHA-256 인증 .

• 서비스 계정 및 클러스터 간 통신을 위한mTLS 인증서 인증 .

MongoDB database 다음과 같은 권한 부여 방법을 지원합니다.

• RBAC 를 사용하여 데이터베이스 액세스 제한합니다.

• 특정 데이터베이스, 개별 컬렉션 및 읽기, 쓰기 (write) 및 관리 작업과 같은 작업에 대한 액세스 제한하는 세분화된 데이터베이스 권한입니다.

• 팀을 위한 사용자 지정 데이터베이스 역할. 예시 들어, 분석 팀 에 대한 읽기 전용 액세스 및 운영 팀 에 대한 읽기-쓰기 액세스 .

• 컬렉션 액세스 제한하는 추가 컬렉션 보안.

네트워크 보안

네트워크 격리 를 위한 권장 사항:

• 인터넷에 직접 액세스 하지 않고도 비공개 VPC 또는 VNet 에 클러스터를 배포합니다.

• VPC 피어링 및 비공개 엔드포인트 사용하여 cloud 비공개 네트워크에 대한 연결을 보호합니다.

• 특정 IP 주소 또는 CIDR 블록에 대한 데이터베이스 액세스 제한합니다.

방화벽 구성을 위한 권장 사항:

• MongoDB 서버 포트 27017 에 대한 액세스 승인된 애플리케이션 서버로만 제한합니다.

• 수신 및 발신 네트워크 트래픽에 대한 보안 그룹 및 ACL 을 사용하여 cloud 방화벽 규칙을 구성합니다.

• 암호화되지 않은 포트를 비활성화하고 모든 연결에 대해 TLS 1.2+를 시행하다 .