/ /

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 클라이언트 시크릿입니다.
`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 서버 테스트 실행 모드 활성화를 참조하세요.
`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` 외부에 노출해야 하는 경우 강력한 보안 인증구현. 자세한 학습 은 원격 연결을 참조하세요.
`httpBodyLimit`	`MDB_MCP_HTTP_BODY_LIMIT`	integer	`102400`	HTTP 요청 본문의 최대 크기(바이트)입니다. HTTP 전송에만 적용됩니다.
`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에 연결하려면 다음 페이지를 참조하세요. OpenID Connect(OIDC)로 연결 LDAP로 연결 Kerberos 와 연결 X에 연결합니다.509 인증서 프록시와 연결
`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 서버 정리 프로세스 의 자동 실행 사이의 시간(밀리초)입니다. 정리 프로세스 자동으로 실행 됩니다.
`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 설명서를 참조하세요. 추가 벡터 검색 구성 옵션은 벡터 검색 옵션을 참조하세요.
`disableEmbeddingsValidation`	`MDB_MCP_DISABLE_EMBEDDINGS_VALIDATION`	부울	`false`	`true`(으)로 설정하다 하면 임베딩 차원의 유효성 검사 비활성화합니다. 기본값 으로 MCP 서버는 벡터 검색 인덱스가 있는 필드에 올바른 차원의 유효한 임베딩 벡터가 포함되어 있는지 확인하여 벡터 검색 인덱스가 깨지는 것을 방지합니다. 유효성 검사 없이 임베딩 필드에 원시 값을 삽입할 수 있도록 하려면 이 옵션을 활성화합니다. 경고 임베딩 유효성 검사 비활성화하면 유효하지 않은 임베딩이 있는 문서가 벡터 검색 인덱스와 함께 사용할 수 없는 문서가 될 수 있습니다.
`vectorSearchDimensions`	`MDB_MCP_VECTOR_SEARCH_DIMENSIONS`	integer	`1024`	벡터 검색 임베딩의 기본값 차원 수입니다. 이 값은 벡터 검색 인덱스를 생성하고 임베딩의 유효성을 검사할 때 사용됩니다.
`vectorSearchSimilarityFunction`	`MDB_MCP_VECTOR_SEARCH_SIMILARITY_FUNCTION`	문자열	`euclidean`	벡터 검색 위한 기본값 유사성 함수입니다. 다음 값 중 하나로 설정합니다. `euclidean`: 유클리드 거리 `cosine`: 코사인 유사도 `dotProduct`: 내적 유사성 MCP 서버 별도로 지정하지 않는 한 벡터 검색 인덱스를 생성할 때 기본값 으로 이 값을 사용합니다. 자세한 학습 은 벡터 검색을 위한 필드 인덱싱 방법을 참조하세요.

위치 인수

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

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

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

자세히 알아보기

돌아가기

구성

방법

옵션 목록

중요

중요

참고

경고

경고

벡터 검색 옵션

중요

경고

위치 인수

자세히 알아보기