중요
이 페이지에 설명된 기능 현재 공개 미리 보기 중에 Atlas Infinite 클러스터에서 지원되지 않습니다. 공개 미리 보기에서 지원되는 기능은 공개 미리 보기 가용성을 참조하세요.
MongoDB MCP 서버를 언어 하면 MongoDB 데이터 및 AI 클라이언트의 배포와 상호 작용 작용할 수 있습니다.
MongoDB MCP 서버는 MongoDB Atlas, MongoDB Atlas Local, MongoDB Community Edition 및 MongoDB Enterprise Advanced 포함한 모든 MongoDB 배포서버 에서 사용할 수 있습니다.
MongoDB 사용자가 직접 실행 하고 관리 MongoDB MCP Server용 로컬 MCP와 Atlas 에서 사용자를 대신하여 호스팅하고 관리하는 MongoDB MongoDB Atlas 관리형 MCP Server, 이렇게 두 가지 MCP Server 배포서버 유형을 제공합니다. 자세한 학습 은 MongoDB MCP 서버란 무엇인가요?를 참조하세요. 아래.
MCP(Model Context Protocol)란 무엇인가요?
MCP(Model Context Protocol)는 LLM이 외부 리소스 및 서비스에 연결되고 상호 작용 방법을 표준화하기 위해 Athroughic에서 개발한 개방형 표준입니다. MCP는 다음과 같은 주요 구성 요소를 가진 클라이언트-서버 아키텍처로 구성됩니다.
MCP Host: 채팅 인터페이스 또는 IDE와 같이 MCP를 사용하려는 애플리케이션 또는 환경입니다. 예시 를 들어, Claude Desktop 또는 VS Code.
MCP 클라이언트: MCP 서버에 대한 연결을 처리하다 호스팅하다 내의 구성 요소입니다. MCP를 지원 클라이언트 목록은 MCP 클라이언트를 참조하세요.
MCP 서버: 특정 기능을 클라이언트에 노출하는 프로그램입니다. 예시: MongoDB MCP 서버.
MCP 서버가 클라이언트에 기능을 노출하는 프라이머리 방법은 도구를 사용하는 것입니다. 도구는 LLM이 MongoDB 와 같은 외부 데이터 소스와 상호 작용하는 등 특정 작업을 수행할 활성화 미리 정의된 실행 가능한 함수입니다.
MongoDB MCP 서버란 무엇인가요?
MongoDB MCP 서버는 MongoDB 데이터 및 배포와 상호 작용 데 사용할 수 있는 도구 설정하다 를 AI 클라이언트 에 제공하는 공식 MCP 서버 구현 입니다. 이러한 도구에는 클러스터 리소스 관리, 쿼리 및 인덱싱 과 같은 데이터베이스 작업, Performance Advisor 통한 성능 최적화와 같은 다양한 관리 조치가 포함됩니다.
MongoDB는 MongoDB MCP 서버에 대한 두 가지 배포 유형을 제공합니다.
MongoDB MCP 서버용 로컬 MCP: MCP 서버를 직접 실행하고 AI 에이전트 연결 및 MCP 서버 인프라스트리를 직접 관리합니다.
MongoDB Atlas Managed MCP Server: MongoDB는 Atlas에서 MCP 서버를 실행하고 AI 에이전트 연결 및 MCP 서버 인프라스트를 관리합니다.
MongoDB MCP Plugin이나 설정 파일을 사용하여 두 가지 배포서버 유형을 설정할 수 있습니다.
AI 클라이언트용 MongoDB MCP 플러그인: AI 클라이언트의 마켓플레이스에서 MongoDB 설치합니다. AI 클라이언트 는 AI 모델에 프롬프트를 표시하는 데 사용하는 인터페이스입니다. MongoDB Atlas 관리형 MCP 서버용 MongoDB MCP 플러그인은 대화형 AI 클라이언트에 대한 사용자 위임 액세스 제공합니다.
수동 구성 파일 설정: MongoDB MCP 서버 구성 및 OAuth 클라이언트 자격 증명 AI 클라이언트 의 구성 파일 에 수동으로 추가합니다. 이 설정 경로는 프로그래밍 에이전트로 작업하는 데 가장 적합합니다. 프로그래매틱 에이전트는 사용자의 입력이나 지침 없이도 다단계 워크플로를 실행 수 있는 자동화된 워크플로 기반 에이전트입니다.
다음 표는 MongoDB MCP 서버용 로컬 MCP와 MongoDB Atlas managed MCP 서버를 비교합니다. 이를 사용하여 필요에 가장 적합한 배포서버 유형을 선택하세요.
Local MCP for MongoDB MCP 서버 | MongoDB Atlas Managed MCP 서버 | |
|---|---|---|
호스팅 모델 | MongoDB MCP 서버는 사용자가 직접 설치, 실행 및 유지합니다. 서버 업그레이드, 연결 및 자격 증명 로터이션은 사용자의 책임입니다. | MongoDB는 Atlas에서 MongoDB MCP 서버를 호스팅하고 실행하며 유지관리합니다. 배포, 업그레이드 또는 운영할 MCP 서버 인프라가 없습니다. |
지원되는 데이터베이스 배포 | 자체 관리형(온프레미스) 및 Atlas(클라우드) | Atlas(클라우드)만 |
액세스 제어 수준 | 컬렉션 수준 데이터 플레인 액세스 | 프로젝트 수준 데이터 플레인 액세스 |
최적 대상 | MongoDB MCP 서버가 실행되는 장소와 MongoDB 배포서버에 연결되는 방식을 직접 그래뉴러하게 제어하려는 사용자. | MongoDB가 서버를 호스팅하고 관리하기를 원하는 Atlas 배포서버 사용자. |
MongoDB Atlas Managed MCP 서버
MongoDB Atlas Managed MCP 서버를 사용하면 MongoDB가 사용자가 자체 마신 또는 인프라스트럭처에서 서버를 실행할 필요 없이 Atlas에서 MongoDB MCP 서버를 호스팅하고 관리합니다. MongoDB가 서버를 운영하므로 사용자는 MCP 인프라스트럭처를 배포, 업그레이드 또는 유지관리할 필요가 없으며 Atlas 배포서버에 연결하기 위한 연결 문자열, 시크릿 또는 인증서를 관리할 필요가 없습니다.
MongoDB Atlas managed MCP 서버는 다음과 같은 장점을 제공합니다.
간소화된 배포서버 액세스: MongoDB MCP 플러그인을 사용하여 MongoDB Atlas 관리형 MCP 서버에 연결하는 경우, 서비스 계정 자격 증명 관리 할 필요 없이 Atlas 앱 연결을 사용하여 데이터베이스 배포에 직접 액세스 할 수 있습니다.
넓은 사용자 지원: MongoDB Atlas Managed MCP Server는 대화형 AI 클라이언트를 사용하는 사용자와 프로그래밍 에이전트를 사용하는 사용자 모두를 지원합니다.
관리자 거버넌스 제어: AI 클라이언트에 대한 조직 수준 선택 및 읽기 전용 강제, 구성 별 역할, IP 액세스 목록, 프로그래밍 에이전트에 대한 읽기 전용 설정 등이 포함됩니다.
Local MCP for MongoDB MCP 서버
MongoDB MCP 서버의 로컬 MCP는 자체 관리형 MongoDB MCP 서버 경로입니다. MCP 서버를 직접 실행하고 MongoDB 배포서버 및 도구에 수동으로 연결합니다.
MCP 서버가 실행되는 방식과 장소를 직접 제어하려면 Local MCP를 사용하세요. 이러한 제어권을 확보하는 대신 서버 업그레이드 및 자격 증명 관리를 포함하여 서버를 호스팅하고 유지관리해야 합니다.
MongoDB Atlas Local, MongoDB Community Edition 및 MongoDB Enterprise Advanced 등과 같은 로컬 배포 유형으로 MongoDB MCP 서버를 사용하려면 Local MCP를 사용합니다.
사용 사례
MongoDB MCP Server를 사용하면 언어 사용하여 MongoDB 데이터 및 배포서버와 상호 작용 수 있으므로 개발자 워크플로를 간소화하고 AI 인터페이스에서 복잡한 작업을 더 쉽게 수행할 수 있습니다. 예시 를 들어 MongoDB MCP 서버는 다음과 같은 사용 사례를 지원합니다.
사용 사례 | 설명 | 프롬프트 예시 |
|---|---|---|
데이터 탐색 | 데이터베이스 스키마 와 관계를 학습하고 설명합니다. |
|
데이터베이스 작업 | MongoDB 컬렉션에서 데이터를 생성하고, 읽고, 업데이트, 삭제 . |
|
데이터베이스 관리 | 관리 작업을 수행하여 클러스터, 데이터베이스 사용자 등을 관리 . |
|
코드 생성 | 필요한 데이터를 설명한 다음 관련 MongoDB 쿼리와 애플리케이션 코드를 생성합니다. |
|
성능 최적화 | 쿼리 성능을 분석하고 인덱스 및 스키마 개선을 위한 권장 사항을 받으세요. |
|
MongoDB MCP 서버에서 사용할 수 있는 특정 도구 목록은 MongoDB MCP 서버 도구에서 확인할 수 있습니다.
설정 방법
AI 클라이언트 마켓플레이스의 MongoDB MCP 플러그인을 사용하거나 AI 클라이언트의 설정 파일에 MongoDB MCP 서버를 수동으로 구성하여 MongoDB MCP 서버 및 MongoDB Atlas managed MCP 서버에 대한 로컬 MCP를 설정할 수 있습니다.
사용자 위임 액세스용 MongoDB MCP 플러그인
MongoDB MCP 플러그인은 사용자가 AI 클라이언트에게 사용자 위임 액세스를 제공하여 MongoDB 배포서버를 탐색할 수 있도록 도와줍니다. 이 방법은 Atlas 앱 연결을 사용하여 Atlas 인식이 연결된 OAuth 플로우를 통해 AI 클라이언트가 Atlas 리소스에 액세스할 수 있도록 승인합니다.
이 방법은 managed MCP 인프라스트루처 또는 자격 증명이 필요하지 않습니다. MongoDB MCP 플러그인과 함께:
AI 클라이언트의 마켓플레이스에서 MongoDB를 커넥터 또는 플러그인으로 찾아 Atlas 앱 연결을 사용하여 인증합니다.
AI 클라이언트는 Atlas 인증을 사용하여 사용자를 대리하여 작업합니다.
토큰 새로 고침은 자동으로 실행됩니다. 연결 문자열, 시크릿 또는 인증서를 관리할 필요가 없습니다.
연결한 AI 클라이언트를 언제든지 보고 회수할 수 있습니다.
OAuth 클라이언트 자격 증명을 사용한 설정 파일 설정
AI 클라이언트의 설정 파일에 MongoDB MCP 서버 설정을 수동으로 추가할 수 있습니다. 이 설정 방법은 특히 프로그래밍 에이전트 액세스에 유용합니다.
사용하는 자격 증명은 배포서버 유형에 따라 다릅니다.
MongoDB MCP 서버용 로컬 MCP의 경우 클러스터 연결 문자열과 Atlas 도구에 대한 선택 사항 Atlas API 자격 증명을 포함하여 MongoDB 배포에 연결하기 위한 자격 증명을 추가합니다.
MongoDB Atlas Managed MCP Server의 경우 Atlas Organization Owner 또는 Project Owner가 Atlas를 통해 MongoDB Atlas Managed MCP Server 구성을 만듭니다. 이 구성은 다음과 같습니다.
서비스 계정을 프로비저닝하고 클라이언트 ID, 클라이언트 시크릿 및 에이전트에 제공하는 MongoDB Atlas Managed MCP 서버 URL(
https://mcp.mongodb.com)을 반환합니다.별도의 인그레스 및 이그레스 Atlas 서비스 계정을 사용합니다. AI 클라이언트는 MongoDB Atlas Managed MCP 서버에만 액세스권을 부여하는 인그레스 자격 증명을 받습니다. 서버는 프로세스 후 필요한 Atlas 권한이 구성된 별도의 이그레스 서비스 계정을 사용하여 AI 클라이언트를 대신하여 API 호출을 실행합니다. 이그레스 자격 증명은 AI 클라이언트에 노출되지 않습니다.
개별 사용자의 인증이 아닌 서비스 계정을 사용하여 AI 클라이언트를 인증하고 관리자가 할당한 역할을 사용합니다.
관리자는 MongoDB Atlas managed MCP 서버에 대해 구성 단위로 세분화된 제어권을 확보할 수 있습니다. 이에는 다음이 포함됩니다.
부여된 Atlas 역할
IP 액세스 목록
읽기 전용 플래그(기본적으로 활성화됨)
MCP 구성 서비스 계정을 위한 Atlas Managed MCP 패키지
일부 AI 클라이언트는 MongoDB Atlas 관리형 MCP 서버가 프로그래밍 방식 액세스 에 사용하는 MCP 구성 서비스 계정 OAuth 클라이언트 자격 증명 흐름을 기본적으로 지원 하지 않습니다. 이러한 클라이언트를 연결하려면 mongodb-atlas-mcp-remote npm 패키지 npx 사용합니다. 클라이언트의 구성 파일 에서 을(를) 사용하여 이 패키지 실행 . 패키지 MCP 구성 서비스 계정 자격 증명 에서 액세스 토큰을 획득하고 요청을 MongoDB Atlas 관리형 MCP 서버로 전달하여 토큰 캐싱 및 새로 고침을 처리합니다. 이를 통해 AI 클라이언트를 MongoDB Atlas 관리형 MCP 서버에 원활하게 연결할 수 있습니다.
이 패키지는 설정 파일을 통해 연결하는 AI 클라이언트에만 사용합니다. MongoDB MCP 서버 시작하기 페이지의 클라이언트 특정 지침에서는 이미 패키지를 사용합니다.
LangChain과 같은 AI 프레임워크를 사용하여 프로그래밍 에이전트를 빌드하는 경우에는 이 패키지를 사용하지 마십시오. 대신 액세스 토큰을 가져와 애플리케이션 코드에서 MongoDB Atlas Managed MCP Server를 직접 호출합니다. 자세한 내용은 MongoDB MCP 서버 시작하기를 참조하고 AI CLIENT 드롭다운에서 AI Framework Clients를 선택하십시오.
자세히 알아보기
MongoDB MCP 서버를 구성하고 사용 방법을 학습 다음 리소스를 참조하세요.
MongoDB MCP 서버를 빠르게 시작하세요. | |
MongoDB MCP 서버 구성을 위한 전제 조건을 확인합니다. | |
사용 가능한 모든 구성 및 연결 옵션을 확인합니다. | |
MongoDB MCP 서버에서 사용 가능한 모든 도구를 확인합니다. | |
MongoDB MCP 서버와 함께 사용할 수 있는 예시 프롬프트를 테스트합니다. | |
MongoDB MCP 서버의 보안 권장사항 에 대해 알아보세요. | |
MongoDB MCP 서버 소스 코드 및 기여 가이드라인을 확인하세요. |