AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。
Docs Menu

MongoDB Atlasの MCP アクセス モデル

MongoDB MCP サーバーは、Atlas に接続するための 2 つのアクセスモデルを提供します。

どちらのアクセス モデルでも、同じMongoDB MCP Server と同じツール セットが使用されます。アクセス権の付与方法、アクションの属性、管理者による管理方法が異なります。 MCP の使用方法に一致するアクセス モデルを選択します。

これらのアクセスモデルを使用して、Atlas がホストするクラスターにのみ接続できます。 MongoDB Community Edition やMongoDB Enterprise Advancedなど、Atlas の外部にあるMongoDBデプロイに接続するには、 MCPサーバーを自分で実行します。詳細については、 「 MongoDB MCP Server の概要 」を参照してください。

ユーザー認証アクセスでは、 AIクライアントはOAuth を使用して、個々の Atlas ユーザーに代わって Atlas に接続します。ユーザーは Atlas App Connections を通じてAIクライアントを認可し、クライアントはそのユーザーの既存の Atlas 権限を使用して動作します。クライアントは、ユーザーがすでに許可されている操作を超えることはできません。

このモデルは、コーディング中にデータを調査したり、クエリを作成したりするなど、プロンプトを発行しているAIクライアントでのインタラクティブな作業に使用します。

このモデルは、 MongoDB が事前に登録するAIクライアントでのみ機能します。 MongoDB がサポートするクライアントについては、 「サポートされているAIクライアント」 を参照してください。自分で構築したエージェントを接続するには、 サービス アカウントを介したプログラムによるアクセス を使用します。

主な特徴:

  • ID: AIクライアントは、それを許可した個々の Atlas ユーザーに代わって動作します。

  • 設定: ユーザーはAIクライアントのマーケットプレイスから接続し、ブラウザでアクセスを許可します。プロビジョニングするインフラストラクチャはありません。

  • 権限: 認可された Atlas ユーザーの既存のロール、および組織が設定したアクセスモードに基づきます。アクセスは、そのユーザー自身の権限を超えることはできません。どのロールが読み取りアクセス権および書込みアクセス権を持つかを確認するには、「 ユーザー ロール と データベース アクセス 」を参照してください。

  • 管理: 組織所有者は、組織レベルでAIクライアントのアクセスを有効にし、読み取り専用または読み取り/書き込みモードを設定します。これにより、 AIクライアントは、認可された Atlas ユーザーが持つよりも少ない権限に制限できます。アクセスは、新しいユーザーがサインアップしたときに Atlas が作成する組織を除き、デフォルトで無効になっています 。有効化は、すべてのAIクライアントにグループとして適用されます。 1 つのAIクライアントを有効にして、別の AI クライアントを無効のままにすることはできません。また、特定のプロジェクトへのAIクライアントのアクセスを制限することもできません。アクセスを有効にして構成する方法については、「 組織へのAIクライアント アクセスの管理 」を参照してください。

  • 属性: Atlas は個々のツール呼び出しをレコードません。クラスターの作成など、ツール呼び出しによって監査するイベントが作成されると、そのイベントは認可された Atlas ユーザーとAIクライアント の両方を記録します。

ユーザーによるアクセスでは、次のAIクライアントがサポートされています。

  • ChartGPT(ディスク上とウェブ)

  • Crude Code(ディスク上とウェブ)

  • Codex CLI

  • Cursor

  • Devin

  • Devin Desktop

  • GitHub Copilit CLI

  • Grok

  • Grok CLI

  • Visual Studio Code

プログラムによるアクセスでは、自動エージェントは、管理者がプロビジョニングして構成した サービス アカウント を使用して Atlas に接続します。自動エージェントは、各ステップを手動で承認するユーザーなしで複数ステップのワークフローを実行します。エージェントは、個々のユーザーとしてではなく、割り当てられた Atlas ロールでそのサービス アカウントを使用して動作します。

このモデルは、本番パイプラインなどのエージェントフレームワークで構築された自動化されたマルチステップ ワークフローに使用します。このモデルでは、管理者はエージェントが使用するサービスアカウントを作成するため、 MongoDB がエージェントを事前に登録する必要はありません。したがって、このモデルは自分で構築したエージェントで使用できます。

管理者が MCP 構成を作成すると、Atlas はそのためのサービス アカウントのペアを作成します。構成では、エージェントが受け取る Atlas ロールと、それに適用されるアクセス制御を指定します。 1 つのサービス アカウントはエージェントがMCPサーバー にアクセスできるようにし、Atlas は他のサービス アカウントを監査するイベントに記録します。

主な特徴:

  • ID:エージェントは設定されたサービス アカウントとして機能します。

  • セットアップ: 管理者が提供する。エージェントが必要とする範囲に応じて、組織オーナーが組織レベルのロールを持つ構成を作成するか、プロジェクトオーナーがプロジェクトレベルのロールを持つ構成を作成します。

  • 管理: 各構成には、独自のロール、任意のIP アクセス リスト、および読み取り専用設定があります。 Atlas は、構成を作成するときに読み取り専用を事前に選択します。構成が読み取り専用の場合、エージェントは書込みツールを使用できません。

  • 属性: Atlas は個々のツール呼び出しをレコードません。ツール呼び出しによって監査するイベントが作成されると、そのイベントは個々のユーザーではなく、 サービス アカウント を記録します。

次の表は、ユーザーによるアクセスモデルとプログラムによるアクセスモデルの主要な特性を比較したものです。

ユーザー権限(アプリ接続)
プログラマティック(サービス アカウント)

ID と属性

Atlas の個々のユーザー

サービス アカウント

セットアップ

ユーザーはクライアントのマーケットプレイスからAIクライアントを認可します

管理者が構成をプロビジョニングする

権限

ユーザーの既存の Atlas ロール

サービス アカウントの割り当てられたロール

管理者コントロール

すべてのAIクライアントをグループ、読み取り専用、または読み取り/書込みモードとして組織レベルで有効にします。デフォルトで無効です。

作成時に事前選択される、構成ごとの ロール、任意のIP アクセス リスト、および読み取り専用設定。

に最適

対話型AIコーディング

自動化されたマルチステップ ワークフロー

インタラクティブな作業のために Atlas にAIクライアントを接続する個々の開発者で、自分の Atlas ID と権限でアクションを実行する場合は、 ユーザー権限アクセスを選択します 。

専用のサービス アカウントで、個々のユーザーとは独立して実行する必要がある自動エージェントまたは本番環境のワークフローを作成している場合は、プログラムによるアクセスを選択します。