Docs Menu
Docs Home
/
MongoDB MCP 서버
/
구성

MongoDB MCP 서버 구성 옵션

MCP 서버에는 MongoDB cluster 에 연결하고 MCP 서버 작업을 제어하기 위해 설정하다 수 있는 다양한 옵션이 있습니다. 명령줄 통해 또는 운영 체제 환경 변수를 사용하여 JSON 구성 파일 에서 옵션을 설정하다 수 있습니다.

옵션 목록

다음 구성 옵션을 사용하여 MCP 서버를 구성합니다.

중요

MongoDB 엔터프라이즈 또는 MongoDB Atlas 사용자이고 특정 인증 메커니즘 필요한 경우 MongoDB MCP 서버 보안 섹션을 참조하여 인증 방법에 대한 구성 옵션에 대해 학습 .

CLI 옵션 이름
OS 환경 변수 이름
유형
기본값
설명

apiClientId

MDB_MCP_API_CLIENT_ID

문자열

설정하다 되지 않음

인증 위한 Atlas API 클라이언트 ID .

apiClientSecret

MDB_MCP_API_CLIENT_SECRET

문자열

설정하다 되지 않음

인증 위한 Atlas API 클라이언트 시크릿입니다.

connectionString

MDB_MCP_CONNECTION_STRING

문자열

설정하다 되지 않음

데이터베이스 직접 연결을 위한 연결 문자열입니다.

클라이언트 클러스터 에 직접 연결할 수 있도록 런타임에 연결 문자열 설정합니다.

중요

--connectionString CLI 인수는 더 이상 사용되지 않습니다. 대신 MDB_MCP_CONNECTION_STRING 환경 변수를 사용하세요. 환경 변수가 옵션이 아닌 경우 첫 번째 위치 인수를 사용하세요.

참고

일반적으로 연결 자격 증명 대규모 언어 모델에 노출되므로 런타임에 연결 문자열 제공하지 않는 것이 좋습니다.

연결 문자열 클라이언트 이전에 연결한 적이 없거나 이전에 클라이언트 적이 있는 경우 클라이언트 새 클러스터 로 연결을 전환하는 경우에 사용됩니다.

클라이언트 연결 또는 연결 도구 전환을 호출한 후 클라이언트 후속 작업에 동일한 연결을 재사용합니다. 따라서 연결 또는 연결 도구를 한 번만 호출하거나 다른 연결로 전환해야 하는 경우에만 호출하면 됩니다.

loggers

MDB_MCP_LOGGERS

문자열

disk mcp

MCP 서버가 로그를 전송하는 위치를 지정합니다.

loggers 를 다음 옵션 중 하나 이상으로 설정합니다.

  • disklogPath 옵션에 지정된 경로에 있는 디스크 파일에 로그를 기록합니다.

  • mcp클라이언트 로깅 및 전송 프로토콜 지원하는 경우 AI 클라이언트 로 로그를 전송합니다.

  • stderr, 로그를 표준 오류 출력으로 전송합니다. 이 설정은 디버깅하거나 컨테이너 에서 MCP를 실행 때 유용합니다.

예시 AI 클라이언트 JSON 구성 파일 또는 운영 체제 명령줄 에서 loggers 을 mcp 및 stderr 로 설정하다 하려면 --loggers mcp stderr를 사용합니다.

MDB_MCP_LOGGERS 운영 체제 환경 변수를 disk 및 stderr(으)로 설정하다 하려면 export MDB_MCP_LOGGERS="disk,stderr"를 사용합니다.

로깅 옵션에 대한 자세한 내용은 MongoDB MCP 서버 문제 해결을 참조하세요.

logPath

MDB_MCP_LOG_PATH

문자열

운영 체제에 따라 다릅니다.

MCP 서버 로그를 저장하는 디렉토리입니다.

로그 경로 및 운영 체제 세부 사항에 대한 자세한 내용은 MongoDB MCP 서버 문제 해결을 참조하세요.

disabledTools

MDB_MCP_DISABLED_TOOLS

배열

설정하다 되지 않음

비활성화할 MCP 도구 이름, 작업 유형 또는 도구 범주의 배열 .

자세한 내용은 MCP 서버 도구 비활성화를 참조하세요.

readOnly

MDB_MCP_READ_ONLY

부울

false

클러스터 쓰기 (write) 작업을 비활성화하려면 구성 파일 또는 명령줄 에서 --readOnly 을(를) 설정하다 하거나 MDB_MCP_READ_ONLY 운영 체제 환경 변수를 true(으)로 설정하다 .

기본값은 클러스터 쓰기 (write) 작업을 허용하는 것입니다. 일반적으로 항상 읽기 전용 모드 활성화 .

자세한 내용은 MCP 서버 읽기 전용 모드 활성화를 참조하세요.

indexCheck

MDB_MCP_INDEX_CHECK

부울

false

