MongoDB MCP サーバー構成メソッド

MongoDB MCP Server を構成してMongoDBクラスターに接続し、その他の MCP サーバーオプションを設定するには、次のいずれかの方法を使用します。

MCP サーバーオプションを含むJSON構成ファイル
コマンドラインオプション
オペレーティングシステムの環境変数

MCP サーバーは、Atlas API認証情報または接続文字列を使用してクラスターにアクセスします。

MCP サーバークラスターの接続メソッドとオプション

クラスターに接続し、その他の MCP サーバーオプションを設定するように MCP サーバーを構成するには、このセクションで説明されている方法を使用します。

注意

MCP Server構成ファイルの例には、データへの読み取り専用アクセスを確保するために --readOnly が含まれています。通常は、データ変更を防ぐために読み取り専用モードを有効にします。

書込み操作を有効にするには、--readOnly を省略するか、オペレーティングシステムの環境変数 MDB_MCP_READ_ONLY を false に設定します。詳細については、 MCP サーバーの読み取り専用モードの有効化を参照してください。

MCP Server構成ファイルの例では、typeフィールドを "stdio" に設定しています。

type 次のいずれかに設定できます。

"stdio"は、MCP サーバーとの通信に標準の入力と出力を使用します。stdio はほとんどのAIクライアントに適しています。通常は stdio を使用します。
"http"、これにより MCP サーバーとのHTTP通信が可能になります。その後、 HTTPを使用して、Webクライアントから MCP Server とやり取りできるようになります。
警告
HTTP は、認証とセキュリティを実装せずに本番環境で使用することは推奨されません。

MCP Server構成ファイルの例では、MCP サーバー名も "MongoDB" に設定されています。MCP サーバーの起動後に、サーバー名を MCP サーバーの名前と一致するように変更できます。サーバー名は、 AIクライアントに対して MCP サーバーを識別します。

Atlas API認証情報による接続

「Atlas ツールを実行するためのMongoDB MCP Server の前提条件」で取得した Atlas API認証情報を使用して、Atlas クラスターに接続できます。

注意

次のセクションで示すように、セキュリティ上の理由で Atlas API の認証情報を使用したくない場合は、 MongoDB接続文字列を使用して Atlas クラスターに接続することもできます。

ログイン認証情報や接続情報などの機密性の高い構成設定には、コマンドライン引数の代わりに環境変数を使用します。例、 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 クラスターに接続するための接続文字列を示しています。

...
"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 オプションを設定します。

次のセクションの例で、<atlas-service-account-client-id>、<atlas-service-account-client-secret>、<user-name>、<password>、<cluster-name>、<database-name> を Atlas 情報に置き換えます。

Unix 環境変数

次の例は、Unix ベースのオペレーティングシステムで MCP Server 環境変数を定義する方法を示しています。

# 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"

詳細

戻る

オプション

機能を有効または無効にする

MCP サーバー クラスターの接続メソッドとオプション

注意

警告