← 소프트웨어 자료실
개발 · 데이터베이스

MongoDB Compass

MongoDB Compass는 MongoDB 데이터를 화면에서 조회·편집하고, 스키마와 쿼리 성능을 분석하는 무료 데스크톱 도구입니다.

공식 사이트로 이동 ↗

누가 사용하는 도구인가

Compass는 MongoDB 서버에 연결해 데이터를 탐색하는 공식 GUI입니다. 로컬 서버와 MongoDB Atlas에 연결할 수 있어, 개발자의 데이터 확인, 운영 담당자의 조회·성능 점검, 분석 담당자의 집계 작업에 적합합니다. Compass를 설치하는 것만으로 데이터베이스 서버가 생기지는 않습니다.

문서 구조와 쿼리 결과를 시각적으로 살펴보려는 경우에 유용하지만, 정확한 필터와 집계를 작성하려면 MongoDB의 자료형과 연산자를 이해해야 합니다. [제품 개요](https://www.mongodb.com/docs/compass/)

지원 OS와 현재 버전

2026년 10월 7일 확인한 공식 다운로드 페이지는 1.52.0을 안정판으로 표시합니다. 공식 릴리스 노트의 출시일은 2026년 10월 2일입니다. [릴리스 노트](https://www.mongodb.com/docs/compass/release-notes/)

등록 정보는 macOS만 기재하지만 실제 제품은 Windows와 Linux도 지원합니다. 다운로드 선택지에는 macOS 11 이상용 Apple Silicon arm64와 Intel x64 패키지, Windows 10 이상 64비트, Ubuntu 20.04 이상 및 RedHat 8 이상 64비트가 나옵니다. Mac에서는 칩 종류에 맞는 패키지를 고릅니다. [공식 다운로드](https://www.mongodb.com/try/download/compass)

macOS 설치와 첫 조회

공식 다운로드 페이지에서 Mac용 DMG를 선택합니다. 받은 파일을 열고 Compass를 응용 프로그램 폴더로 옮긴 뒤 실행하는 순서입니다. [공식 설치 문서 원본](https://github.com/mongodb/docs-compass/blob/master/source/install.txt)

실행 후 Add New Connection에서 연결 URI를 붙여 넣고 인증·TLS 설정을 확인해 연결합니다. Atlas에서는 대상 클러스터의 Connect 메뉴에서 Compass용 URI를 얻을 수 있습니다. 연결 이름과 색상으로 개발·운영 환경을 구분한 뒤 데이터베이스와 컬렉션을 열어 간단한 조회부터 시작합니다. URI 편집 시 비밀번호가 평문으로 보일 수 있으므로 인증 정보 수정에는 Authentication 탭을 이용합니다. [연결 절차](https://www.mongodb.com/docs/compass/connect/)

주요 기능과 주문 데이터 실무 예시

스키마 분석은 문서를 표본 추출해 필드 자료형, 날짜 범위, 자주 나타나는 값 등을 보여 줍니다. 집계 빌더는 단계마다 결과를 미리 볼 수 있고, Explain Plan과 인덱스 관리 기능은 느린 조회를 점검하는 데 쓰입니다. 표본에서 발견한 패턴을 전체 데이터의 확정적 통계로 해석하지 않는 것이 좋습니다. [기능 안내](https://www.mongodb.com/products/tools/compass)

예를 들어 주문 컬렉션에서 status가 paid인 문서를 필터링한 뒤, 집계의 $match로 대상을 제한하고 $group으로 지역별 amount 합계를 계산할 수 있습니다. 집계 전에 금액이 숫자형인지 확인하고, 결과만 내보내면 정산 검토용 자료를 만들 수 있습니다. 이는 활용 예시이며 실제 실행 결과를 의미하지 않습니다.

무료 여부와 에디션별 제약

공식 문서는 Compass를 무료로 사용할 수 있다고 명시합니다. 다운로드 페이지의 일반판, Readonly Edition, Isolated Edition은 기능과 네트워크 동작의 차이로 안내되며 유료 업그레이드 단계로 제시되지 않습니다. Readonly는 쓰기·삭제를 제한하고, Isolated는 MongoDB 연결 이외의 네트워크 연결을 차단합니다. [다운로드와 에디션](https://www.mongodb.com/try/download/compass)

Isolated에는 자동 업데이트와 AI 기능이 제공되지 않습니다. 일반판의 readOnly 옵션은 쓰기 UI를 숨기는 방식이므로 데이터베이스 수준의 읽기 전용 접근은 사용자에게 read 역할을 부여해야 합니다. Compass의 무료 사용을 연결 대상 클라우드 서비스 전체의 무료 이용으로 해석해서는 안 됩니다. [에디션 기능표](https://www.mongodb.com/docs/compass/editions/)

자주 겪는 문제와 확인 순서

연결 실패 시 오류 메시지를 먼저 읽고 서버 실행 여부, URI의 호스트·포트, 방화벽, Atlas의 현재 공인 IP 허용 목록 순으로 확인합니다. 쓰기 버튼이 비활성화되면 Readonly 에디션인지, 복제본 세트의 secondary에 연결했는지, 사용자 권한과 복제본 세트 설정이 맞는지 살펴봅니다. [연결 오류 문서](https://www.mongodb.com/docs/compass/troubleshooting/connection-errors/)

가져오기 오류는 JSON 문서 배열 또는 줄 단위 문서 형식, CSV 헤더와 필드 자료형부터 점검합니다. CSV 내보내기는 BSON 자료형 정보를 잃을 수 있으며 Compass 내보내기는 데이터베이스 백업을 대신하지 않습니다. [가져오기·내보내기](https://www.mongodb.com/docs/compass/import-export/)

다른 도구와 선택 기준 및 검토 항목

문서와 집계 중간 결과를 화면으로 비교하려면 Compass를, 명령 중심 작업에는 mongosh를, VS Code 안에서 데이터 탐색과 CRUD 작성까지 이어가려면 MongoDB 확장을 고려할 수 있습니다. 이는 각 도구의 공식 설명을 바탕으로 한 선택 기준입니다. [MongoDB 도구 안내](https://www.mongodb.com/try/download/compass)

검토 항목: Compass 본체는 최신 안정판에 대한 지원과 업데이트가 진행 중입니다. 예전 Compass Community 사용자는 저장 연결·쿼리·파이프라인의 이전 절차를 확인해야 합니다. 이번에 연 현재 업데이트 문서에는 Community의 정확한 지원 종료일이 명시되어 있지 않아 종료 날짜를 단정하지 않습니다. [업데이트 안내](https://www.mongodb.com/docs/compass/upgrade/)

공식 안내

주요 기능

  • 문서 조회 시 필터·정렬·표시 필드를 지정해 필요한 데이터만 탐색
  • JSON 또는 필드별 편집기로 문서 삽입·수정·삭제
  • 문서 표본을 분석해 필드 누락, 자료형 불일치, 값의 분포 확인
  • 집계 파이프라인을 단계별로 구성하고 중간 결과 미리 보기
  • 시각적 Explain Plan으로 쿼리 실행 과정과 성능 점검
  • 인덱스 생성·삭제 및 문서 검증 규칙 관리
  • JSON·CSV 가져오기와 필터 또는 집계 결과 내보내기
  • 내장 MongoDB Shell에서 JavaScript 명령 실행
광고

관련 프로그램

Docker Desktop

docker.com

Docker Desktop은 컨테이너 이미지 빌드와 실행, 여러 서비스의 개발 환경 관리를 GUI와 명령줄로 제공하는 개발 도구입니다.

개발macOS

Google Antigravity CLI

antigravity.google

Google Antigravity CLI는 터미널에서 자연어로 코드 수정·명령 실행을 요청하고, 여러 AI 에이전트의 작업과 결과를 관리하는 개발 도구입니다.

개발macOS

.NET SDK

microsoft.com

.NET SDK는 C#, F#, Visual Basic으로 앱과 라이브러리를 만들고 빌드·테스트·배포 파일을 생성하는 Microsoft의 무료 오픈소스 개발 도구입니다. macOS에서는 Apple Silicon용 Arm64와 Intel용 x64를 제공하며, 터미널과 원하는 편집기를 함께 사용해 콘솔 도구와 웹 서비스를 개발할 수 있습니다.

개발macOS

GitHub Copilot CLI

docs.github.com

GitHub Copilot CLI는 터미널에서 자연어로 코드 분석·수정·디버깅과 GitHub 작업을 요청하는 AI 코딩 에이전트입니다. macOS, Linux, Windows를 지원합니다.

개발macOS

Lens

lenshq.io

Lens는 Kubernetes 클러스터의 리소스, 로그, 메트릭을 데스크톱 화면에서 확인하고 관리하는 IDE다. 여러 개발·운영 환경을 오가는 개발자와 DevOps·SRE 담당자에게 적합하며, macOS 외에 Windows와 Linux도 지원한다.

개발macOS

Git Credential Manager

aka.ms

Git Credential Manager(GCM)는 Git의 HTTPS 인증을 처리하고 자격 증명을 보관하는 무료 오픈소스 도구다. macOS에서는 기본적으로 키체인을 사용하며, GitHub·Azure Repos·Bitbucket·GitLab 등 여러 호스팅 서비스의 인증을 지원한다. Git 명령을 실행할 때 필요한 로그인과 다중 인증을 연결해 준다.

개발macOS