true인 경우 쿼리 작업에서 인덱스 사용해야 하도록 강제하고 컬렉션 스캔을 수행하는 쿼리를 거부합니다.

자세한 내용은 인덱스 검사 활성화를 참조하세요.

telemetry

MDB_MCP_TELEMETRY

문자열

enabled

disabled인 경우 MCP 서버 사용 데이터 컬렉션 중지됩니다.

자세한 내용은 MCP 서버 원격 분석 비활성화를 참조하세요.

transport

MDB_MCP_TRANSPORT

문자열

stdio

MCP 서버와의 통신을 위한 전송 프로토콜 .

transport 를 다음 옵션 중 하나로 설정합니다.

  • stdio, 이 값이 기본값 입니다. MCP 서버와의 통신을 위해 표준 입력 및 출력을 사용합니다. stdio 은 대부분의 AI 클라이언트에 적합합니다.

  • http, MCP 서버와의 HTTP 통신을 활성화합니다. 그런 다음 HTTP 사용하여 웹 클라이언트 에서 MCP 서버와 상호 작용 하거나 특정 HTTP IP 포트에서 MCP 서버와 통신할 수 있습니다.

    경고

    적절한 인증 및 보안 조치를 구현하지 않은 프로덕션 환경에서는 HTTP 전송을 사용하지 않는 것이 좋습니다.

httpPort

MDB_MCP_HTTP_PORT

integer

3000

MCP 서버와의 HTTP 통신을 위한 IP 포트 번호입니다.

httpHost

MDB_MCP_HTTP_HOST

문자열

127.0.0.1

MCP 서버와의 HTTP 통신을 위한 IP 주소 .

Streamable HTTP 사용하면 MCP 서버가 기본값 으로 localhost (127.0.0.1) 에 바인딩됩니다. 이렇게 하면 MCP 서버가 동일한 컴퓨터에서 시작되는 연결만 허용합니다.

경고

0.0.0.0 에 바인딩하면 MCP 서버가 전체 로컬 네트워크에 노출되어 동일한 네트워크의 다른 장치가 잠재적으로 MCP 서버에 액세스 수 있습니다. 이는 보안 위험이며 데이터베이스 컨텍스트에 대한 무단 액세스 허용할 수 있습니다. MCP 서버를 localhost 외부에 노출해야 하는 경우 강력한 보안 인증구현.

자세한 학습 은 원격 연결을 참조하세요.

idleTimeoutMs

MDB_MCP_IDLE_TIMEOUT_MS

integer

600000

클라이언트 연결 해제의 유휴 시간 초과입니다. HTTP 전송에만 적용됩니다.

notificationTimeoutMs

MDB_MCP_NOTIFICATION_TIMEOUT_MS

integer

540000

클라이언트 연결 해제를 인식하기 위한 알림 시간 초과입니다. HTTP 전송에만 적용됩니다.

authenticationMechanism

MDB_MCP_AUTHENTICATION_MECHANISM

문자열

SCRAM-SHA-256

SCRAM 은 MongoDB 의 기본값 인증 메커니즘 입니다. 다른 인증 방법을 사용하여 MongoDB MCP 서버 로 MongoDB deployment에 연결하려면 다음 페이지를 참조하세요.

exportsPath

MDB_MCP_EXPORTS_PATH

문자열

운영 체제에 따라 다릅니다.

내보낸 데이터 파일을 저장하는 디렉토리입니다.

내보내기 경로 및 운영 체제 세부 정보에 대한 자세한 내용은 MongoDB MCP 서버에서 데이터 내보내기를 참조하세요.

exportTimeoutMs

MDB_MCP_EXPORT_TIMEOUT_MS

integer

300000

내보낸 데이터 파일이 MCP 서버 정리 프로세스 에서 삭제될 수 있는 시간(밀리초)입니다.

exportCleanupIntervalMs

MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS

integer

120000

만료된 내보내기 데이터 파일을 삭제하는 MCP 서버 정리 프로세스 의 자동 실행 사이의 시간(밀리초)입니다. 정리 프로세스 자동으로 실행 됩니다.

위치 인수

MCP 서버는 CLI 플래그를 지정하지 않고 제공할 수 있는 위치 인수를 허용합니다. 첫 번째 위치 인수는 MongoDB deployment 대한 연결 문자열 로 해석됩니다.

보안 모범 사례는 MDB_MCP_CONNECTION_STRING 환경 변수를 사용하여 연결 문자열 설정하다 입니다. 환경 변수가 옵션이 아닌 경우 첫 번째 위치 인수를 사용하세요. 예시 를 들면 다음과 같습니다.

"args": [
   "-y",
   "mongodb-mcp-server",
   "mongodb+srv://<user-name>:<password>@<cluster-name>.mongodb.net/",
   "--readOnly"
]

자세히 알아보기

돌아가기

구성

다음

방법

이 페이지의 내용