Visual Studio 코드 설정

이 문서 에는 VS Code 확장에 대해 구성 가능한 설정이 나열되어 있습니다.

설정 구성

VS Code 확장 설정을 구성하려면 다음을 수행합니다.

설정 보기를 엽니다.

운영 체제	메서드	작업
Any	Visual Studio 코드 메뉴	File / Code > Preferences > Settings
macOS	키보드 단축키	`Command` + `,`(을)를 누릅니다.
Windows 및 Linux	키보드 단축키	`Ctrl` + `,` 누르기

검색 창에서 " MongoDB Settings "를 검색합니다.

VS Code 확장 확장 설정이 표시됩니다. 변경 사항은 자동으로 저장됩니다.

설정

다음 표에는 VS Code 확장에 사용할 수 있는 설정이 나열되어 있습니다.

설정

설명

기본값

Shell

사용할 MongoDB Shell. 다음 중 하나를 선택합니다.

mongo (레거시 MongoDB Shell) 또는
mongosh (새로운 MongoDB Shell)

선택한 MongoDB Shell을 시작하려면 다음을 수행해야 합니다.

사용하려는 셸을 설치합니다.
셸 바이너리의 파일 경로를 포함하도록 시스템의 PATH 환경 변수를 구성합니다.

MongoDB Shell의 새 버전을 설치하는 경우 새 버전을 참조하도록 PATH 변수를 업데이트해야 합니다.

레거시 mongo shell 을 설치하려면 mongo shell 을 참조하세요.
mongosh 셸을 설치하고 PATH 변수를 구성하는 방법에 대한 지침은 MongoDB Shell 설치를 참조하세요.

mongosh

Show

활성화하면 Visual Studio Code 왼쪽 탐색 패널에 MongoDB 보기가 표시됩니다.

활성화됨

Max Number of Problems

VS Code 확장이 Visual Studio Code Problems 보기에서 생성하는 최대 문제 수입니다.

100

Trace: Server

MongoDB 언어 서버 로깅 설정.

프로젝트의 settings.json 파일에 있는 mongodbLanguageServer.trace.server 속성을 통해 이 설정을 편집합니다.

mongodbLanguageServer.trace.server 객체 내에서 다음을 지정할 수 있습니다.

format및
verbosity

출력 로그는 Output 보기의 드롭다운에서 MongoDB Language Server 를 선택하거나 언어 서버 프로토콜 검사기를 사용하여 볼 수 있습니다.

{
  "format": "json",
  "verbosity": "verbose"
}

Confirm Run All

활성화된 경우 플레이그라운드에서 명령을 실행하기 전에 확인 메시지를 표시합니다.

활성화됨

Default Connection Saving Location

새 연결을 저장할지 여부와 저장 위치를 설정합니다.

선택할 수 있습니다:

설정	설명
`Global`	모든 작업 공간에서 액세스할 수 있도록 VS Code에 연결을 전역적으로 저장하세요.
`Workspace`	작업 공간에 연결을 저장합니다. 다른 작업 공간에서는 연결에 액세스할 수 없습니다.
`Session`	현재 VS Code 세션에 대해서만 연결을 저장합니다. VS Code를 닫으면 연결이 해제됩니다.

Global

Hide Option To Choose Where To Save New Connections

비활성화된 경우 각 새 연결을 저장할 위치를 선택하라는 메시지가 표시됩니다.

활성화되면 메시지 없이 새 연결이 자동으로 Default Connection Saving Location에 저장됩니다.

활성화됨

Default Limit

컬렉션에서 문서를 볼 때 가져올 문서 수입니다. 플레이그라운드 운영에는 영향을 미치지 않습니다.

10

Preset Connections

미리 설정된 연결 목록을 지정합니다. 이 설정을 사용하여 작업 공간 또는 글로벌 범위에서 연결 구성을 주식 .

프로젝트의 settings.json 파일 에서 mdb.presetConnection 속성 편집합니다.

mdb.presetConnections 객체 내에서 다음을 지정할 수 있습니다.

연결을 위한 name 입니다.
배포서버 위한 connectionString 입니다.

경고: 이 설정에 민감한 자격 자격 증명 저장 하지 마세요. 연결 문자열은 일반 텍스트로 저장되므로 쉽게 액세스할 수 있습니다.

[
   {
      "name": "Preset Connection",
      "connectionString": "mongodb://localhost:27017"
   }
]

Send Telemetry

활성화하면 VS Code 확장을 개선하기 위해 익명의 진단 및 사용 원격 분석 데이터를 컬렉션 할 수 있습니다.

활성화됨

Use Default Template For Playground

활성화하면 플레이그라운드 파일이 샘플 명령이 포함된 템플릿과 함께 로드됩니다.

