MongoDB cluster 에 연결하고 다른 MCP 서버 옵션을 설정하다 하도록 MongoDB MCP 서버를 구성하려면 다음 방법 중 하나를 사용합니다.
MCP 서버 옵션이 있는 JSON 구성 파일
명령줄 옵션
운영 체제 환경 변수
MCP 서버는 Atlas API 자격 증명 또는 연결 문자열 사용하여 클러스터 액세스 .
MCP 서버 클러스터 연결 방법 및 옵션
클러스터 에 연결하도록 MCP 서버를 구성하고 다른 MCP 서버 옵션을 설정하다 이 섹션에 설명된 방법을 사용합니다.
참고
MCP 서버 구성 파일 예제에는 데이터에 대한 읽기 전용 액세스 보장하기 위해 --readOnly 가 포함되어 있습니다. 일반적으로 데이터 변경을 방지하려면 읽기 전용 모드 활성화 .
쓰기 (write) 작업을 활성화 하려면 --readOnly 를 생략하거나 운영 체제 환경 변수 MDB_MCP_READ_ONLY 를 false로 설정하다 . 자세한 내용은 MCP 서버 읽기 전용 모드 활성화를 참조하세요.
MCP 서버 구성 파일 예제에서는 type 필드 "stdio"로 설정하다 .
type 다음 중 하나로 설정하다 수 있습니다.
"stdio", MCP 서버와의 통신을 위해 표준 입력 및 출력을 사용합니다.stdio은 대부분의 AI 클라이언트에 적합합니다. 일반적으로stdio을 사용합니다."http", MCP 서버와의 HTTP 통신을 활성화합니다. 그런 다음 HTTP 사용하여 웹 클라이언트 에서 MCP 서버와 상호 작용 수 있습니다.경고
HTTP는 인증 및 보안을 구현하지 않은 프로덕션 용도에는 권장되지 않습니다.
MCP 서버 구성 파일 예제에서는 MCP 서버 이름도 "MongoDB"(으)로 설정하다 . MCP 서버를 시작한 후 MCP 서버의 이름과 일치하도록 서버 이름을 변경할 수 있습니다. 서버 이름은 AI 클라이언트 에 MCP 서버를 식별합니다.
Atlas API 자격 증명으로 연결하기
Atlas 도구 실행을 위한 MongoDB MCP 서버 전제 조건 에서 얻은 Atlas API 자격 증명 사용하여 Atlas cluster 에 연결할 수 있습니다.
참고
다음 섹션에서 볼 수 있듯이 보안이나 다른 이유로 Atlas API 자격 증명 사용하지 않으려는 경우 MongoDB 연결 문자열 사용하여 Atlas cluster 에 연결할 수도 있습니다.
로그인 자격 증명 및 연결 정보와 같은 민감한 구성 설정에는 명령줄 인수 대신 환경 변수를 사용합니다. 예시 들어 API 클라이언트 설정에는 MDB_MCP_API_CLIENT_ID 및 MDB_MCP_API_CLIENT_SECRET 를 사용하고 연결 문자열에는 MDB_MCP_CONNECTION_STRING 를 사용합니다.
환경 변수는 명령줄 인수보다 안전합니다. 명령줄 인수를 추적하고, 캐시하고, 프로세스 목록에 포함하고, 다양한 위치에 기록할 수 있습니다.
Atlas API 자격 증명 으로 연결하려면 AI 클라이언트 에 대한 JSON 구성 파일 의 env 섹션에서 MDB_MCP_API_CLIENT_ID 및 MDB_MCP_API_CLIENT_SECRET 환경 변수를 설정하다 .
... "args": [ "-y", "mongodb-mcp-server@latest", "--readOnly" ], "env": { "MDB_MCP_API_CLIENT_ID": "<atlas-service-account-client-id>", "MDB_MCP_API_CLIENT_SECRET": "<atlas-service-account-client-secret>" } ...
<atlas-service-account-client-id> 및 <atlas-service-account-client-secret> 을(를 ) Atlas 정보로 바꿉니다.
다양한 AI 클라이언트에 대한 전체 JSON 구성 파일 예제는 MongoDB MCP 서버 시작하기를 참조하세요.
클러스터 연결 문자열로 연결
보안 또는 다른 이유로 Atlas API 자격 증명 사용하지 않으려면 MongoDB 연결 문자열 사용하여 클러스터 에 연결할 수 있습니다.
다음 예시 Atlas cluster 에 연결하기 위한 연결 문자열 보여줍니다.
... "args": [ "-y", "mongodb-mcp-server@latest", "--readOnly" ], "env": { "MDB_MCP_CONNECTION_STRING": "mongodb+srv://<user-name>:<password>@<cluster-name>.mongodb.net/<database-name>" } ...
<user-name>, <password>, <cluster-name>, <database-name> 를 Atlas 정보로 바꿉니다.
연결 문자열 사용하여 로컬 클러스터 에 연결할 수도 있습니다. 예시 를 들면 다음과 같습니다.
... "args": [ "-y", "mongodb-mcp-server@latest", "--readOnly" ], "env": { "MDB_MCP_CONNECTION_STRING": "mongodb://127.0.0.1:27019/?directConnection=true" } ...
중요
--connectionString CLI 인수는 더 이상 사용되지 않습니다. 대신 MDB_MCP_CONNECTION_STRING 환경 변수를 사용하세요. 환경 변수가 옵션이 아닌 경우 첫 번째 위치 인수를 사용하세요.
운영 체제에서 MCP 서버 환경 변수 정의
환경 변수를 정의하여 MCP 서버에 대한 다양한 구성 옵션을 설정하다 수 있습니다.
MCP 서버의 운영 체제 환경 변수를 정의하려면 접두사 MDB_MCP_ 뒤에 밑줄이 있는 대문자를 사용하여 변수 이름을 붙입니다. 예시 들어 MDB_MCP_CONNECTION_STRING 를 사용하여 connectionString 옵션을 설정하다 .
로그인 자격 증명 및 연결 정보와 같은 민감한 구성 설정에는 명령줄 인수 대신 환경 변수를 사용합니다. 예시 들어 API 클라이언트 설정에는 MDB_MCP_API_CLIENT_ID 및 MDB_MCP_API_CLIENT_SECRET 를 사용하고 연결 문자열에는 MDB_MCP_CONNECTION_STRING 를 사용합니다.
환경 변수는 명령줄 인수보다 안전합니다. 명령줄 인수를 추적하고, 캐시하고, 프로세스 목록에 포함하고, 다양한 위치에 기록할 수 있습니다.
다음 섹션의 예시에서 <atlas-service-account-client-id>, <atlas-service-account-client-secret>, <user-name>, <password>, <cluster-name>, <database-name> 를 Atlas 정보로 바꿉니다.
유닉스 환경 변수
다음 예는 Unix 기반 운영 체제에서 MCP 서버 환경 변수를 정의하는 방법을 보여줍니다.
# Set Atlas API credentials for a service account export MDB_MCP_API_CLIENT_ID="<atlas-service-account-client-id>" export MDB_MCP_API_CLIENT_SECRET="<atlas-service-account-client-secret>" # Set a MongoDB connection string export MDB_MCP_CONNECTION_STRING="mongodb+srv://<user-name>:<password>@<cluster-name>.mongodb.net/<database-name>" # Change the MCP Server log path from the default export MDB_MCP_LOG_PATH="/mcp/logs"
Windows 명령줄 환경 변수
다음 예에서는 Windows 명령줄 에서 을(를) 사용하여 변수를 설정하다 .
:: Set Atlas API credentials for a service account set MDB_MCP_API_CLIENT_ID=<atlas-service-account-client-id> set MDB_MCP_API_CLIENT_SECRET=<atlas-service-account-client-secret> :: Set a MongoDB connection string set MDB_MCP_CONNECTION_STRING="mongodb+srv://<user-name>:<password>@<cluster-name>.mongodb.net/<database-name>" :: Change the MCP Server log path from the default set MDB_MCP_LOG_PATH="C:\mcp\logs"
Windows PowerShell 환경 변수
다음 예제에서는 Windows PowerShell 세션에서 변수를 설정하다 .
# Set Atlas API credentials for a service account $env:MDB_MCP_API_CLIENT_ID="<atlas-service-account-client-id>" $env:MDB_MCP_API_CLIENT_SECRET="<atlas-service-account-client-secret>" # Set a MongoDB connection string $env:MDB_MCP_CONNECTION_STRING="mongodb+srv://<user-name>:<password>@<cluster-name>.mongodb.net/<database-name>" # Change the MCP Server log path from the default $env:MDB_MCP_LOG_PATH="C:\mcp\logs"