MongoDB MCP 서버 문제 해결

인증 요구 사항

필수: Atlas API 자격 증명
apiClientId •(서비스 계정 ID) •(서비스
apiClientSecret 계정 비밀)

필수: Docker 런타임
• 추가 자격 증명 필요 없음
• 로컬 배포를 자동으로 관리합니다.

선택 사항: 다중 연결 방법
• 사전 구성된 연결 문자열
• 에 대한 Atlas 자격 증명 • 도구를 통한 atlas-connect-cluster
런타임 연결 connect
• 를 통한 로컬 배포서버 atlas-local-connect-deployment

연결 메서드

Atlas Management API 에 대한 API 기반 연결
• 직접 데이터베이스 연결 필요 없음
• Atlas REST API 엔드포인트 사용

로컬 배포서버 관리 • Docker 컨테이너

사용 • 외부 네트워크 액세스 필요 없음

MongoDB database 에 직접 연결합니다. 다양한 옵션 사용 가능:
• 구성된 연결 문자열
• 런타임 연결
프롬프트 • Atlas cluster 검색
• 로컬 배포서버 연결

권한 요구 사항

서비스 계정 역할(Atlas 프로젝트 수준):
•(읽기 작업의 경우 Project Read Only 최소)
•( 클러스터 생성/ 관리 의 Project Owner 경우)
•( 프로젝트 생성의 Organization Owner 경우)

시스템 요구 사항:
• Docker 런타임 권한
•
로컬 파일 시스템 액세스 • 컨테이너 관리 기능

데이터베이스 사용자 역할(해당되는 경우):
•(읽기 전용 readAnyDatabase 모드)
•(전체 readWriteAnyDatabase 작업)
• 특정 데이터베이스/컬렉션을 위한 사용자 지정 역할

구성 옵션

환경 변수:
MDB_MCP_API_CLIENT_ID 또는
MDB_MCP_API_CLIENT_SECRET

명령줄:
• --apiClientId
• --apiClientSecret

환경 변수:
•(선택 DOCKER_HOST 사항)

명령줄:
• 특정 MCP 구성이 필요하지
않습니다. • Docker 런타임을 자동으로 감지합니다.

환경 변수(선택 사항):
MDB_MCP_CONNECTION_STRING

명령줄(선택 사항):
• 위치 인수인 연결
--connectionString

문자열:
런타임 메서드: • LLM
프롬프트를 통한 대화형 연결 • Atlas 자격 증명 기반 검색

읽기 전용 모드 영향

• 읽기 작업: ✅ 사용 가능
• 클러스터 검사: ✅ 사용 가능
• 클러스터 생성: ❌ 비활성화됨
• 사용자 관리: ❌ 비활성화

• 로컬 배포서버 생성: ✅ 사용 가능
• 배포 검사: ✅ 사용 가능
• 컨테이너 관리: ✅ 사용 가능
• 읽기 전용 제한 없음

• 읽기 작업: ✅ 사용 가능
• 쿼리 작업: ✅ 사용 가능
• 애그리게이션: ✅ 또는 단계가 없는 한 사용할 $out 수 $merge 있습니다.
• 삽입/업데이트/삭제: ❌ 비활성화됨
• 인덱스 생성: ❌ 비활성화

도구 카테고리

또는 로 비활성화할 수 있습니다.
--disabledTools atlas
MDB_MCP_DISABLED_TOOLS="atlas"

또는 로 비활성화할 수 있습니다.
--disabledTools atlas
MDB_MCP_DISABLED_TOOLS="atlas"

또는 로 비활성화할 수 있습니다.
--disabledTools mongodb
MDB_MCP_DISABLED_TOOLS="mongodb"

네트워크 요구 사항

Atlas API 에 대한 아웃바운드 HTTPS:
• 표준 인터넷 연결

로컬 Docker 네트워크:• Docker 데몬 액세스

• 로컬 포트 가용성
• 외부 네트워크 요구 사항 없음

MongoDB cluster 에 연결(해당되는 경우):
• Atlas:(포트)mongodb+srv:// 27017
• 샤드 27016 클러스터(포트)
• 자체 관리: 사용자 지정 호스팅하다/port
• 로컬 배포: Docker 네트워크
• VPC/network 액세스 필요에 따라

사용 가능한 작업

• 조직
관리
• 프로젝트
관리 • 클러스터
수명 주기(생성, 검사, 삭제) • 데이터베이스 사용자 관리
• 액세스 목록 구성 • Performance Advisor
권장 사항 • 경고 관리

• 로컬 배포서버 생성 및 관리
• 컨테이너 수명 주기 운영
• 로컬 클러스터
구성 • 개발 환경 설정
• 배포서버 관리 테스트

• CRUD 작업(찾기, 삽입, 업데이트, 삭제)
• 집계 파이프라인
• 인덱스 관리
• 컬렉션 및 데이터베이스 관리
• 스키마 검사
• 벡터 검색 작업
• 데이터 내보내기

Error Scenarios

API 자격

증명 누락: Atlas 도구 반환: "Atlas API 자격 증명 구성되지 않음" 권한 부족:
403 Atlas API 의 HTTP 오류

Docker 사용할 수 없음:
"Docker 데몬 실행 아님" 또는 "Docker 설치되지 않음"

컨테이너 문제:
포트 충돌, 리소스 제약 조건

연결 실패(구성된 경우):
네트워크 시간 초과, 인증

실패 데이터베이스
권한 누락: MongoDB 권한 부여 오류

임시 자격 증명

해당 사항 없음:
영구 서비스 계정 자격 증명 사용

해당 사항 없음:
로컬 배포는 컨테이너 관리 인증 사용합니다.

자동 생성된 데이터베이스 사용자(해당되는 경우):
연결 문자열 없이 Atlas API

4자격 증명 사용하는 경우: • 임의의 사용자 이름/비밀번호 • 기본값 으로 시간
만료 • 자동 역할 할당