비활성화하면 플레이그라운드 파일이 빈 플레이그라운드 편집기로 로드됩니다.

활성화됨

Show Overview Page After Install

활성화된 경우 VS Code 확장은 설치 후 시작하는 데 도움이 되는 개요 페이지를 표시합니다.

비활성화하면 설치 후 VS Code 확장에 개요 페이지가 표시되지 않습니다. 이는 작업 환경이 이미 설정하다 GitHub Codespaces와 같은 컨테이너화된 환경에서 유용합니다. 이러한 환경에서는 작업 영역을 만들 때마다 개요 페이지를 볼 필요가 없습니다.

활성화됨

MCP: Server

VS Code 열리고 활성 연결에 연결할 때 MongoDB MCP 서버 자동으로 시작되는지 여부를 제어합니다.

ask로 설정하다 확장 프로그램이 MCP 서버 자동으로 시작한 다음 이 동작을 유지할지 여부를 묻습니다. 설정이 ask로 유지되면 VS Code 시작할 때마다 이 알림이 나타납니다.
활성화하면 VS Code 열릴 때 서버 자동으로 시작됩니다.
비활성화하면 서버 자동으로 시작되지 않으며 MCP 서버 시작 명령을 사용하여 서버 수동으로 시작해야 합니다.

참고

서버 처음 자동으로 시작되면 VS Code 이 동작을 유지할지 묻는 알림을 표시합니다. 선택하면 이 설정이 자동으로 업데이트됩니다.

MCP 서버 실행 아닌 경우 MongoDB: MCP 서버 시작 명령을 사용하여 MCP 서버 즉시 시작합니다.

ask

MCP: Api Base URL

사용자 지정 Atlas 배포서버 사용하는 경우, Atlas MCP 도구를 활성화하는 MongoDB MCP 서버 에서 사용하는 API URL 지정합니다.

https://cloud.mongodb.com/

MCP: Api Client ID

Atlas API 에 대한 인증을 위한 Atlas API 클라이언트 ID . Atlas API에 프로그래밍 방식으로 액세스 서비스 계정을 사용하세요. MongoDB MCP 서버 에서 Atlas 도구를 활성화하는 데 필요합니다. ID 안전하게 저장하고 버전 관리에 커밋 하지 마세요.

자세히 학습 Atlas API 자격 증명으로 연결하기를 참조하세요.

빈 형식

MCP: Api Client Secret

Atlas API 에 대해 인증하기 위한 Atlas API 클라이언트 시크릿입니다. Atlas API에 프로그래밍 방식으로 액세스 서비스 계정을 사용하세요. MongoDB MCP 서버 에서 Atlas 도구를 활성화하는 데 필요합니다. 이를 안전하게 저장하고 버전 관리를 커밋 하지 마세요.

자세히 학습 Atlas API 자격 증명으로 연결하기를 참조하세요.

빈 형식

MCP: Disabled Tools

MongoDB MCP 서버 사용할 때 비활성화할 도구 이름, 작업 유형(create, update, delete, read, metadata) 또는 카테고리(atlas, mongodb)입니다.

빈 형식

MCP Export Cleanup Interval Ms

MongoDB MCP 서버 만료된 파일을 제거 위해 내보내기 정리 프로세스 실행하는 빈도(밀리초)입니다. 기본값은 2 분(120000ms)입니다.

120000

MCP Exports Path

내보내기 도구를 사용할 때 MongoDB MCP 서버 데이터를 내보내는 디렉토리 입니다. 운영 체제에 따라 기본값 경로를 사용하려면 경로를 쓰기에 사용할 수 있는지 확인하거나 이 설정을 비워 두세요.

기본 경로:

Windows: %LOCALAPPDATA%\mongodb\mongodb-mcp\exports
macOS 및 Linux: ~/.mongodb/mongodb-mcp/exports

빈 형식

MCP Export Timeout Ms

MongoDB MCP 서버 내보내기 작업을 종료하기 전에 실행 수 있는 최대 시간(밀리초)입니다. 기본값은 5 분(300000ms)입니다.

300000

MCP Index Check

활성화되면 MongoDB MCP 서버 쿼리 작업에서 인덱스 사용해야 하도록 강제하고 컬렉션 스캔 수행하는 쿼리를 거부합니다. 이렇게 하면 프로덕션 환경에서 성능 문제를 방지하는 데 도움이 됩니다.

비활성화

MCP: Read Only

활성화되면 MongoDB MCP 서버 읽기, 연결 및 메타데이터 작업 유형만 허용합니다. 만들기, 업데이트 및 삭제 작업이 비활성화됩니다.

비활성화

돌아가기

명령.

로그