/ /

MongoDB MCP 서버 구성 옵션

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

옵션 목록

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

중요

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

CLI 옵션 이름	OS 환경 변수 이름	유형	기본값	설명
`allowRequestOverrides`	`MDB_MCP_ALLOW_REQUEST_OVERRIDES`	부울	`false`	사용자가 요청 헤더 및 쿼리 매개변수를 사용하여 요청별로 MCP 서버 구성을 재정의할 수 있는지 여부를 나타내는 플래그입니다. 각 구성 옵션의 구체적인 재정의 동작은 아래의 재정의 동작 표 를 참조하세요.
`apiClientId`	`MDB_MCP_API_CLIENT_ID`	문자열	설정하다 되지 않음	인증 위한 Atlas API 클라이언트 ID .
`apiClientSecret`	`MDB_MCP_API_CLIENT_SECRET`	문자열	설정하다 되지 않음	인증 위한 Atlas API 클라이언트 시크릿입니다.
`config`	`MDB_MCP_CONFIG`	문자열	설정하다 되지 않음	JSON 설정 파일 의 전체 경로입니다. `--config` 명령줄 옵션을 사용하는 것보다 `MDB_MCP_CONFIG` 환경 변수를 사용하는 것이 좋습니다.
`connectionString`	`MDB_MCP_CONNECTION_STRING`	문자열	설정하다 되지 않음	데이터베이스 직접 연결을 위한 연결 문자열입니다. 클라이언트 클러스터 에 직접 연결할 수 있도록 런타임에 연결 문자열 설정합니다. 중요 `--connectionString` CLI 인수는 더 이상 사용되지 않습니다. 대신 `MDB_MCP_CONNECTION_STRING` 환경 변수를 사용하세요. 환경 변수가 옵션이 아닌 경우 첫 번째 위치 인수를 사용하세요. 참고 일반적으로 연결 자격 증명 대규모 언어 모델에 노출되므로 런타임에 연결 문자열 제공하지 않는 것이 좋습니다. 연결 문자열 클라이언트 이전에 연결한 적이 없거나 이전에 클라이언트 적이 있는 경우 클라이언트 새 클러스터 로 연결을 전환하는 경우에 사용됩니다. 클라이언트가 연결 또는 연결 전환 도구를 호출한 후, 클라이언트는 후속 작업에 동일한 연결을 재사용합니다. 따라서 연결 또는 전환 연결 도구를 한 번만 호출하거나 다른 연결로 전환해야 하는 경우에만 호출하면 됩니다.
`dryRun`	`MDB_MCP_DRY_RUN`	부울	`false`	테스트 실행 옵션을 사용하여 MCP 서버 구성을 검사합니다. 테스트 실행 옵션을 활성화하면 MCP 서버가 MCP 서버 구성 설정과 활성화된 MongoDB MCP 서버 도구목록을 반환합니다. 테스트 실행 옵션을 활성화하려면 설정 파일 또는 명령줄에서 `--dryRun` 을(를) 설정하거나, `MDB_MCP_DRY_RUN` 운영 체제 환경 변수를 `true`(으)로 설정하십시오. 자세한 내용은 MCP 서버 테스트 실행 모드 활성화를 참조하세요.
`externallyManagedSessions`	`MDB_MCP_EXTERNALLY_MANAGED_SESSIONS`	부울	`false`	클라이언트가 세션 초기화를 건너뛸 수 있도록 합니다. 활성화되면 클라이언트는 자체 생성된 세션 ID 사용하여 도구를 직접 호출할 수 있습니다. 이러한 세션은 서버 에 암시적으로 생성되며 `idleTimeoutMS` 이 만료될 때까지 활성 상태로 유지됩니다. 이는 일반적으로 AgentCore 프레임워크 내부적으로 세션을 관리하고 각 세션에 대한 온디맨드 방식으로 MCP 서버를 생성하는 AWS 베드락과의 통합에 유용합니다. 중요 세션 보안을 강화하려면 세션 ID가 고유하고 예측할 수 없는지 확인하세요.
`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 서버 로그를 저장하는 디렉토리입니다. 참고 MCP 서버 실행 사용자가 읽기/ 쓰기 (write) 권한으로 디렉토리를 소유하도록 디렉토리 잠급니다. 이렇게 하면 다른 프로세스 서버 디렉토리나 파일에 액세스할 수 없습니다. 로그 경로 및 운영 체제 세부 사항에 대한 자세한 내용은 MongoDB MCP 서버 문제 해결을 참조하세요.
`disabledTools`	`MDB_MCP_DISABLED_TOOLS`	배열	설정하다 되지 않음	비활성화할 MCP 도구 이름, 작업 유형 또는 도구 범주의 배열입니다. 자세한 내용은 MCP 서버 도구 비활성화를 참조하세요.
`readOnly`	`MDB_MCP_READ_ONLY`	부울	`false`	쓰기 (write) 작업이 허용되는지 여부를 결정하는 플래그입니다. 클러스터 쓰기 (write) 작업을 비활성화하려면 설정 파일 또는 명령줄 에서 `--readOnly` 을(를) 설정하거나 `MDB_MCP_READ_ONLY` 운영 체제 환경 변수를 `true`(으)로 설정하십시오. 기본값은 클러스터 쓰기 (write) 작업을 허용하는 것입니다. 일반적으로 항상 읽기 전용 모드 활성화 . 자세한 내용은 MCP 서버 읽기 전용 모드 활성화를 참조하세요.
`indexCheck`	`MDB_MCP_INDEX_CHECK`	부울	`false`	쿼리에 인덱스가 필요한지 여부를 나타내는 플래그입니다. `true`인 경우 쿼리 작업에서 인덱스 사용해야 하도록 강제하고 컬렉션 스캔을 수행하는 쿼리를 거부합니다. 자세한 내용은 인덱스 검사 활성화를 참조하세요.
`telemetry`	`MDB_MCP_TELEMETRY`	문자열	`enabled`	MCP 서버에서 사용 데이터를 수집하는지 여부를 나타내는 플래그입니다. `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` 외부에 노출해야 하는 경우 강력한 보안 인증구현. 자세한 학습 은 원격 연결을 참조하세요.
`httpBodyLimit`	`MDB_MCP_HTTP_BODY_LIMIT`	integer	`102400`	HTTP 요청 본문의 최대 크기(바이트)입니다. HTTP 전송에만 적용됩니다.
`httpResponseType`	`MDB_MCP_HTTP_BODY_RESPONSE_TYPE`	문자열	`sse`	MCP 서버 의 응답을 제어합니다. 유효한 값은 `sse` 또는 `json`입니다. 클라이언트가 `sse` 연결을 설정할 수 없는 경우 `json` 응답 유형을 사용하도록 선택할 수 있습니다. `json` 응답 유형을 선택하면 서버 클라이언트 와의 통신을 시작할 수 없습니다( 예시: 알림 또는 로그).
`healthCheckHost`	`MDB_MCP_HEALTH_CHECK_HOST`	문자열	설정하다 되지 않음	별도의 healthCheck HTTP 서버 의 호스트 주소 . 이는 Kubernetes 및 Docker MCP 프로세스 의 상태를 확인하는 데 사용할 수 있는 HTTP 엔드포인트입니다. HTTP 전송에만 적용됩니다. 제공된 경우 `healthCheckPort` 설정이 필요합니다.
`healthCheckPort`	`MDB_MCP_HEALTH_CHECK_PORT`	integer	설정하다 되지 않음	별도의 healthCheck HTTP 서버 의 포트 번호입니다. 이는 Kubernetes 및 Docker MCP 프로세스 의 상태를 확인하는 데 사용할 수 있는 HTTP 엔드포인트입니다. HTTP 전송에만 적용됩니다. 제공된 경우 `healthCheckHost` 설정이 필요합니다.
`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`	MongoDB MCP 서버를 사용하여 MongoDB 배포서버에 연결할 때 사용하는 인증 메커니즘입니다. SCRAM 은 MongoDB 의 기본값 인증 메커니즘 입니다. 다른 인증 방법을 사용하여 연결하려면 다음 페이지를 참조하세요. OpenID Connect(OIDC)로 연결 LDAP로 연결 Kerberos 와 연결 X에 연결합니다.509 인증서 프록시와 연결
`exportsPath`	`MDB_MCP_EXPORTS_PATH`	문자열	운영 체제에 따라 다릅니다.	내보낸 데이터 파일을 저장하는 디렉토리입니다. 참고 MCP 서버 실행 사용자가 읽기/ 쓰기 (write) 권한으로 디렉토리를 소유하도록 디렉토리 잠급니다. 이렇게 하면 다른 프로세스 내보낸 디렉토리나 파일에 액세스할 수 없습니다. 내보내기 경로 및 운영 체제 세부 정보에 대한 자세한 내용은 MongoDB MCP 서버에서 데이터 내보내기를 참조하세요.
`exportTimeoutMs`	`MDB_MCP_EXPORT_TIMEOUT_MS`	integer	`300000`	내보낸 데이터 파일이 MCP 서버 정리 프로세스 에서 삭제될 수 있는 시간(밀리초)입니다.
`exportCleanupIntervalMs`	`MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS`	integer	`120000`	만료된 내보내기 데이터 파일을 삭제하는 MCP 서버 정리 프로세스 의 자동 실행 사이의 시간(밀리초)입니다. 정리 프로세스 자동으로 실행 됩니다.
`previewFeatures`	`MDB_MCP_PREVIEW_FEATURES`	문자열	설정하다 되지 않음	활성화된 미리보기 기능의 쉼표로 구분된 값입니다. 유효한 값: `search`.

벡터 검색 옵션

중요

MCP의 벡터 검색 지원은 미리보기 기능으로 제공됩니다. previewFeatures 이 MDB_MCP_PREVIEW_FEATURES 기능 활성화 search 하려면 MCP 구성에서플래그 또는 환경 변수를 로 설정하다 .

다음 옵션은 MCP 서버를 사용하여 MongoDB 벡터 검색을 사용할 때의 동작을 구성합니다.

CLI 옵션 이름	OS 환경 변수 이름	유형	기본값	설명
`voyageApiKey`	`MDB_MCP_VOYAGE_API_KEY`	문자열	설정하다 되지 않음	자동 임베딩 생성을 위한 Voyage AI API 키입니다. 이 옵션을 구성하면 MCP 서버가 다음에 대한 임베딩을 자동으로 생성합니다. `insert-many` 도구로 삽입하는 문서 `$vectorSearch` 집계 쿼리의 `queryVector` 매개변수 또한 MCP 서버는 벡터 검색 인덱스가 있는 필드에 유효한 임베딩 벡터가 포함되어 있는지 확인하여 벡터 검색 인덱스가 깨지는 것을 방지합니다. MongoDB MCP 서버 다음과 같은 Voyage AI 모델을 지원합니다. `voyage-3-large` `voyage-3.5` `voyage-3.5-lite` `voyage-code-3` Voyage AI 에 대해 자세히 학습하려면 Voyage AI 설명서를 참조하세요. 추가 벡터 검색 구성 옵션은 벡터 검색 옵션을 참조하세요.
`embeddingsValidation`	`MDB_MCP_EMBEDDINGS_VALIDATION`	부울	`true`	임베딩 벡터의 유효성을 검사하는지 여부를 나타내는 플래그입니다. `true`로 설정하다 하면 임베딩 차원의 유효성 검사 활성화됩니다. 기본값 으로 MCP 서버는 벡터 검색 인덱스가 있는 필드에 올바른 차원의 유효한 임베딩 벡터가 포함되어 있는지 확인하여 벡터 검색 인덱스가 깨지는 것을 방지합니다. 유효성 검사 없이 임베딩 필드에 원시 값을 삽입할 수 있도록 하려면 이 옵션을 비활성화합니다. 경고 임베딩 유효성 검사 비활성화하면 유효하지 않은 임베딩이 있는 문서가 벡터 검색 인덱스와 함께 사용할 수 없는 문서가 될 수 있습니다.
`vectorSearchDimensions`	`MDB_MCP_VECTOR_SEARCH_DIMENSIONS`	integer	`1024`	벡터 검색 임베딩의 기본값 차원 수입니다. 이 값은 벡터 검색 인덱스를 생성하고 임베딩의 유효성을 검사할 때 사용됩니다.
`vectorSearchSimilarityFunction`	`MDB_MCP_VECTOR_SEARCH_SIMILARITY_FUNCTION`	문자열	`euclidean`	벡터 검색 위한 기본값 유사성 함수입니다. 다음 값 중 하나로 설정합니다. `euclidean`: 유클리드 거리 `cosine`: 코사인 유사도 `dotProduct`: 내적 유사성 MCP 서버 별도로 지정하지 않는 한 벡터 검색 인덱스를 생성할 때 기본값 으로 이 값을 사용합니다. 자세한 학습 은 벡터 검색을 위한 필드 인덱싱 방법을 참조하세요.

구성 옵션 재정의 동작

다음 표에서는 각 구성 옵션의 재정의 동작에 대해 설명합니다. 이러한 재정의 동작은 allowRequestOverrides 구성 옵션이 true로 설정하다 경우에만 적용 . 사용자가 재정의를 금지하는 구성 옵션을 재정의하려고 하면 MCP 서버 연결을 거부합니다.

Config Key	동작 재정의	추가 조건
`apiBaseUrl`	금지됨
`apiClientId`	금지됨
`apiClientSecret`	금지됨
`allowRequestOverrides`	금지됨
`connectionString`	금지됨
`config`	금지됨
`loggers`	금지됨
`logPath`	금지됨
`disabledTools`	Merge	기존 구성에 있는 도구 외에 도구를 비활성화합니다.
`confirmationRequiredTools`	Merge	기존 구성의 도구 외에 도구의 확인이 필요합니다.
`readOnly`	조건부	기존 `false` 구성을 `true`로만 재정의할 수 있습니다.
`indexCheck`	조건부	기존 `false` 구성을 `true`로만 재정의할 수 있습니다.
`telemetry`	금지됨
`transport`	금지됨
`httpPort`	금지됨
`httpHost`	금지됨
`httpHeaders`	금지됨
`healthCheckHost`	금지됨
`healthCheckPort`	금지됨
`idleTimeoutMs`	조건부	기존 구성보다 짧은 시간 제한으로만 재정의할 수 있습니다.
`notificationTimeoutMs`	조건부	기존 구성보다 짧은 시간 제한으로만 재정의할 수 있습니다.
`maxBytesPerQuery`	금지됨
`maxDocumentsPerQuery`	금지됨
`exportsPath`	금지됨
`exportTimeoutMs`	조건부	기존 구성보다 짧은 시간 제한으로만 재정의할 수 있습니다.
`exportCleanupIntervalMs`	금지됨
`atlasTemporaryDatabaseUserLifetimeMs`	조건부	기존 구성보다 짧은 수명으로만 재정의할 수 있습니다.
`voyageApiKey`	금지됨
`embeddingsValidation`	조건부	기존 `false` 구성을 `true`로만 재정의할 수 있습니다.
`vectorSearchDimensions`	[readConcern] 재정의
`vectorSearchSimilarityFunction`	[readConcern] 재정의
`previewFeatures`	조건부	기존 구성의 기능만 비활성화할 수 있으며 추가 기능을 추가할 수는 없습니다.

위치 인수

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

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

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

자세히 알아보기

돌아가기

구성

방법

옵션 목록

중요

중요

참고

중요

참고

경고

경고

참고

벡터 검색 옵션

중요

경고

구성 옵션 재정의 동작

위치 인수

자세히 알아보기