重要
このページで説明されている機能は、パブリックプレビュー期間中、Atlas Infiniteクラスターでは現在サポートされていません。パブリックプレビューでサポートされている機能については、パブリックプレビューの可用性を参照してください。
このガイドでは、MongoDB MCP Server を構成してAIクライアントで使用することで、 MongoDB MCP Server の使用を開始する方法を説明します。
始める前に
開始する前に、「MongoDB MCP サーバー Prerequisites for Running Atlas ツール」を検討し、MongoDB MCP サーバーを構成するためのすべての要件を満たしていることを確認してください。
Tip
設定手順については、以下の「AI クライアント」ドロップダウンから必要な AI クライアントを選択します。
Claude Code は、次の設定方法をサポートしています。
- MongoDB Atlas のプラグイン (マネージド MCP サーバー) (推奨): このオプションを使用すると、プラグインを使用して MongoDB Atlas クラスターに接続できます。
- MongoDB Atlas マネージド MCP サーバーの手動設定: このオプションを使用すると、Atlas CLI または Atlas API を使用して Atlas アクセスを設定した後に MongoDB Atlas クラスターに接続できます。
- ローカル MCP 用プラグイン: このオプションを使用すると、ローカル MongoDB クラスターに接続できます。
- ローカル MCP の手動設定: このオプションを使用すると、ローカル MCP 環境を手動で設定した後に、ローカル MongoDB クラスターに接続できます。
MongoDB Atlas
重要
Organization Owner は、ノードがプラグインで接続できるように、AI クライアント設定を有効にする必要があります。AI クライアント接続を有効にする方法については、「AI クライアントを有効にする」を参照してください。
要求された権限を確認します。
ガイド付き Atlas OAuth フロー を完了し、[承認]をクリックします。
Atlas にログインします。
重要
この手順を完了するには、Atlas CLI 1.58.0 以降が必要です。ターミナルで atlas --version を実行してバージョンを確認できます。アップグレードが必要な場合は、MongoDB Atlas CLI ダウンロード を参照してください。
ターミナルで、次のコマンドを実行します。
atlas auth login -P mcp
「**UserAccount**」を選択します。これにより、1 回限りの認証コードが返され、外部ブラウザウィンドウに移動します。1 回限りのコードを使用してログインし、アカウントを認証した後、ターミナルに戻ってください。
ターミナルのプロンプトに従って、プロフィールの設定を完了します。
組織またはプロジェクト ID 環境変数を設定します。
組織IDを<ORG_ID>に置き換えて、ターミナルで次のコマンドを実行し、組織レベルの設定の環境変数を設定します。
export ORG_ID="<ORG_ID>" # Set to use org-level config
Tip
代わりにプロジェクトレベルの設定を使用する場合は、組織IDの代わりにプロジェクトIDを設定できます。<GROUP_ID> をグループ ID に置き換えて実行してください。
export GROUP_ID="<GROUP_ID>" # Set to use project-level config instead of ORG_ID
MCP 構成を作成します。
ロールとアクセス用 IP アドレスを追加して、組織レベルの設定を作成するには、次のコマンドを実行します。
cat > /tmp/mcp-config.json <<EOF { "mcpConfigName": "my-config", "roles": ["ORG_OWNER"], "ipAccessList": [{"ipAddress": "$MY_IP"}] } EOF read -r MCP_CONFIG_ID CLIENT_ID <<< "$( atlas api remoteMcpConfigurations createOrgMcpConfig \ --orgId "$ORG_ID" \ --file /tmp/mcp-config.json \ -P mcp \ -o '{{.mcpConfigId}} {{.clientId}}' )" export MCP_CONFIG_ID export CLIENT_ID
Tip
代わりに プロジェクトレベルの構成 を使用する場合は、次のコマンドを実行します。
cat > /tmp/mcp-config.json <<EOF { "mcpConfigName": "my-config", "roles": ["GROUP_OWNER"], "ipAccessList": [{"ipAddress": "$MY_IP"}] } EOF read -r MCP_CONFIG_ID CLIENT_ID <<< "$( atlas api remoteMcpConfigurations createGroupMcpConfig \ --groupId "$GROUP_ID" \ --file /tmp/mcp-config.json \ -P mcp \ -o '{{.mcpConfigId}} {{.clientId}}' )" export MCP_CONFIG_ID export CLIENT_ID
クライアントシークレットを生成します。
次のコマンドを実行して、作成した組織レベルの構成のシークレットを作成します。secretExpiresAfterHours で作成するシークレットの有効期限を設定します。
重要
シークレットは 1 度しか検索できません。失くした場合は、新しいシークレットを作成して再生成します。
cat > /tmp/mcp-secret.json <<EOF {"secretExpiresAfterHours": 8760} EOF SECRET=$( atlas api remoteMcpConfigurations createOrgMcpSecret \ --orgId "$ORG_ID" \ --mcpConfigId "$MCP_CONFIG_ID" \ --file /tmp/mcp-secret.json \ -P mcp \ -o '{{.secret}}' ) export SECRET
Tip
代わりに プロジェクトレベルの構成 を使用する場合は、次のコマンドを実行します。
cat > /tmp/mcp-secret.json <<EOF {"secretExpiresAfterHours": 8760} EOF SECRET=$( atlas api remoteMcpConfigurations createGroupMcpSecret \ --groupId "$GROUP_ID" \ --mcpConfigId "$MCP_CONFIG_ID" \ --file /tmp/mcp-secret.json \ -P mcp \ -o '{{.secret}}' ) export SECRET
MCP クライアント構成を書き込みます。
次のコマンドを実行して構成ファイルを作成します。
cat > mcp-client-config.json <<EOF { "mcpServers": { "mongodb-atlas-mcp-remote": { "type": "stdio", "command": "npx", "args": ["-y", "mongodb-atlas-mcp-remote@latest"], "env": { "MDB_MCP_API_CLIENT_ID": "$CLIENT_ID", "MDB_MCP_API_CLIENT_SECRET": "$SECRET" } } } } EOF
mcp-client-config.json を開き、その内容を MCP クライアントの設定に貼り付けます。
公開 API キーを作成します。
公開キーを作成するには、Atlas Administration API の使用開始の手順に従ってください。
組織またはプロジェクト ID 環境変数を設定します。
次のコマンドを実行します。<ORG_ID> を組織の組織 ID に置き換えて、組織レベルの構成を行います。
export ORG_ID="<ORG_ID>" # Set to use org-level config instead of GROUP_ID
Tip
代わりにプロジェクトレベルの構成を使用する場合は、組織 ID の代わりにグループ ID を設定できます。<GROUP_ID> をグループ ID に置き換えて実行します。
export GROUP_ID="<GROUP_ID>" # Set to use project-level config instead of ORG_ID
MCP 構成を作成します。
次を実行し、応答からmcpConfigIdとclientIdの両方を抽出して、組織レベルの設定を行います。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/vnd.atlas.2025-03-12+json" \ -d "$(jq -n --arg ip "$MY_IP" '{ mcpConfigName: "my-config", roles: ["ORG_OWNER"], ipAccessList: [ {ipAddress: $ip}, {cidrBlock: "10.0.0.0/24"} ] }')" \ "https://cloud.mongodb.com/api/atlas/v2/orgs/$ORG_ID/mcpConfigs"
Tip
代わりにプロジェクト レベルの構成を使用する場合は、次を実行します。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/vnd.atlas.2025-03-12+json" \ -d "$(jq -n --arg ip "$MY_IP" '{ mcpConfigName: "my-config", roles: ["GROUP_OWNER"], ipAccessList: [ {ipAddress: $ip}, {cidrBlock: "10.0.0.0/24"} ] }')" \ "https://cloud.mongodb.com/api/atlas/v2/groups/$GROUP_ID/mcpConfigs"
ユーザーロールの詳細については、次を参照してください。
mcpConfigs API エンドポイントの詳細については、「リモート MCP 構成」を参照してください。
MCP クライアント シークレットを生成します。
次のコマンドを実行し、応答から 組織レベルの構成の secret を抽出します。
重要
シークレットは 1 度しか検索できません。失くした場合は、新しいシークレットを作成して再生成します。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H 'Content-Type: application/vnd.atlas.2025-03-12+json' \ -H 'Accept: application/vnd.atlas.2025-03-12+json' \ -d '{"secretExpiresAfterHours": 8760}' \ "https://cloud.mongodb.com/api/atlas/v2/orgs/$ORG_ID/mcpConfigs/$MCP_CONFIG_ID/secrets"
Tip
代わりにプロジェクト レベルの構成を使用する場合は、次を実行します。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H 'Content-Type: application/vnd.atlas.2025-03-12+json' \ -H 'Accept: application/vnd.atlas.2025-03-12+json' \ -d '{"secretExpiresAfterHours": 8760}' \ "https://cloud.mongodb.com/api/atlas/v2/groups/$GROUP_ID/mcpConfigs/$MCP_CONFIG_ID/secrets"
MCP クライアント構成を書き込みます。
次のコマンドを実行して構成ファイルを作成します。
cat > mcp-client-config.json <<EOF { "mcpServers": { "mongodb-atlas-mcp-remote": { "type": "stdio", "command": "npx", "args": ["-y", "mongodb-atlas-mcp-remote@latest"], "env": { "MDB_MCP_API_CLIENT_ID": "$CLIENT_ID", "MDB_MCP_API_CLIENT_SECRET": "$SECRET" } } } } EOF
mcp-client-config.json を開き、その内容を MCP クライアントの設定に貼り付けます。
自己管理型 MongoDB
Local MCPをセットアップするには、Node.jsのバージョン22.12.0がインストールされていることを確認してください。以降。
Node.jsのバージョンを確認するには、次のコマンドを実行します。
node --version
ローカル Atlas 配置で Local MCP を使用できます。そのためには、Docker をインストールする必要があります。ローカル Atlas 配置の概要については、「ローカル Atlas 配置の作成」を参照してください。
セットアップユーティリティを実行します。
セットアップユーティリティは、初期の JSON 構成ファイルを作成するプロセスをガイドします。この JSON 構成ファイルは、サーバーに対して、MongoDB への接続方法と、そのデータを MCP クライアントと共有する方法を指示します。
コマンドラインから 、次のコマンドを実行します。
npx mongodb-mcp-server@latest setup
注意
あるいは、 Node.jsをインストールする必要がない場合は、 DockerコンテナでローカルMCPを実行することもできます。詳しく学ぶには、 Dockerの使用 を参照してください。
読み取り専用モード設定を提供します。
読み取り専用モードを使用して、MCP サーバーを読み取り操作のみを実行するように制限できます。読み取り専用モードを有効にするには、「Y」と入力します。
セキュリティのため、書込み操作を実行する必要がある場合を除き、常に読み取り専用モードを有効にしてください。書込み操作は後で有効にできます。詳細については、MCP サーバーの読み取り専用モード を参照してください。
接続文字列を入力します。
MongoDBクラスターの接続文字列を入力します。
たとえば、mongodb+srv://user:D1fficultP%40ssw0rd@mycluster.abcd1.mongodb.net/myDatabase?retryWrites=true&w=majority 。
詳しくは、接続文字列を検索するを参照してください。
Local MCP for MongoDB MCP サーバーの設定で問題が発生した場合は、「Local MCP サーバーのトラブルシューティング」を参照してください。
完全な構成オプションについては、 MCP サーバーと接続の構成 を参照してください。
Claude Desktop & Web は次の設定方法をサポートしています。
- Connector for MongoDB Atlas（マネージド MCP サーバー）（推奨）：このオプションを使用すると、Connector を使用して MongoDB Atlas クラスターに接続できます。
- MongoDB Atlas マネージド MCP サーバーの手動設定: このオプションを使用すると、Atlas CLI または Atlas API を使用して Atlas アクセスを設定した後に MongoDB Atlas クラスターに接続できます。
- ローカル MCP の手動設定: このオプションを使用すると、ローカル MCP 環境を手動で設定した後に、ローカル MongoDB クラスターに接続できます。
MongoDB Atlas
重要
Organization Owner は、ノードがプラグインで接続できるように、AI クライアント設定を有効にする必要があります。AI クライアント接続を有効にする方法については、「AI クライアントを有効にする」を参照してください。
Atlas にログインします。
Connect をクリックし、ガイド付きの Atlas OAuth フローを完了します。
Atlas にログインします。
重要
この手順を完了するには、Atlas CLI 1.58.0 以降が必要です。ターミナルで atlas --version を実行してバージョンを確認できます。アップグレードが必要な場合は、MongoDB Atlas CLI ダウンロード を参照してください。
ターミナルで、次のコマンドを実行します。
atlas auth login -P mcp
「**UserAccount**」を選択します。これにより、1 回限りの認証コードが返され、外部ブラウザウィンドウに移動します。1 回限りのコードを使用してログインし、アカウントを認証した後、ターミナルに戻ってください。
ターミナルのプロンプトに従って、プロフィールの設定を完了します。
組織またはプロジェクト ID 環境変数を設定します。
組織IDを<ORG_ID>に置き換えて、ターミナルで次のコマンドを実行し、組織レベルの設定の環境変数を設定します。
export ORG_ID="<ORG_ID>" # Set to use org-level config
Tip
代わりにプロジェクトレベルの設定を使用する場合は、組織IDの代わりにプロジェクトIDを設定できます。<GROUP_ID> をグループ ID に置き換えて実行してください。
export GROUP_ID="<GROUP_ID>" # Set to use project-level config instead of ORG_ID
MCP 構成を作成します。
ロールとアクセス用 IP アドレスを追加して、組織レベルの設定を作成するには、次のコマンドを実行します。
cat > /tmp/mcp-config.json <<EOF { "mcpConfigName": "my-config", "roles": ["ORG_OWNER"], "ipAccessList": [{"ipAddress": "$MY_IP"}] } EOF read -r MCP_CONFIG_ID CLIENT_ID <<< "$( atlas api remoteMcpConfigurations createOrgMcpConfig \ --orgId "$ORG_ID" \ --file /tmp/mcp-config.json \ -P mcp \ -o '{{.mcpConfigId}} {{.clientId}}' )" export MCP_CONFIG_ID export CLIENT_ID
Tip
代わりに プロジェクトレベルの構成 を使用する場合は、次のコマンドを実行します。
cat > /tmp/mcp-config.json <<EOF { "mcpConfigName": "my-config", "roles": ["GROUP_OWNER"], "ipAccessList": [{"ipAddress": "$MY_IP"}] } EOF read -r MCP_CONFIG_ID CLIENT_ID <<< "$( atlas api remoteMcpConfigurations createGroupMcpConfig \ --groupId "$GROUP_ID" \ --file /tmp/mcp-config.json \ -P mcp \ -o '{{.mcpConfigId}} {{.clientId}}' )" export MCP_CONFIG_ID export CLIENT_ID
クライアントシークレットを生成します。
次のコマンドを実行して、作成した組織レベルの構成のシークレットを作成します。secretExpiresAfterHours で作成するシークレットの有効期限を設定します。
重要
シークレットは 1 度しか検索できません。失くした場合は、新しいシークレットを作成して再生成します。
cat > /tmp/mcp-secret.json <<EOF {"secretExpiresAfterHours": 8760} EOF SECRET=$( atlas api remoteMcpConfigurations createOrgMcpSecret \ --orgId "$ORG_ID" \ --mcpConfigId "$MCP_CONFIG_ID" \ --file /tmp/mcp-secret.json \ -P mcp \ -o '{{.secret}}' ) export SECRET
Tip
代わりに プロジェクトレベルの構成 を使用する場合は、次のコマンドを実行します。
cat > /tmp/mcp-secret.json <<EOF {"secretExpiresAfterHours": 8760} EOF SECRET=$( atlas api remoteMcpConfigurations createGroupMcpSecret \ --groupId "$GROUP_ID" \ --mcpConfigId "$MCP_CONFIG_ID" \ --file /tmp/mcp-secret.json \ -P mcp \ -o '{{.secret}}' ) export SECRET
MCP クライアント構成を書き込みます。
次のコマンドを実行して構成ファイルを作成します。
cat > mcp-client-config.json <<EOF { "mcpServers": { "mongodb-atlas-mcp-remote": { "type": "stdio", "command": "npx", "args": ["-y", "mongodb-atlas-mcp-remote@latest"], "env": { "MDB_MCP_API_CLIENT_ID": "$CLIENT_ID", "MDB_MCP_API_CLIENT_SECRET": "$SECRET" } } } } EOF
mcp-client-config.json を開き、その内容を Claude/claude_desktop_config.json ファイルに貼り付けます。他の MCP サーバーが構成されている場合は、mongodb-atlas-mcp-remote 構成のみを既存の mcpServers オブジェクトに追加できます。
Claude Desktop を再起動して新しい構成を適用します。
公開 API キーを作成します。
公開キーを作成するには、Atlas Administration API の使用開始の手順に従ってください。
組織またはプロジェクト ID 環境変数を設定します。
次のコマンドを実行します。<ORG_ID> を組織の組織 ID に置き換えて、組織レベルの構成を行います。
export ORG_ID="<ORG_ID>" # Set to use org-level config instead of GROUP_ID
Tip
代わりにプロジェクトレベルの構成を使用する場合は、組織 ID の代わりにグループ ID を設定できます。<GROUP_ID> をグループ ID に置き換えて実行します。
export GROUP_ID="<GROUP_ID>" # Set to use project-level config instead of ORG_ID
MCP 構成を作成します。
次を実行し、応答からmcpConfigIdとclientIdの両方を抽出して、組織レベルの設定を行います。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/vnd.atlas.2025-03-12+json" \ -d "$(jq -n --arg ip "$MY_IP" '{ mcpConfigName: "my-config", roles: ["ORG_OWNER"], ipAccessList: [ {ipAddress: $ip}, {cidrBlock: "10.0.0.0/24"} ] }')" \ "https://cloud.mongodb.com/api/atlas/v2/orgs/$ORG_ID/mcpConfigs"
Tip
代わりにプロジェクト レベルの構成を使用する場合は、次を実行します。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/vnd.atlas.2025-03-12+json" \ -d "$(jq -n --arg ip "$MY_IP" '{ mcpConfigName: "my-config", roles: ["GROUP_OWNER"], ipAccessList: [ {ipAddress: $ip}, {cidrBlock: "10.0.0.0/24"} ] }')" \ "https://cloud.mongodb.com/api/atlas/v2/groups/$GROUP_ID/mcpConfigs"
ユーザーロールの詳細については、次を参照してください。
mcpConfigs API エンドポイントの詳細については、「リモート MCP 構成」を参照してください。
MCP クライアント シークレットを生成します。
次のコマンドを実行し、応答から 組織レベルの構成の secret を抽出します。
重要
シークレットは 1 度しか検索できません。失くした場合は、新しいシークレットを作成して再生成します。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H 'Content-Type: application/vnd.atlas.2025-03-12+json' \ -H 'Accept: application/vnd.atlas.2025-03-12+json' \ -d '{"secretExpiresAfterHours": 8760}' \ "https://cloud.mongodb.com/api/atlas/v2/orgs/$ORG_ID/mcpConfigs/$MCP_CONFIG_ID/secrets"
Tip
代わりにプロジェクト レベルの構成を使用する場合は、次を実行します。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H 'Content-Type: application/vnd.atlas.2025-03-12+json' \ -H 'Accept: application/vnd.atlas.2025-03-12+json' \ -d '{"secretExpiresAfterHours": 8760}' \ "https://cloud.mongodb.com/api/atlas/v2/groups/$GROUP_ID/mcpConfigs/$MCP_CONFIG_ID/secrets"
MCP クライアント構成を書き込みます。
次のコマンドを実行して構成ファイルを作成します。
cat > mcp-client-config.json <<EOF { "mcpServers": { "mongodb-atlas-mcp-remote": { "type": "stdio", "command": "npx", "args": ["-y", "mongodb-atlas-mcp-remote@latest"], "env": { "MDB_MCP_API_CLIENT_ID": "$CLIENT_ID", "MDB_MCP_API_CLIENT_SECRET": "$SECRET" } } } } EOF
mcp-client-config.json を開き、その内容を Claude/claude_desktop_config.json ファイルに貼り付けます。他の MCP サーバーが構成されている場合は、mongodb-atlas-mcp-remote 構成のみを既存の mcpServers オブジェクトに追加できます。
Claude Desktop を再起動して新しい構成を適用します。
自己管理型 MongoDB
Local MCPをセットアップするには、Node.jsのバージョン22.12.0がインストールされていることを確認してください。以降。
Node.jsのバージョンを確認するには、次のコマンドを実行します。
node --version
ローカル Atlas 配置で Local MCP を使用できます。そのためには、Docker をインストールする必要があります。ローカル Atlas 配置の概要については、「ローカル Atlas 配置の作成」を参照してください。
セットアップユーティリティを実行します。
セットアップユーティリティは、初期の JSON 構成ファイルを作成するプロセスをガイドします。この JSON 構成ファイルは、サーバーに対して、MongoDB への接続方法と、そのデータを MCP クライアントと共有する方法を指示します。
コマンドラインから 、次のコマンドを実行します。
npx mongodb-mcp-server@latest setup
注意
あるいは、 Node.jsをインストールする必要がない場合は、 DockerコンテナでローカルMCPを実行することもできます。詳しく学ぶには、 Dockerの使用 を参照してください。
読み取り専用モード設定を提供します。
読み取り専用モードを使用して、MCP サーバーを読み取り操作のみを実行するように制限できます。読み取り専用モードを有効にするには、「Y」と入力します。
セキュリティのため、書込み操作を実行する必要がある場合を除き、常に読み取り専用モードを有効にしてください。書込み操作は後で有効にできます。詳細については、MCP サーバーの読み取り専用モード を参照してください。
接続文字列を入力します。
MongoDBクラスターの接続文字列を入力します。
たとえば、mongodb+srv://user:D1fficultP%40ssw0rd@mycluster.abcd1.mongodb.net/myDatabase?retryWrites=true&w=majority 。
詳しくは、接続文字列を検索するを参照してください。
Local MCP for MongoDB MCP サーバーの設定で問題が発生した場合は、「Local MCP サーバーのトラブルシューティング」を参照してください。
完全な構成オプションについては、 MCP サーバーと接続の構成 を参照してください。
ChatGPT Desktop & Web は、次の設定方法をサポートしています。
- MongoDB Atlas のプラグイン (マネージド MCP サーバー) (推奨): このオプションを使用すると、プラグインを使用して MongoDB Atlas クラスターに接続できます。
注意
ChatGPT は自己管理型 MongoDB をサポートしていません。
MongoDB Atlas
重要
Organization Owner は、ノードがプラグインで接続できるように、AI クライアント設定を有効にする必要があります。AI クライアント接続を有効にする方法については、「AI クライアントを有効にする」を参照してください。
ChatGPT Desktop または Web で MongoDB Atlas プラグインを設定するには、次の手順に従ってください。
Atlas にログインします。
「Connect to MongoDB Atlas」をクリックし、ガイド付き Atlas OAuth フローを完了します。
カーソルは次の設定方法をサポートしています。
- MongoDB Atlas のプラグイン (マネージド MCP サーバー) (推奨): このオプションを使用すると、プラグインを使用して MongoDB Atlas クラスターに接続できます。
- MongoDB Atlas マネージド MCP サーバーの手動設定: このオプションを使用すると、Atlas CLI または Atlas API を使用して Atlas アクセスを設定した後に MongoDB Atlas クラスターに接続できます。
- ローカル MCP 用プラグイン: このオプションを使用すると、ローカル MongoDB クラスターに接続できます。
- ローカル MCP の手動設定: このオプションを使用すると、ローカル MCP 環境を手動で設定した後に、ローカル MongoDB クラスターに接続できます。
MongoDB Atlas
重要
Organization Owner は、ノードがプラグインで接続できるように、AI クライアント設定を有効にする必要があります。AI クライアント接続を有効にする方法については、「AI クライアントを有効にする」を参照してください。
Atlas にログインします。
ツール & MCP → 認証 → MongoDB-Atlas に Go し、ガイド付きの OAuth フローを完了します。
Atlas にログインします。
重要
この手順を完了するには、Atlas CLI 1.58.0 以降が必要です。ターミナルで atlas --version を実行してバージョンを確認できます。アップグレードが必要な場合は、MongoDB Atlas CLI ダウンロード を参照してください。
ターミナルで、次のコマンドを実行します。
atlas auth login -P mcp
「**UserAccount**」を選択します。これにより、1 回限りの認証コードが返され、外部ブラウザウィンドウに移動します。1 回限りのコードを使用してログインし、アカウントを認証した後、ターミナルに戻ってください。
ターミナルのプロンプトに従って、プロフィールの設定を完了します。
組織またはプロジェクト ID 環境変数を設定します。
組織IDを<ORG_ID>に置き換えて、ターミナルで次のコマンドを実行し、組織レベルの設定の環境変数を設定します。
export ORG_ID="<ORG_ID>" # Set to use org-level config
Tip
代わりにプロジェクトレベルの設定を使用する場合は、組織IDの代わりにプロジェクトIDを設定できます。<GROUP_ID> をグループ ID に置き換えて実行してください。
export GROUP_ID="<GROUP_ID>" # Set to use project-level config instead of ORG_ID
MCP 構成を作成します。
ロールとアクセス用 IP アドレスを追加して、組織レベルの設定を作成するには、次のコマンドを実行します。
cat > /tmp/mcp-config.json <<EOF { "mcpConfigName": "my-config", "roles": ["ORG_OWNER"], "ipAccessList": [{"ipAddress": "$MY_IP"}] } EOF read -r MCP_CONFIG_ID CLIENT_ID <<< "$( atlas api remoteMcpConfigurations createOrgMcpConfig \ --orgId "$ORG_ID" \ --file /tmp/mcp-config.json \ -P mcp \ -o '{{.mcpConfigId}} {{.clientId}}' )" export MCP_CONFIG_ID export CLIENT_ID
Tip
代わりに プロジェクトレベルの構成 を使用する場合は、次のコマンドを実行します。
cat > /tmp/mcp-config.json <<EOF { "mcpConfigName": "my-config", "roles": ["GROUP_OWNER"], "ipAccessList": [{"ipAddress": "$MY_IP"}] } EOF read -r MCP_CONFIG_ID CLIENT_ID <<< "$( atlas api remoteMcpConfigurations createGroupMcpConfig \ --groupId "$GROUP_ID" \ --file /tmp/mcp-config.json \ -P mcp \ -o '{{.mcpConfigId}} {{.clientId}}' )" export MCP_CONFIG_ID export CLIENT_ID
クライアントシークレットを生成します。
次のコマンドを実行して、作成した組織レベルの構成のシークレットを作成します。secretExpiresAfterHours で作成するシークレットの有効期限を設定します。
重要
シークレットは 1 度しか検索できません。失くした場合は、新しいシークレットを作成して再生成します。
cat > /tmp/mcp-secret.json <<EOF {"secretExpiresAfterHours": 8760} EOF SECRET=$( atlas api remoteMcpConfigurations createOrgMcpSecret \ --orgId "$ORG_ID" \ --mcpConfigId "$MCP_CONFIG_ID" \ --file /tmp/mcp-secret.json \ -P mcp \ -o '{{.secret}}' ) export SECRET
Tip
代わりに プロジェクトレベルの構成 を使用する場合は、次のコマンドを実行します。
cat > /tmp/mcp-secret.json <<EOF {"secretExpiresAfterHours": 8760} EOF SECRET=$( atlas api remoteMcpConfigurations createGroupMcpSecret \ --groupId "$GROUP_ID" \ --mcpConfigId "$MCP_CONFIG_ID" \ --file /tmp/mcp-secret.json \ -P mcp \ -o '{{.secret}}' ) export SECRET
MCP クライアント構成を書き込みます。
次のコマンドを実行して構成ファイルを作成します。
cat > mcp-client-config.json <<EOF { "mcpServers": { "mongodb-atlas-mcp-remote": { "type": "stdio", "command": "npx", "args": ["-y", "mongodb-atlas-mcp-remote@latest"], "env": { "MDB_MCP_API_CLIENT_ID": "$CLIENT_ID", "MDB_MCP_API_CLIENT_SECRET": "$SECRET" } } } } EOF
mcp-client-config.json を開き、その内容をプロジェクトまたはホーム ディレクトリ内の .cursor/mcp.json ファイルに貼り付けます。
公開 API キーを作成します。
公開キーを作成するには、Atlas Administration API の使用開始の手順に従ってください。
組織またはプロジェクト ID 環境変数を設定します。
次のコマンドを実行します。<ORG_ID> を組織の組織 ID に置き換えて、組織レベルの構成を行います。
export ORG_ID="<ORG_ID>" # Set to use org-level config instead of GROUP_ID
Tip
代わりにプロジェクトレベルの構成を使用する場合は、組織 ID の代わりにグループ ID を設定できます。<GROUP_ID> をグループ ID に置き換えて実行します。
export GROUP_ID="<GROUP_ID>" # Set to use project-level config instead of ORG_ID
MCP 構成を作成します。
次を実行し、応答からmcpConfigIdとclientIdの両方を抽出して、組織レベルの設定を行います。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/vnd.atlas.2025-03-12+json" \ -d "$(jq -n --arg ip "$MY_IP" '{ mcpConfigName: "my-config", roles: ["ORG_OWNER"], ipAccessList: [ {ipAddress: $ip}, {cidrBlock: "10.0.0.0/24"} ] }')" \ "https://cloud.mongodb.com/api/atlas/v2/orgs/$ORG_ID/mcpConfigs"
Tip
代わりにプロジェクト レベルの構成を使用する場合は、次を実行します。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/vnd.atlas.2025-03-12+json" \ -d "$(jq -n --arg ip "$MY_IP" '{ mcpConfigName: "my-config", roles: ["GROUP_OWNER"], ipAccessList: [ {ipAddress: $ip}, {cidrBlock: "10.0.0.0/24"} ] }')" \ "https://cloud.mongodb.com/api/atlas/v2/groups/$GROUP_ID/mcpConfigs"
ユーザーロールの詳細については、次を参照してください。
mcpConfigs API エンドポイントの詳細については、「リモート MCP 構成」を参照してください。
MCP クライアント シークレットを生成します。
次のコマンドを実行し、応答から 組織レベルの構成の secret を抽出します。
重要
シークレットは 1 度しか検索できません。失くした場合は、新しいシークレットを作成して再生成します。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H 'Content-Type: application/vnd.atlas.2025-03-12+json' \ -H 'Accept: application/vnd.atlas.2025-03-12+json' \ -d '{"secretExpiresAfterHours": 8760}' \ "https://cloud.mongodb.com/api/atlas/v2/orgs/$ORG_ID/mcpConfigs/$MCP_CONFIG_ID/secrets"
Tip
代わりにプロジェクト レベルの構成を使用する場合は、次を実行します。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H 'Content-Type: application/vnd.atlas.2025-03-12+json' \ -H 'Accept: application/vnd.atlas.2025-03-12+json' \ -d '{"secretExpiresAfterHours": 8760}' \ "https://cloud.mongodb.com/api/atlas/v2/groups/$GROUP_ID/mcpConfigs/$MCP_CONFIG_ID/secrets"
MCP クライアント構成を書き込みます。
次のコマンドを実行して構成ファイルを作成します。
cat > mcp-client-config.json <<EOF { "mcpServers": { "mongodb-atlas-mcp-remote": { "type": "stdio", "command": "npx", "args": ["-y", "mongodb-atlas-mcp-remote@latest"], "env": { "MDB_MCP_API_CLIENT_ID": "$CLIENT_ID", "MDB_MCP_API_CLIENT_SECRET": "$SECRET" } } } } EOF
mcp-client-config.json を開き、その内容をプロジェクトまたはホーム ディレクトリ内の .cursor/mcp.json ファイルに貼り付けます。
自己管理型 MongoDB
Local MCPをセットアップするには、Node.jsのバージョン22.12.0がインストールされていることを確認してください。以降。
Node.jsのバージョンを確認するには、次のコマンドを実行します。
node --version
ローカル Atlas 配置で Local MCP を使用できます。そのためには、Docker をインストールする必要があります。ローカル Atlas 配置の概要については、「ローカル Atlas 配置の作成」を参照してください。
セットアップユーティリティを実行します。
セットアップユーティリティは、初期の JSON 構成ファイルを作成するプロセスをガイドします。この JSON 構成ファイルは、サーバーに対して、MongoDB への接続方法と、そのデータを MCP クライアントと共有する方法を指示します。
コマンドラインから 、次のコマンドを実行します。
npx mongodb-mcp-server@latest setup
注意
あるいは、 Node.jsをインストールする必要がない場合は、 DockerコンテナでローカルMCPを実行することもできます。詳しく学ぶには、 Dockerの使用 を参照してください。
読み取り専用モード設定を提供します。
読み取り専用モードを使用して、MCP サーバーを読み取り操作のみを実行するように制限できます。読み取り専用モードを有効にするには、「Y」と入力します。
セキュリティのため、書込み操作を実行する必要がある場合を除き、常に読み取り専用モードを有効にしてください。書込み操作は後で有効にできます。詳細については、MCP サーバーの読み取り専用モード を参照してください。
接続文字列を入力します。
MongoDBクラスターの接続文字列を入力します。
たとえば、mongodb+srv://user:D1fficultP%40ssw0rd@mycluster.abcd1.mongodb.net/myDatabase?retryWrites=true&w=majority 。
詳しくは、接続文字列を検索するを参照してください。
Local MCP for MongoDB MCP サーバーの設定で問題が発生した場合は、「Local MCP サーバーのトラブルシューティング」を参照してください。
完全な構成オプションについては、 MCP サーバーと接続の構成 を参照してください。
Codexは次の設定方法をサポートしています。
- MongoDB Atlas のプラグイン (マネージド MCP サーバー) (推奨): このオプションを使用すると、プラグインを使用して MongoDB Atlas クラスターに接続できます。
- MongoDB Atlas マネージド MCP サーバーの手動設定: このオプションを使用すると、Atlas CLI または Atlas API を使用して Atlas アクセスを設定した後に MongoDB Atlas クラスターに接続できます。
- ローカル MCP の手動設定: このオプションを使用すると、ローカル MCP 環境を手動で設定した後に、ローカル MongoDB クラスターに接続できます。
MongoDB Atlas
重要
Organization Owner は、ノードがプラグインで接続できるように、AI クライアント設定を有効にする必要があります。AI クライアント接続を有効にする方法については、「AI クライアントを有効にする」を参照してください。
プラグインを認可します。
MongoDB Atlas に続行 をクリックし、ガイドに従って Atlas OAuth フローを完了します。
Atlas にログインします。
重要
この手順を完了するには、Atlas CLI 1.58.0 以降が必要です。ターミナルで atlas --version を実行してバージョンを確認できます。アップグレードが必要な場合は、MongoDB Atlas CLI ダウンロード を参照してください。
ターミナルで、次のコマンドを実行します。
atlas auth login -P mcp
「**UserAccount**」を選択します。これにより、1 回限りの認証コードが返され、外部ブラウザウィンドウに移動します。1 回限りのコードを使用してログインし、アカウントを認証した後、ターミナルに戻ってください。
ターミナルのプロンプトに従って、プロフィールの設定を完了します。
組織またはプロジェクト ID 環境変数を設定します。
組織IDを<ORG_ID>に置き換えて、ターミナルで次のコマンドを実行し、組織レベルの設定の環境変数を設定します。
export ORG_ID="<ORG_ID>" # Set to use org-level config
Tip
代わりにプロジェクトレベルの設定を使用する場合は、組織IDの代わりにプロジェクトIDを設定できます。<GROUP_ID> をグループ ID に置き換えて実行してください。
export GROUP_ID="<GROUP_ID>" # Set to use project-level config instead of ORG_ID
MCP 構成を作成します。
ロールとアクセス用 IP アドレスを追加して、組織レベルの設定を作成するには、次のコマンドを実行します。
cat > /tmp/mcp-config.json <<EOF { "mcpConfigName": "my-config", "roles": ["ORG_OWNER"], "ipAccessList": [{"ipAddress": "$MY_IP"}] } EOF read -r MCP_CONFIG_ID CLIENT_ID <<< "$( atlas api remoteMcpConfigurations createOrgMcpConfig \ --orgId "$ORG_ID" \ --file /tmp/mcp-config.json \ -P mcp \ -o '{{.mcpConfigId}} {{.clientId}}' )" export MCP_CONFIG_ID export CLIENT_ID
Tip
代わりに プロジェクトレベルの構成 を使用する場合は、次のコマンドを実行します。
cat > /tmp/mcp-config.json <<EOF { "mcpConfigName": "my-config", "roles": ["GROUP_OWNER"], "ipAccessList": [{"ipAddress": "$MY_IP"}] } EOF read -r MCP_CONFIG_ID CLIENT_ID <<< "$( atlas api remoteMcpConfigurations createGroupMcpConfig \ --groupId "$GROUP_ID" \ --file /tmp/mcp-config.json \ -P mcp \ -o '{{.mcpConfigId}} {{.clientId}}' )" export MCP_CONFIG_ID export CLIENT_ID
クライアントシークレットを生成します。
次のコマンドを実行して、作成した組織レベルの構成のシークレットを作成します。secretExpiresAfterHours で作成するシークレットの有効期限を設定します。
重要
シークレットは 1 度しか検索できません。失くした場合は、新しいシークレットを作成して再生成します。
cat > /tmp/mcp-secret.json <<EOF {"secretExpiresAfterHours": 8760} EOF SECRET=$( atlas api remoteMcpConfigurations createOrgMcpSecret \ --orgId "$ORG_ID" \ --mcpConfigId "$MCP_CONFIG_ID" \ --file /tmp/mcp-secret.json \ -P mcp \ -o '{{.secret}}' ) export SECRET
Tip
代わりに プロジェクトレベルの構成 を使用する場合は、次のコマンドを実行します。
cat > /tmp/mcp-secret.json <<EOF {"secretExpiresAfterHours": 8760} EOF SECRET=$( atlas api remoteMcpConfigurations createGroupMcpSecret \ --groupId "$GROUP_ID" \ --mcpConfigId "$MCP_CONFIG_ID" \ --file /tmp/mcp-secret.json \ -P mcp \ -o '{{.secret}}' ) export SECRET
MCP クライアント構成を書き込みます。
次のコマンドを実行して構成ファイルを作成します。
cat > mcp-client-config.toml <<EOF [mcp_servers.mongodb-atlas-mcp-remote] command = "npx" args = ["-y", "mongodb-atlas-mcp-remote@latest"] [mcp_servers.mongodb-atlas-mcp-remote.env] MDB_MCP_API_CLIENT_ID = "$CLIENT_ID" MDB_MCP_API_CLIENT_SECRET = "$SECRET" EOF
mcp-client-config.toml の内容をコピーし、~/.codex/config.toml ファイルの末尾に貼り付けます。
公開 API キーを作成します。
公開キーを作成するには、Atlas Administration API の使用開始の手順に従ってください。
組織またはプロジェクト ID 環境変数を設定します。
次のコマンドを実行します。<ORG_ID> を組織の組織 ID に置き換えて、組織レベルの構成を行います。
export ORG_ID="<ORG_ID>" # Set to use org-level config instead of GROUP_ID
Tip
代わりにプロジェクトレベルの構成を使用する場合は、組織 ID の代わりにグループ ID を設定できます。<GROUP_ID> をグループ ID に置き換えて実行します。
export GROUP_ID="<GROUP_ID>" # Set to use project-level config instead of ORG_ID
MCP 構成を作成します。
次を実行し、応答からmcpConfigIdとclientIdの両方を抽出して、組織レベルの設定を行います。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/vnd.atlas.2025-03-12+json" \ -d "$(jq -n --arg ip "$MY_IP" '{ mcpConfigName: "my-config", roles: ["ORG_OWNER"], ipAccessList: [ {ipAddress: $ip}, {cidrBlock: "10.0.0.0/24"} ] }')" \ "https://cloud.mongodb.com/api/atlas/v2/orgs/$ORG_ID/mcpConfigs"
Tip
代わりにプロジェクト レベルの構成を使用する場合は、次を実行します。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/vnd.atlas.2025-03-12+json" \ -d "$(jq -n --arg ip "$MY_IP" '{ mcpConfigName: "my-config", roles: ["GROUP_OWNER"], ipAccessList: [ {ipAddress: $ip}, {cidrBlock: "10.0.0.0/24"} ] }')" \ "https://cloud.mongodb.com/api/atlas/v2/groups/$GROUP_ID/mcpConfigs"
ユーザーロールの詳細については、次を参照してください。
mcpConfigs API エンドポイントの詳細については、「リモート MCP 構成」を参照してください。
MCP クライアント シークレットを生成します。
次のコマンドを実行し、応答から 組織レベルの構成の secret を抽出します。
重要
シークレットは 1 度しか検索できません。失くした場合は、新しいシークレットを作成して再生成します。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H 'Content-Type: application/vnd.atlas.2025-03-12+json' \ -H 'Accept: application/vnd.atlas.2025-03-12+json' \ -d '{"secretExpiresAfterHours": 8760}' \ "https://cloud.mongodb.com/api/atlas/v2/orgs/$ORG_ID/mcpConfigs/$MCP_CONFIG_ID/secrets"
Tip
代わりにプロジェクト レベルの構成を使用する場合は、次を実行します。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H 'Content-Type: application/vnd.atlas.2025-03-12+json' \ -H 'Accept: application/vnd.atlas.2025-03-12+json' \ -d '{"secretExpiresAfterHours": 8760}' \ "https://cloud.mongodb.com/api/atlas/v2/groups/$GROUP_ID/mcpConfigs/$MCP_CONFIG_ID/secrets"
MCP クライアント構成を書き込みます。
次のコマンドを実行して構成ファイルを作成します。
cat > mcp-client-config.toml <<EOF [mcp_servers.mongodb-atlas-mcp-remote] command = "npx" args = ["-y", "mongodb-atlas-mcp-remote@latest"] [mcp_servers.mongodb-atlas-mcp-remote.env] MDB_MCP_API_CLIENT_ID = "$CLIENT_ID" MDB_MCP_API_CLIENT_SECRET = "$SECRET" EOF
mcp-client-config.toml の内容をコピーし、~/.codex/config.toml ファイルの末尾に貼り付けます。
自己管理型 MongoDB
Local MCPをセットアップするには、Node.jsのバージョン22.12.0がインストールされていることを確認してください。以降。
Node.jsのバージョンを確認するには、次のコマンドを実行します。
node --version
ローカル Atlas 配置で Local MCP を使用できます。そのためには、Docker をインストールする必要があります。ローカル Atlas 配置の概要については、「ローカル Atlas 配置の作成」を参照してください。
セットアップユーティリティを実行します。
セットアップユーティリティは、初期の JSON 構成ファイルを作成するプロセスをガイドします。この JSON 構成ファイルは、サーバーに対して、MongoDB への接続方法と、そのデータを MCP クライアントと共有する方法を指示します。
コマンドラインから 、次のコマンドを実行します。
npx mongodb-mcp-server@latest setup
注意
あるいは、 Node.jsをインストールする必要がない場合は、 DockerコンテナでローカルMCPを実行することもできます。詳しく学ぶには、 Dockerの使用 を参照してください。
読み取り専用モード設定を提供します。
読み取り専用モードを使用して、MCP サーバーを読み取り操作のみを実行するように制限できます。読み取り専用モードを有効にするには、「Y」と入力します。
セキュリティのため、書込み操作を実行する必要がある場合を除き、常に読み取り専用モードを有効にしてください。書込み操作は後で有効にできます。詳細については、MCP サーバーの読み取り専用モード を参照してください。
接続文字列を入力します。
MongoDBクラスターの接続文字列を入力します。
たとえば、mongodb+srv://user:D1fficultP%40ssw0rd@mycluster.abcd1.mongodb.net/myDatabase?retryWrites=true&w=majority 。
詳しくは、接続文字列を検索するを参照してください。
Local MCP for MongoDB MCP サーバーの設定で問題が発生した場合は、「Local MCP サーバーのトラブルシューティング」を参照してください。
完全な構成オプションについては、 MCP サーバーと接続の構成 を参照してください。
Devin AI は、次の設定方法をサポートしています。
- MongoDB Atlas のプラグイン (マネージド MCP サーバー) (推奨): このオプションを使用すると、プラグインを使用して MongoDB Atlas クラスターに接続できます。
- MongoDB Atlas マネージド MCP サーバーの手動設定: このオプションを使用すると、Atlas CLI または Atlas API を使用して Atlas アクセスを設定した後に MongoDB Atlas クラスターに接続できます。
MongoDB Atlas
重要
Organization Owner は、ノードがプラグインで接続できるように、AI クライアント設定を有効にする必要があります。AI クライアント接続を有効にする方法については、「AI クライアントを有効にする」を参照してください。
Atlas にログインします。
ガイド付き Atlas OAuth フローを完了します。
Atlas にログインします。
重要
この手順を完了するには、Atlas CLI 1.58.0 以降が必要です。ターミナルで atlas --version を実行してバージョンを確認できます。アップグレードが必要な場合は、MongoDB Atlas CLI ダウンロード を参照してください。
ターミナルで、次のコマンドを実行します。
atlas auth login -P mcp
「**UserAccount**」を選択します。これにより、1 回限りの認証コードが返され、外部ブラウザウィンドウに移動します。1 回限りのコードを使用してログインし、アカウントを認証した後、ターミナルに戻ってください。
ターミナルのプロンプトに従って、プロフィールの設定を完了します。
組織またはプロジェクト ID 環境変数を設定します。
組織IDを<ORG_ID>に置き換えて、ターミナルで次のコマンドを実行し、組織レベルの設定の環境変数を設定します。
export ORG_ID="<ORG_ID>" # Set to use org-level config
Tip
代わりにプロジェクトレベルの設定を使用する場合は、組織IDの代わりにプロジェクトIDを設定できます。<GROUP_ID> をグループ ID に置き換えて実行してください。
export GROUP_ID="<GROUP_ID>" # Set to use project-level config instead of ORG_ID
MCP 構成を作成します。
ロールとアクセス用 IP アドレスを追加して、組織レベルの設定を作成するには、次のコマンドを実行します。
cat > /tmp/mcp-config.json <<EOF { "mcpConfigName": "my-config", "roles": ["ORG_OWNER"], "ipAccessList": [{"ipAddress": "$MY_IP"}] } EOF read -r MCP_CONFIG_ID CLIENT_ID <<< "$( atlas api remoteMcpConfigurations createOrgMcpConfig \ --orgId "$ORG_ID" \ --file /tmp/mcp-config.json \ -P mcp \ -o '{{.mcpConfigId}} {{.clientId}}' )" export MCP_CONFIG_ID export CLIENT_ID
Tip
代わりに プロジェクトレベルの構成 を使用する場合は、次のコマンドを実行します。
cat > /tmp/mcp-config.json <<EOF { "mcpConfigName": "my-config", "roles": ["GROUP_OWNER"], "ipAccessList": [{"ipAddress": "$MY_IP"}] } EOF read -r MCP_CONFIG_ID CLIENT_ID <<< "$( atlas api remoteMcpConfigurations createGroupMcpConfig \ --groupId "$GROUP_ID" \ --file /tmp/mcp-config.json \ -P mcp \ -o '{{.mcpConfigId}} {{.clientId}}' )" export MCP_CONFIG_ID export CLIENT_ID
クライアントシークレットを生成します。
次のコマンドを実行して、作成した組織レベルの構成のシークレットを作成します。secretExpiresAfterHours で作成するシークレットの有効期限を設定します。
重要
シークレットは 1 度しか検索できません。失くした場合は、新しいシークレットを作成して再生成します。
cat > /tmp/mcp-secret.json <<EOF {"secretExpiresAfterHours": 8760} EOF SECRET=$( atlas api remoteMcpConfigurations createOrgMcpSecret \ --orgId "$ORG_ID" \ --mcpConfigId "$MCP_CONFIG_ID" \ --file /tmp/mcp-secret.json \ -P mcp \ -o '{{.secret}}' ) export SECRET
Tip
代わりに プロジェクトレベルの構成 を使用する場合は、次のコマンドを実行します。
cat > /tmp/mcp-secret.json <<EOF {"secretExpiresAfterHours": 8760} EOF SECRET=$( atlas api remoteMcpConfigurations createGroupMcpSecret \ --groupId "$GROUP_ID" \ --mcpConfigId "$MCP_CONFIG_ID" \ --file /tmp/mcp-secret.json \ -P mcp \ -o '{{.secret}}' ) export SECRET
MCP クライアント構成を書き込みます。
次のコマンドを実行して構成ファイルを作成します。
cat > mcp-client-config.json <<EOF { "mcpServers": { "mongodb-atlas-mcp-remote": { "type": "stdio", "command": "npx", "args": ["-y", "mongodb-atlas-mcp-remote@latest"], "env": { "MDB_MCP_API_CLIENT_ID": "$CLIENT_ID", "MDB_MCP_API_CLIENT_SECRET": "$SECRET" } } } } EOF
Devin で、「カスタム MCP を追加」をクリックします。「JSON をインポート」をクリックし、mcp-client-config.json のコンテンツを貼り付けます。
公開 API キーを作成します。
公開キーを作成するには、Atlas Administration API の使用開始の手順に従ってください。
組織またはプロジェクト ID 環境変数を設定します。
次のコマンドを実行します。<ORG_ID> を組織の組織 ID に置き換えて、組織レベルの構成を行います。
export ORG_ID="<ORG_ID>" # Set to use org-level config instead of GROUP_ID
Tip
代わりにプロジェクトレベルの構成を使用する場合は、組織 ID の代わりにグループ ID を設定できます。<GROUP_ID> をグループ ID に置き換えて実行します。
export GROUP_ID="<GROUP_ID>" # Set to use project-level config instead of ORG_ID
MCP 構成を作成します。
次を実行し、応答からmcpConfigIdとclientIdの両方を抽出して、組織レベルの設定を行います。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/vnd.atlas.2025-03-12+json" \ -d "$(jq -n --arg ip "$MY_IP" '{ mcpConfigName: "my-config", roles: ["ORG_OWNER"], ipAccessList: [ {ipAddress: $ip}, {cidrBlock: "10.0.0.0/24"} ] }')" \ "https://cloud.mongodb.com/api/atlas/v2/orgs/$ORG_ID/mcpConfigs"
Tip
代わりにプロジェクト レベルの構成を使用する場合は、次を実行します。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/vnd.atlas.2025-03-12+json" \ -d "$(jq -n --arg ip "$MY_IP" '{ mcpConfigName: "my-config", roles: ["GROUP_OWNER"], ipAccessList: [ {ipAddress: $ip}, {cidrBlock: "10.0.0.0/24"} ] }')" \ "https://cloud.mongodb.com/api/atlas/v2/groups/$GROUP_ID/mcpConfigs"
ユーザーロールの詳細については、次を参照してください。
mcpConfigs API エンドポイントの詳細については、「リモート MCP 構成」を参照してください。
MCP クライアント シークレットを生成します。
次のコマンドを実行し、応答から 組織レベルの構成の secret を抽出します。
重要
シークレットは 1 度しか検索できません。失くした場合は、新しいシークレットを作成して再生成します。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H 'Content-Type: application/vnd.atlas.2025-03-12+json' \ -H 'Accept: application/vnd.atlas.2025-03-12+json' \ -d '{"secretExpiresAfterHours": 8760}' \ "https://cloud.mongodb.com/api/atlas/v2/orgs/$ORG_ID/mcpConfigs/$MCP_CONFIG_ID/secrets"
Tip
代わりにプロジェクト レベルの構成を使用する場合は、次を実行します。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H 'Content-Type: application/vnd.atlas.2025-03-12+json' \ -H 'Accept: application/vnd.atlas.2025-03-12+json' \ -d '{"secretExpiresAfterHours": 8760}' \ "https://cloud.mongodb.com/api/atlas/v2/groups/$GROUP_ID/mcpConfigs/$MCP_CONFIG_ID/secrets"
MCP クライアント構成を書き込みます。
次のコマンドを実行して構成ファイルを作成します。
cat > mcp-client-config.json <<EOF { "mcpServers": { "mongodb-atlas-mcp-remote": { "type": "stdio", "command": "npx", "args": ["-y", "mongodb-atlas-mcp-remote@latest"], "env": { "MDB_MCP_API_CLIENT_ID": "$CLIENT_ID", "MDB_MCP_API_CLIENT_SECRET": "$SECRET" } } } } EOF
Devin で、「カスタム MCP を追加」をクリックします。「JSON をインポート」をクリックし、mcp-client-config.json のコンテンツを貼り付けます。
自己管理型 MongoDB
注意
Devin AI は自己管理型 MongoDB をサポートしていません。
Grok Build は、次の設定方法をサポートしています。
- MongoDB Atlas のプラグイン (マネージド MCP サーバー) (推奨): このオプションを使用すると、プラグインを使用して MongoDB Atlas クラスターに接続できます。
- MongoDB Atlas マネージド MCP サーバーの手動設定: このオプションを使用すると、Atlas CLI または Atlas API を使用して Atlas アクセスを設定した後に MongoDB Atlas クラスターに接続できます。
- ローカル MCP 用プラグイン: このオプションを使用すると、ローカル MongoDB クラスターに接続できます。
- ローカル MCP の手動設定: このオプションを使用すると、ローカル MCP 環境を手動で設定した後に、ローカル MongoDB クラスターに接続できます。
MongoDB Atlas
重要
Organization Owner は、ノードがプラグインで接続できるように、AI クライアント設定を有効にする必要があります。AI クライアント接続を有効にする方法については、「AI クライアントを有効にする」を参照してください。
Atlas にログインします。
重要
この手順を完了するには、Atlas CLI 1.58.0 以降が必要です。ターミナルで atlas --version を実行してバージョンを確認できます。アップグレードが必要な場合は、MongoDB Atlas CLI ダウンロード を参照してください。
ターミナルで、次のコマンドを実行します。
atlas auth login -P mcp
「**UserAccount**」を選択します。これにより、1 回限りの認証コードが返され、外部ブラウザウィンドウに移動します。1 回限りのコードを使用してログインし、アカウントを認証した後、ターミナルに戻ってください。
ターミナルのプロンプトに従って、プロフィールの設定を完了します。
組織またはプロジェクト ID 環境変数を設定します。
組織IDを<ORG_ID>に置き換えて、ターミナルで次のコマンドを実行し、組織レベルの設定の環境変数を設定します。
export ORG_ID="<ORG_ID>" # Set to use org-level config
Tip
代わりにプロジェクトレベルの設定を使用する場合は、組織IDの代わりにプロジェクトIDを設定できます。<GROUP_ID> をグループ ID に置き換えて実行してください。
export GROUP_ID="<GROUP_ID>" # Set to use project-level config instead of ORG_ID
MCP 構成を作成します。
ロールとアクセス用 IP アドレスを追加して、組織レベルの設定を作成するには、次のコマンドを実行します。
cat > /tmp/mcp-config.json <<EOF { "mcpConfigName": "my-config", "roles": ["ORG_OWNER"], "ipAccessList": [{"ipAddress": "$MY_IP"}] } EOF read -r MCP_CONFIG_ID CLIENT_ID <<< "$( atlas api remoteMcpConfigurations createOrgMcpConfig \ --orgId "$ORG_ID" \ --file /tmp/mcp-config.json \ -P mcp \ -o '{{.mcpConfigId}} {{.clientId}}' )" export MCP_CONFIG_ID export CLIENT_ID
Tip
代わりに プロジェクトレベルの構成 を使用する場合は、次のコマンドを実行します。
cat > /tmp/mcp-config.json <<EOF { "mcpConfigName": "my-config", "roles": ["GROUP_OWNER"], "ipAccessList": [{"ipAddress": "$MY_IP"}] } EOF read -r MCP_CONFIG_ID CLIENT_ID <<< "$( atlas api remoteMcpConfigurations createGroupMcpConfig \ --groupId "$GROUP_ID" \ --file /tmp/mcp-config.json \ -P mcp \ -o '{{.mcpConfigId}} {{.clientId}}' )" export MCP_CONFIG_ID export CLIENT_ID
クライアントシークレットを生成します。
次のコマンドを実行して、作成した組織レベルの構成のシークレットを作成します。secretExpiresAfterHours で作成するシークレットの有効期限を設定します。
重要
シークレットは 1 度しか検索できません。失くした場合は、新しいシークレットを作成して再生成します。
cat > /tmp/mcp-secret.json <<EOF {"secretExpiresAfterHours": 8760} EOF SECRET=$( atlas api remoteMcpConfigurations createOrgMcpSecret \ --orgId "$ORG_ID" \ --mcpConfigId "$MCP_CONFIG_ID" \ --file /tmp/mcp-secret.json \ -P mcp \ -o '{{.secret}}' ) export SECRET
Tip
代わりに プロジェクトレベルの構成 を使用する場合は、次のコマンドを実行します。
cat > /tmp/mcp-secret.json <<EOF {"secretExpiresAfterHours": 8760} EOF SECRET=$( atlas api remoteMcpConfigurations createGroupMcpSecret \ --groupId "$GROUP_ID" \ --mcpConfigId "$MCP_CONFIG_ID" \ --file /tmp/mcp-secret.json \ -P mcp \ -o '{{.secret}}' ) export SECRET
公開 API キーを作成します。
公開キーを作成するには、Atlas Administration API の使用開始の手順に従ってください。
組織またはプロジェクト ID 環境変数を設定します。
次のコマンドを実行します。<ORG_ID> を組織の組織 ID に置き換えて、組織レベルの構成を行います。
export ORG_ID="<ORG_ID>" # Set to use org-level config instead of GROUP_ID
Tip
代わりにプロジェクトレベルの構成を使用する場合は、組織 ID の代わりにグループ ID を設定できます。<GROUP_ID> をグループ ID に置き換えて実行します。
export GROUP_ID="<GROUP_ID>" # Set to use project-level config instead of ORG_ID
MCP 構成を作成します。
次を実行し、応答からmcpConfigIdとclientIdの両方を抽出して、組織レベルの設定を行います。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/vnd.atlas.2025-03-12+json" \ -d "$(jq -n --arg ip "$MY_IP" '{ mcpConfigName: "my-config", roles: ["ORG_OWNER"], ipAccessList: [ {ipAddress: $ip}, {cidrBlock: "10.0.0.0/24"} ] }')" \ "https://cloud.mongodb.com/api/atlas/v2/orgs/$ORG_ID/mcpConfigs"
Tip
代わりにプロジェクト レベルの構成を使用する場合は、次を実行します。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/vnd.atlas.2025-03-12+json" \ -d "$(jq -n --arg ip "$MY_IP" '{ mcpConfigName: "my-config", roles: ["GROUP_OWNER"], ipAccessList: [ {ipAddress: $ip}, {cidrBlock: "10.0.0.0/24"} ] }')" \ "https://cloud.mongodb.com/api/atlas/v2/groups/$GROUP_ID/mcpConfigs"
ユーザーロールの詳細については、次を参照してください。
mcpConfigs API エンドポイントの詳細については、「リモート MCP 構成」を参照してください。
MCP クライアント シークレットを生成します。
次のコマンドを実行し、応答から 組織レベルの構成の secret を抽出します。
重要
シークレットは 1 度しか検索できません。失くした場合は、新しいシークレットを作成して再生成します。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H 'Content-Type: application/vnd.atlas.2025-03-12+json' \ -H 'Accept: application/vnd.atlas.2025-03-12+json' \ -d '{"secretExpiresAfterHours": 8760}' \ "https://cloud.mongodb.com/api/atlas/v2/orgs/$ORG_ID/mcpConfigs/$MCP_CONFIG_ID/secrets"
Tip
代わりにプロジェクト レベルの構成を使用する場合は、次を実行します。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H 'Content-Type: application/vnd.atlas.2025-03-12+json' \ -H 'Accept: application/vnd.atlas.2025-03-12+json' \ -d '{"secretExpiresAfterHours": 8760}' \ "https://cloud.mongodb.com/api/atlas/v2/groups/$GROUP_ID/mcpConfigs/$MCP_CONFIG_ID/secrets"
自己管理型 MongoDB
Local MCPをセットアップするには、Node.jsのバージョン22.12.0がインストールされていることを確認してください。以降。
Node.jsのバージョンを確認するには、次のコマンドを実行します。
node --version
ローカル Atlas 配置で Local MCP を使用できます。そのためには、Docker をインストールする必要があります。ローカル Atlas 配置の概要については、「ローカル Atlas 配置の作成」を参照してください。
セットアップユーティリティを実行します。
セットアップユーティリティは、初期の JSON 構成ファイルを作成するプロセスをガイドします。この JSON 構成ファイルは、サーバーに対して、MongoDB への接続方法と、そのデータを MCP クライアントと共有する方法を指示します。
コマンドラインから 、次のコマンドを実行します。
npx mongodb-mcp-server@latest setup
注意
あるいは、 Node.jsをインストールする必要がない場合は、 DockerコンテナでローカルMCPを実行することもできます。詳しく学ぶには、 Dockerの使用 を参照してください。
読み取り専用モード設定を提供します。
読み取り専用モードを使用して、MCP サーバーを読み取り操作のみを実行するように制限できます。読み取り専用モードを有効にするには、「Y」と入力します。
セキュリティのため、書込み操作を実行する必要がある場合を除き、常に読み取り専用モードを有効にしてください。書込み操作は後で有効にできます。詳細については、MCP サーバーの読み取り専用モード を参照してください。
接続文字列を入力します。
MongoDBクラスターの接続文字列を入力します。
たとえば、mongodb+srv://user:D1fficultP%40ssw0rd@mycluster.abcd1.mongodb.net/myDatabase?retryWrites=true&w=majority 。
詳しくは、接続文字列を検索するを参照してください。
Local MCP for MongoDB MCP サーバーの設定で問題が発生した場合は、「Local MCP サーバーのトラブルシューティング」を参照してください。
完全な構成オプションについては、 MCP サーバーと接続の構成 を参照してください。
fx CLI は、次の設定方法をサポートしています。
- MongoDB Atlas マネージド MCP サーバー (ユーザーデリゲーション) (推奨): このオプションを使用すると、ユーザーの AI クライアントが Atlas アイデンティティで動作することを認可することにより、ユーザーの MongoDB Atlas クラスターに接続できます。
- MongoDB Atlas マネージド MCP サーバーの手動設定: このオプションを使用すると、Atlas CLI または Atlas API を使用して Atlas アクセスを設定した後に MongoDB Atlas クラスターに接続できます。
- ローカル MCP の手動設定: このオプションを使用すると、ローカル MCP 環境を手動で設定した後に、ローカル MongoDB クラスターに接続できます。
MongoDB Atlas
重要
Organization Owner は、ノードがプラグインで接続できるように、AI クライアント設定を有効にする必要があります。AI クライアント接続を有効にする方法については、「AI クライアントを有効にする」を参照してください。
fx で MongoDB MCP サーバーを有効にする。
fx セッションを開き、次のコマンドを実行します:
/mcp auth mongodb --open
ガイド付きの OAuth フローを完了します。
Atlas にログインします。
重要
この手順を完了するには、Atlas CLI 1.58.0 以降が必要です。ターミナルで atlas --version を実行してバージョンを確認できます。アップグレードが必要な場合は、MongoDB Atlas CLI ダウンロード を参照してください。
ターミナルで、次のコマンドを実行します。
atlas auth login -P mcp
「**UserAccount**」を選択します。これにより、1 回限りの認証コードが返され、外部ブラウザウィンドウに移動します。1 回限りのコードを使用してログインし、アカウントを認証した後、ターミナルに戻ってください。
ターミナルのプロンプトに従って、プロフィールの設定を完了します。
組織またはプロジェクト ID 環境変数を設定します。
組織IDを<ORG_ID>に置き換えて、ターミナルで次のコマンドを実行し、組織レベルの設定の環境変数を設定します。
export ORG_ID="<ORG_ID>" # Set to use org-level config
Tip
代わりにプロジェクトレベルの設定を使用する場合は、組織IDの代わりにプロジェクトIDを設定できます。<GROUP_ID> をグループ ID に置き換えて実行してください。
export GROUP_ID="<GROUP_ID>" # Set to use project-level config instead of ORG_ID
MCP 構成を作成します。
ロールとアクセス用 IP アドレスを追加して、組織レベルの設定を作成するには、次のコマンドを実行します。
cat > /tmp/mcp-config.json <<EOF { "mcpConfigName": "my-config", "roles": ["ORG_OWNER"], "ipAccessList": [{"ipAddress": "$MY_IP"}] } EOF read -r MCP_CONFIG_ID CLIENT_ID <<< "$( atlas api remoteMcpConfigurations createOrgMcpConfig \ --orgId "$ORG_ID" \ --file /tmp/mcp-config.json \ -P mcp \ -o '{{.mcpConfigId}} {{.clientId}}' )" export MCP_CONFIG_ID export CLIENT_ID
Tip
代わりに プロジェクトレベルの構成 を使用する場合は、次のコマンドを実行します。
cat > /tmp/mcp-config.json <<EOF { "mcpConfigName": "my-config", "roles": ["GROUP_OWNER"], "ipAccessList": [{"ipAddress": "$MY_IP"}] } EOF read -r MCP_CONFIG_ID CLIENT_ID <<< "$( atlas api remoteMcpConfigurations createGroupMcpConfig \ --groupId "$GROUP_ID" \ --file /tmp/mcp-config.json \ -P mcp \ -o '{{.mcpConfigId}} {{.clientId}}' )" export MCP_CONFIG_ID export CLIENT_ID
クライアントシークレットを生成します。
次のコマンドを実行して、作成した組織レベルの構成のシークレットを作成します。secretExpiresAfterHours で作成するシークレットの有効期限を設定します。
重要
シークレットは 1 度しか検索できません。失くした場合は、新しいシークレットを作成して再生成します。
cat > /tmp/mcp-secret.json <<EOF {"secretExpiresAfterHours": 8760} EOF SECRET=$( atlas api remoteMcpConfigurations createOrgMcpSecret \ --orgId "$ORG_ID" \ --mcpConfigId "$MCP_CONFIG_ID" \ --file /tmp/mcp-secret.json \ -P mcp \ -o '{{.secret}}' ) export SECRET
Tip
代わりに プロジェクトレベルの構成 を使用する場合は、次のコマンドを実行します。
cat > /tmp/mcp-secret.json <<EOF {"secretExpiresAfterHours": 8760} EOF SECRET=$( atlas api remoteMcpConfigurations createGroupMcpSecret \ --groupId "$GROUP_ID" \ --mcpConfigId "$MCP_CONFIG_ID" \ --file /tmp/mcp-secret.json \ -P mcp \ -o '{{.secret}}' ) export SECRET
MCP クライアント構成を書き込みます。
次のコマンドを実行して構成ファイルを作成します。
cat > mcp-client-config.json <<EOF { "mcp": { "mongodb-atlas-mcp-remote": { "type": "stdio", "command": ["npx", "-y", "mongodb-atlas-mcp-remote@latest"], "environment": { "MDB_MCP_API_CLIENT_ID": "$CLIENT_ID", "MDB_MCP_API_CLIENT_SECRET": "$SECRET" } } } } EOF
mcp-client-config.json を開き、そのコンテンツをあなたの ~/.fx/mcp.json ファイルに貼り付けます。
公開 API キーを作成します。
公開キーを作成するには、Atlas Administration API の使用開始の手順に従ってください。
組織またはプロジェクト ID 環境変数を設定します。
次のコマンドを実行します。<ORG_ID> を組織の組織 ID に置き換えて、組織レベルの構成を行います。
export ORG_ID="<ORG_ID>" # Set to use org-level config instead of GROUP_ID
Tip
代わりにプロジェクトレベルの構成を使用する場合は、組織 ID の代わりにグループ ID を設定できます。<GROUP_ID> をグループ ID に置き換えて実行します。
export GROUP_ID="<GROUP_ID>" # Set to use project-level config instead of ORG_ID
MCP 構成を作成します。
次を実行し、応答からmcpConfigIdとclientIdの両方を抽出して、組織レベルの設定を行います。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/vnd.atlas.2025-03-12+json" \ -d "$(jq -n --arg ip "$MY_IP" '{ mcpConfigName: "my-config", roles: ["ORG_OWNER"], ipAccessList: [ {ipAddress: $ip}, {cidrBlock: "10.0.0.0/24"} ] }')" \ "https://cloud.mongodb.com/api/atlas/v2/orgs/$ORG_ID/mcpConfigs"
Tip
代わりにプロジェクト レベルの構成を使用する場合は、次を実行します。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/vnd.atlas.2025-03-12+json" \ -d "$(jq -n --arg ip "$MY_IP" '{ mcpConfigName: "my-config", roles: ["GROUP_OWNER"], ipAccessList: [ {ipAddress: $ip}, {cidrBlock: "10.0.0.0/24"} ] }')" \ "https://cloud.mongodb.com/api/atlas/v2/groups/$GROUP_ID/mcpConfigs"
ユーザーロールの詳細については、次を参照してください。
mcpConfigs API エンドポイントの詳細については、「リモート MCP 構成」を参照してください。
MCP クライアント シークレットを生成します。
次のコマンドを実行し、応答から 組織レベルの構成の secret を抽出します。
重要
シークレットは 1 度しか検索できません。失くした場合は、新しいシークレットを作成して再生成します。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H 'Content-Type: application/vnd.atlas.2025-03-12+json' \ -H 'Accept: application/vnd.atlas.2025-03-12+json' \ -d '{"secretExpiresAfterHours": 8760}' \ "https://cloud.mongodb.com/api/atlas/v2/orgs/$ORG_ID/mcpConfigs/$MCP_CONFIG_ID/secrets"
Tip
代わりにプロジェクト レベルの構成を使用する場合は、次を実行します。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H 'Content-Type: application/vnd.atlas.2025-03-12+json' \ -H 'Accept: application/vnd.atlas.2025-03-12+json' \ -d '{"secretExpiresAfterHours": 8760}' \ "https://cloud.mongodb.com/api/atlas/v2/groups/$GROUP_ID/mcpConfigs/$MCP_CONFIG_ID/secrets"
MCP クライアント構成を書き込みます。
次のコマンドを実行して構成ファイルを作成します。
cat > mcp-client-config.json <<EOF { "mcp": { "mongodb-atlas-mcp-remote": { "type": "stdio", "command": ["npx", "-y", "mongodb-atlas-mcp-remote@latest"], "environment": { "MDB_MCP_API_CLIENT_ID": "$CLIENT_ID", "MDB_MCP_API_CLIENT_SECRET": "$SECRET" } } } } EOF
mcp-client-config.json を開き、そのコンテンツをあなたの ~/.fx/mcp.json ファイルに貼り付けます。
自己管理型 MongoDB
Local MCPをセットアップするには、Node.jsのバージョン22.12.0がインストールされていることを確認してください。以降。
Node.jsのバージョンを確認するには、次のコマンドを実行します。
node --version
ローカル Atlas 配置で Local MCP を使用できます。そのためには、Docker をインストールする必要があります。ローカル Atlas 配置の概要については、「ローカル Atlas 配置の作成」を参照してください。
セットアップユーティリティを実行します。
セットアップユーティリティは、初期の JSON 構成ファイルを作成するプロセスをガイドします。この JSON 構成ファイルは、サーバーに対して、MongoDB への接続方法と、そのデータを MCP クライアントと共有する方法を指示します。
コマンドラインから 、次のコマンドを実行します。
npx mongodb-mcp-server@latest setup
注意
あるいは、 Node.jsをインストールする必要がない場合は、 DockerコンテナでローカルMCPを実行することもできます。詳しく学ぶには、 Dockerの使用 を参照してください。
読み取り専用モード設定を提供します。
読み取り専用モードを使用して、MCP サーバーを読み取り操作のみを実行するように制限できます。読み取り専用モードを有効にするには、「Y」と入力します。
セキュリティのため、書込み操作を実行する必要がある場合を除き、常に読み取り専用モードを有効にしてください。書込み操作は後で有効にできます。詳細については、MCP サーバーの読み取り専用モード を参照してください。
接続文字列を入力します。
MongoDBクラスターの接続文字列を入力します。
たとえば、mongodb+srv://user:D1fficultP%40ssw0rd@mycluster.abcd1.mongodb.net/myDatabase?retryWrites=true&w=majority 。
詳しくは、接続文字列を検索するを参照してください。
Local MCP for MongoDB MCP サーバーの設定で問題が発生した場合は、「Local MCP サーバーのトラブルシューティング」を参照してください。
完全な構成オプションについては、 MCP サーバーと接続の構成 を参照してください。
次の設定方法を持つ他のAIクライアントを使用できます。
- MongoDB Atlas マネージド MCP サーバーの手動設定: このオプションを使用すると、Atlas CLI または Atlas API を使用して Atlas アクセスを設定した後に MongoDB Atlas クラスターに接続できます。
- ローカル MCP の手動設定: このオプションを使用すると、ローカル MCP 環境を手動で設定した後に、ローカル MongoDB クラスターに接続できます。
MongoDB Atlas
Atlas にログインします。
重要
この手順を完了するには、Atlas CLI 1.58.0 以降が必要です。ターミナルで atlas --version を実行してバージョンを確認できます。アップグレードが必要な場合は、MongoDB Atlas CLI ダウンロード を参照してください。
ターミナルで、次のコマンドを実行します。
atlas auth login -P mcp
「**UserAccount**」を選択します。これにより、1 回限りの認証コードが返され、外部ブラウザウィンドウに移動します。1 回限りのコードを使用してログインし、アカウントを認証した後、ターミナルに戻ってください。
ターミナルのプロンプトに従って、プロフィールの設定を完了します。
組織またはプロジェクト ID 環境変数を設定します。
組織IDを<ORG_ID>に置き換えて、ターミナルで次のコマンドを実行し、組織レベルの設定の環境変数を設定します。
export ORG_ID="<ORG_ID>" # Set to use org-level config
Tip
代わりにプロジェクトレベルの設定を使用する場合は、組織IDの代わりにプロジェクトIDを設定できます。<GROUP_ID> をグループ ID に置き換えて実行してください。
export GROUP_ID="<GROUP_ID>" # Set to use project-level config instead of ORG_ID
MCP 構成を作成します。
ロールとアクセス用 IP アドレスを追加して、組織レベルの設定を作成するには、次のコマンドを実行します。
cat > /tmp/mcp-config.json <<EOF { "mcpConfigName": "my-config", "roles": ["ORG_OWNER"], "ipAccessList": [{"ipAddress": "$MY_IP"}] } EOF read -r MCP_CONFIG_ID CLIENT_ID <<< "$( atlas api remoteMcpConfigurations createOrgMcpConfig \ --orgId "$ORG_ID" \ --file /tmp/mcp-config.json \ -P mcp \ -o '{{.mcpConfigId}} {{.clientId}}' )" export MCP_CONFIG_ID export CLIENT_ID
Tip
代わりに プロジェクトレベルの構成 を使用する場合は、次のコマンドを実行します。
cat > /tmp/mcp-config.json <<EOF { "mcpConfigName": "my-config", "roles": ["GROUP_OWNER"], "ipAccessList": [{"ipAddress": "$MY_IP"}] } EOF read -r MCP_CONFIG_ID CLIENT_ID <<< "$( atlas api remoteMcpConfigurations createGroupMcpConfig \ --groupId "$GROUP_ID" \ --file /tmp/mcp-config.json \ -P mcp \ -o '{{.mcpConfigId}} {{.clientId}}' )" export MCP_CONFIG_ID export CLIENT_ID
クライアントシークレットを生成します。
次のコマンドを実行して、作成した組織レベルの構成のシークレットを作成します。secretExpiresAfterHours で作成するシークレットの有効期限を設定します。
重要
シークレットは 1 度しか検索できません。失くした場合は、新しいシークレットを作成して再生成します。
cat > /tmp/mcp-secret.json <<EOF {"secretExpiresAfterHours": 8760} EOF SECRET=$( atlas api remoteMcpConfigurations createOrgMcpSecret \ --orgId "$ORG_ID" \ --mcpConfigId "$MCP_CONFIG_ID" \ --file /tmp/mcp-secret.json \ -P mcp \ -o '{{.secret}}' ) export SECRET
Tip
代わりに プロジェクトレベルの構成 を使用する場合は、次のコマンドを実行します。
cat > /tmp/mcp-secret.json <<EOF {"secretExpiresAfterHours": 8760} EOF SECRET=$( atlas api remoteMcpConfigurations createGroupMcpSecret \ --groupId "$GROUP_ID" \ --mcpConfigId "$MCP_CONFIG_ID" \ --file /tmp/mcp-secret.json \ -P mcp \ -o '{{.secret}}' ) export SECRET
公開 API キーを作成します。
公開キーを作成するには、Atlas Administration API の使用開始の手順に従ってください。
組織またはプロジェクト ID 環境変数を設定します。
次のコマンドを実行します。<ORG_ID> を組織の組織 ID に置き換えて、組織レベルの構成を行います。
export ORG_ID="<ORG_ID>" # Set to use org-level config instead of GROUP_ID
Tip
代わりにプロジェクトレベルの構成を使用する場合は、組織 ID の代わりにグループ ID を設定できます。<GROUP_ID> をグループ ID に置き換えて実行します。
export GROUP_ID="<GROUP_ID>" # Set to use project-level config instead of ORG_ID
MCP 構成を作成します。
次を実行し、応答からmcpConfigIdとclientIdの両方を抽出して、組織レベルの設定を行います。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/vnd.atlas.2025-03-12+json" \ -d "$(jq -n --arg ip "$MY_IP" '{ mcpConfigName: "my-config", roles: ["ORG_OWNER"], ipAccessList: [ {ipAddress: $ip}, {cidrBlock: "10.0.0.0/24"} ] }')" \ "https://cloud.mongodb.com/api/atlas/v2/orgs/$ORG_ID/mcpConfigs"
Tip
代わりにプロジェクト レベルの構成を使用する場合は、次を実行します。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/vnd.atlas.2025-03-12+json" \ -d "$(jq -n --arg ip "$MY_IP" '{ mcpConfigName: "my-config", roles: ["GROUP_OWNER"], ipAccessList: [ {ipAddress: $ip}, {cidrBlock: "10.0.0.0/24"} ] }')" \ "https://cloud.mongodb.com/api/atlas/v2/groups/$GROUP_ID/mcpConfigs"
ユーザーロールの詳細については、次を参照してください。
mcpConfigs API エンドポイントの詳細については、「リモート MCP 構成」を参照してください。
MCP クライアント シークレットを生成します。
次のコマンドを実行し、応答から 組織レベルの構成の secret を抽出します。
重要
シークレットは 1 度しか検索できません。失くした場合は、新しいシークレットを作成して再生成します。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H 'Content-Type: application/vnd.atlas.2025-03-12+json' \ -H 'Accept: application/vnd.atlas.2025-03-12+json' \ -d '{"secretExpiresAfterHours": 8760}' \ "https://cloud.mongodb.com/api/atlas/v2/orgs/$ORG_ID/mcpConfigs/$MCP_CONFIG_ID/secrets"
Tip
代わりにプロジェクト レベルの構成を使用する場合は、次を実行します。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H 'Content-Type: application/vnd.atlas.2025-03-12+json' \ -H 'Accept: application/vnd.atlas.2025-03-12+json' \ -d '{"secretExpiresAfterHours": 8760}' \ "https://cloud.mongodb.com/api/atlas/v2/groups/$GROUP_ID/mcpConfigs/$MCP_CONFIG_ID/secrets"
自己管理型 MongoDB
Local MCPをセットアップするには、Node.jsのバージョン22.12.0がインストールされていることを確認してください。以降。
Node.jsのバージョンを確認するには、次のコマンドを実行します。
node --version
ローカル Atlas 配置で Local MCP を使用できます。そのためには、Docker をインストールする必要があります。ローカル Atlas 配置の概要については、「ローカル Atlas 配置の作成」を参照してください。
セットアップユーティリティを実行します。
セットアップユーティリティは、初期の JSON 構成ファイルを作成するプロセスをガイドします。この JSON 構成ファイルは、サーバーに対して、MongoDB への接続方法と、そのデータを MCP クライアントと共有する方法を指示します。
コマンドラインから 、次のコマンドを実行します。
npx mongodb-mcp-server@latest setup
注意
あるいは、 Node.jsをインストールする必要がない場合は、 DockerコンテナでローカルMCPを実行することもできます。詳しく学ぶには、 Dockerの使用 を参照してください。
読み取り専用モード設定を提供します。
読み取り専用モードを使用して、MCP サーバーを読み取り操作のみを実行するように制限できます。読み取り専用モードを有効にするには、「Y」と入力します。
セキュリティのため、書込み操作を実行する必要がある場合を除き、常に読み取り専用モードを有効にしてください。書込み操作は後で有効にできます。詳細については、MCP サーバーの読み取り専用モード を参照してください。
接続文字列を入力します。
MongoDBクラスターの接続文字列を入力します。
たとえば、mongodb+srv://user:D1fficultP%40ssw0rd@mycluster.abcd1.mongodb.net/myDatabase?retryWrites=true&w=majority 。
詳しくは、接続文字列を検索するを参照してください。
Local MCP for MongoDB MCP サーバーの設定で問題が発生した場合は、「Local MCP サーバーのトラブルシューティング」を参照してください。
完全な構成オプションについては、 MCP サーバーと接続の構成 を参照してください。
Atlas にログインします。
重要
この手順を完了するには、Atlas CLI 1.58.0 以降が必要です。ターミナルで atlas --version を実行してバージョンを確認できます。アップグレードが必要な場合は、MongoDB Atlas CLI ダウンロード を参照してください。
ターミナルで、次のコマンドを実行します。
atlas auth login -P mcp
「**UserAccount**」を選択します。これにより、1 回限りの認証コードが返され、外部ブラウザウィンドウに移動します。1 回限りのコードを使用してログインし、アカウントを認証した後、ターミナルに戻ってください。
ターミナルのプロンプトに従って、プロフィールの設定を完了します。
組織またはプロジェクト ID 環境変数を設定します。
組織IDを<ORG_ID>に置き換えて、ターミナルで次のコマンドを実行し、組織レベルの設定の環境変数を設定します。
export ORG_ID="<ORG_ID>" # Set to use org-level config
Tip
代わりにプロジェクトレベルの設定を使用する場合は、組織IDの代わりにプロジェクトIDを設定できます。<GROUP_ID> をグループ ID に置き換えて実行してください。
export GROUP_ID="<GROUP_ID>" # Set to use project-level config instead of ORG_ID
MCP 構成を作成します。
ロールとアクセス用 IP アドレスを追加して、組織レベルの設定を作成するには、次のコマンドを実行します。
cat > /tmp/mcp-config.json <<EOF { "mcpConfigName": "my-config", "roles": ["ORG_OWNER"], "ipAccessList": [{"ipAddress": "$MY_IP"}] } EOF read -r MCP_CONFIG_ID CLIENT_ID <<< "$( atlas api remoteMcpConfigurations createOrgMcpConfig \ --orgId "$ORG_ID" \ --file /tmp/mcp-config.json \ -P mcp \ -o '{{.mcpConfigId}} {{.clientId}}' )" export MCP_CONFIG_ID export CLIENT_ID
Tip
代わりに プロジェクトレベルの構成 を使用する場合は、次のコマンドを実行します。
cat > /tmp/mcp-config.json <<EOF { "mcpConfigName": "my-config", "roles": ["GROUP_OWNER"], "ipAccessList": [{"ipAddress": "$MY_IP"}] } EOF read -r MCP_CONFIG_ID CLIENT_ID <<< "$( atlas api remoteMcpConfigurations createGroupMcpConfig \ --groupId "$GROUP_ID" \ --file /tmp/mcp-config.json \ -P mcp \ -o '{{.mcpConfigId}} {{.clientId}}' )" export MCP_CONFIG_ID export CLIENT_ID
クライアントシークレットを生成します。
次のコマンドを実行して、作成した組織レベルの構成のシークレットを作成します。secretExpiresAfterHours で作成するシークレットの有効期限を設定します。
重要
シークレットは 1 度しか検索できません。失くした場合は、新しいシークレットを作成して再生成します。
cat > /tmp/mcp-secret.json <<EOF {"secretExpiresAfterHours": 8760} EOF SECRET=$( atlas api remoteMcpConfigurations createOrgMcpSecret \ --orgId "$ORG_ID" \ --mcpConfigId "$MCP_CONFIG_ID" \ --file /tmp/mcp-secret.json \ -P mcp \ -o '{{.secret}}' ) export SECRET
Tip
代わりに プロジェクトレベルの構成 を使用する場合は、次のコマンドを実行します。
cat > /tmp/mcp-secret.json <<EOF {"secretExpiresAfterHours": 8760} EOF SECRET=$( atlas api remoteMcpConfigurations createGroupMcpSecret \ --groupId "$GROUP_ID" \ --mcpConfigId "$MCP_CONFIG_ID" \ --file /tmp/mcp-secret.json \ -P mcp \ -o '{{.secret}}' ) export SECRET
エージェント フレームワークを使用して MCP サーバーにアクセスします。
LangChain などのエージェントフレームワークを使用して MCP サーバーにプログラムでアクセスするには、アクセストークンを取得してからアプリケーションから MCP サーバーを呼び出す必要があります。
Tip
次の例では、mcp[cli]、httpx、httpx2がインストールされていることを前提としています。pipを使用してインストールできます。
python3 -m pip install "mcp[cli]" httpx httpx2
以下に、MCP SDK を使用して MCP サーバーにアクセスする Python スクリプトの例を示します。
import asyncio import base64 import os import httpx import httpx2 from mcp import ClientSession from mcp.client.streamable_http import create_mcp_http_client, streamable_http_client async def fetch_access_token(client_id: str, client_secret: str) -> str: credentials = base64.b64encode( f"{client_id}:{client_secret}".encode() ).decode() async with httpx.AsyncClient() as client: response = await client.post( "https://cloud.mongodb.com/api/oauth/token", headers={ "Authorization": f"Basic {credentials}", "Content-Type": "application/x-www-form-urlencoded", "Accept": "application/json", }, data={"grant_type": "client_credentials"}, ) response.raise_for_status() return response.json()["access_token"] async def main() -> None: client_id = os.environ["CLIENT_ID"] client_secret = os.environ["SECRET"] mcp_url = os.getenv("MCP_URL", "https://mcp.mongodb.com") token = await fetch_access_token(client_id, client_secret) headers = { "Authorization": f"Bearer {token}", "Accept": "application/json, text/event-stream", "MCP-Protocol-Version": "2025-11-25", } http_client = create_mcp_http_client( headers=headers, timeout=httpx2.Timeout(30.0), ) async with http_client: async with streamable_http_client( mcp_url, http_client=http_client, ) as (read_stream, write_stream): async with ClientSession(read_stream, write_stream) as session: init_result = await session.initialize() print("Initialized:", init_result.protocol_version) result = await session.list_tools() for tool in result.tools: print(tool.name) if tool.description: print(f" {tool.description}") if __name__ == "__main__": asyncio.run(main())
公開 API キーを作成します。
公開キーを作成するには、Atlas Administration API の使用開始の手順に従ってください。
組織またはプロジェクト ID 環境変数を設定します。
次のコマンドを実行します。<ORG_ID> を組織の組織 ID に置き換えて、組織レベルの構成を行います。
export ORG_ID="<ORG_ID>" # Set to use org-level config instead of GROUP_ID
Tip
代わりにプロジェクトレベルの構成を使用する場合は、組織 ID の代わりにグループ ID を設定できます。<GROUP_ID> をグループ ID に置き換えて実行します。
export GROUP_ID="<GROUP_ID>" # Set to use project-level config instead of ORG_ID
MCP 構成を作成します。
次を実行し、応答からmcpConfigIdとclientIdの両方を抽出して、組織レベルの設定を行います。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/vnd.atlas.2025-03-12+json" \ -d "$(jq -n --arg ip "$MY_IP" '{ mcpConfigName: "my-config", roles: ["ORG_OWNER"], ipAccessList: [ {ipAddress: $ip}, {cidrBlock: "10.0.0.0/24"} ] }')" \ "https://cloud.mongodb.com/api/atlas/v2/orgs/$ORG_ID/mcpConfigs"
Tip
代わりにプロジェクト レベルの構成を使用する場合は、次を実行します。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/vnd.atlas.2025-03-12+json" \ -d "$(jq -n --arg ip "$MY_IP" '{ mcpConfigName: "my-config", roles: ["GROUP_OWNER"], ipAccessList: [ {ipAddress: $ip}, {cidrBlock: "10.0.0.0/24"} ] }')" \ "https://cloud.mongodb.com/api/atlas/v2/groups/$GROUP_ID/mcpConfigs"
ユーザーロールの詳細については、次を参照してください。
mcpConfigs API エンドポイントの詳細については、「リモート MCP 構成」を参照してください。
MCP クライアント シークレットを生成します。
次のコマンドを実行し、応答から 組織レベルの構成の secret を抽出します。
重要
シークレットは 1 度しか検索できません。失くした場合は、新しいシークレットを作成して再生成します。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H 'Content-Type: application/vnd.atlas.2025-03-12+json' \ -H 'Accept: application/vnd.atlas.2025-03-12+json' \ -d '{"secretExpiresAfterHours": 8760}' \ "https://cloud.mongodb.com/api/atlas/v2/orgs/$ORG_ID/mcpConfigs/$MCP_CONFIG_ID/secrets"
Tip
代わりにプロジェクト レベルの構成を使用する場合は、次を実行します。
curl -s --digest -u "$PUBLIC_API_KEY:$PRIVATE_API_KEY" \ -X POST \ -H 'Content-Type: application/vnd.atlas.2025-03-12+json' \ -H 'Accept: application/vnd.atlas.2025-03-12+json' \ -d '{"secretExpiresAfterHours": 8760}' \ "https://cloud.mongodb.com/api/atlas/v2/groups/$GROUP_ID/mcpConfigs/$MCP_CONFIG_ID/secrets"
エージェント フレームワークを使用して MCP サーバーにアクセスします。
LangChain などのエージェントフレームワークを使用して MCP サーバーにプログラムでアクセスするには、アクセストークンを取得してからアプリケーションから MCP サーバーを呼び出す必要があります。
Tip
次の例では、mcp[cli]、httpx、httpx2がインストールされていることを前提としています。pipを使用してインストールできます。
python3 -m pip install "mcp[cli]" httpx httpx2
以下に、MCP SDK を使用して MCP サーバーにアクセスする Python スクリプトの例を示します。
import asyncio import base64 import os import httpx import httpx2 from mcp import ClientSession from mcp.client.streamable_http import create_mcp_http_client, streamable_http_client async def fetch_access_token(client_id: str, client_secret: str) -> str: credentials = base64.b64encode( f"{client_id}:{client_secret}".encode() ).decode() async with httpx.AsyncClient() as client: response = await client.post( "https://cloud.mongodb.com/api/oauth/token", headers={ "Authorization": f"Basic {credentials}", "Content-Type": "application/x-www-form-urlencoded", "Accept": "application/json", }, data={"grant_type": "client_credentials"}, ) response.raise_for_status() return response.json()["access_token"] async def main() -> None: client_id = os.environ["CLIENT_ID"] client_secret = os.environ["SECRET"] mcp_url = os.getenv("MCP_URL", "https://mcp.mongodb.com") token = await fetch_access_token(client_id, client_secret) headers = { "Authorization": f"Bearer {token}", "Accept": "application/json, text/event-stream", "MCP-Protocol-Version": "2025-11-25", } http_client = create_mcp_http_client( headers=headers, timeout=httpx2.Timeout(30.0), ) async with http_client: async with streamable_http_client( mcp_url, http_client=http_client, ) as (read_stream, write_stream): async with ClientSession(read_stream, write_stream) as session: init_result = await session.initialize() print("Initialized:", init_result.protocol_version) result = await session.list_tools() for tool in result.tools: print(tool.name) if tool.description: print(f" {tool.description}") if __name__ == "__main__": asyncio.run(main())
次のステップ
MongoDB MCP サーバーで利用可能なツールの一覧については、「サポートされているツール」を参照してください。
MongoDB サーバーの使用例については、「MongoDB サーバーの使用例。」を参照してください。