MongoDB Agent テンプレートを使用したエージェントの構築

利用可能なテンプレート

MongoDBエージェントのリポジトリには次のテンプレートが含まれています。

前提条件

MongoDB Agent テンプレートを使用する前に、次の前提条件が必要です。

• Node.js 24 以降。

• pnpm.

• Atlas CLI 1.58 以降。

• agentengineCLI。 CLI をインストールする方法については、 MongoDB Atlas Agent Engine のドキュメントの「 インストールと認証 」を参照してください。

• エージェントで調査するデータを含むMongoDB Atlasプロジェクト。

• 大規模言語モデル（llm）プロバイダーのAPIキー。デフォルトでは 、テンプレートは OpenAI を使用します。

認証情報とアクセス権の設定

MongoDB Agent テンプレートは、プロジェクト レベルのMongoDB MCP 構成を通じてMongoDB Atlasプロジェクトに接続します。アクセスを構成するには、次の手順に従います。

1. Atlas CLI を使用して、 MongoDB Atlasにプロジェクトレベルの MCP 構成を作成します。

   1. 以下のコマンドを実行して、プロジェクトレベルの MCP 構成を作成します。プロジェクトIDを指定するには --groupId オプションを使用し、リクエストファイルへのパスを指定するには --file オプションを使用します。

      atlas api remoteMcpConfigurations createGroupMcpConfig --groupId <your-group-id> --file <your-request-file-path>

   2. エージェントに必要な最小特権のMongoDB Atlasロール（GROUP_DATA_ACCESS_READ_ONLY など）を割り当てます。

   3. MCP構成ファイルで、ローカル パブリックIPアドレスとMongoDB Atlas Agent Engine のIPアドレスを追加します。 34.196.57.85 と 54.227.181.25 の 2 つのアドレスは、Atlas エージェント エンジンのIPアドレスです。 YOUR_LOCAL_PUBLIC_IP を自分のアドレスに置き換え、配置されたエージェントが接続できるように両方の Atlas Agent Engine アドレスを保持します。以下は、リクエストサンプルの例です。

      {
        "mcpConfigName": "{template-name-environment}",
        "roles": [
          "GROUP_DATA_ACCESS_READ_ONLY"
        ],
        "ipAccessList": [
          {
            "ipAddress": "YOUR_LOCAL_PUBLIC_IP"
          },
          {
            "ipAddress": "34.196.57.85"
          },
          {
            "ipAddress": "54.227.181.25"
          }
        ]
      }

2. MCP 構成のクライアントシークレットを作成します。シークレットは、構成のロールを継承します。

   1. 以下のコマンドを実行して、クライアントシークレットを作成します。プロジェクトIDを指定するには --groupId オプションを使用し、MCP 構成のIDを指定するには --mcpConfigId オプションを、シークレットメタデータファイルへのパスを指定するには --file オプションを使用します。

      atlas api remoteMcpConfigurations createGroupMcpSecret --groupId <your-group-id> --mcpConfigId <your-mcp-id> --file <your-metadata-file-path>

   2. メタデータファイルで、シークレットの有効期限を設定します。次の例では、8760 時間（1 年）後に期限切れになるシークレットメタデータファイルを示しています。

      {
        "secretExpiresAfterHours": 8760
      }

   3. クライアントシークレットをすぐにコピーして保存します。コマンドはクライアントシークレットを 1 回だけ返します。

3. クライアントID、クライアントシークレット、および LM プロバイダーAPIキーを保存します。

   1. ローカル開発では、これらは .envファイルに保存されます。配置されたエージェントの場合は、agentengine secret set コマンドを使用して Atlas Agent Engine のシークレット ストアにそれらを保存します。

ローカル開発、ステージング、本番などの各環境に対して個別の MCP 構成とシークレットを作成します。環境間で認証情報を共有しないでください。

クライアントシークレットは MCP 構成のロールを継承するため、エージェントを使用するすべてのユーザーがMongoDB Atlasアクセスを共有します。したがって、エージェントのすべてのユーザーが必要とするMongoDB Atlasロールのみを付与します。

各テンプレートの完全なコマンドと構成ファイルについては、「 MongoDB Agent テンプレート README 」を参照してください。 Atlas Agent Engine でシークレットを保存する方法の詳細については、 MongoDB Atlas Agent Engine ドキュメントの「 シークレットのプロビジョニング 」を参照してください。

テンプレートの実行と配置

エージェントの認証情報を構成 したら、テンプレートをローカルで実行してテストし、 MongoDB Atlas Agent Engine に配置します。

agentengine dev up

agentengine deploy --auto

セキュリティとデータ

次のリストには、 MongoDB Agent テンプレートのセキュリティとデータに関する考慮事項が含まれています。

• デフォルトは読み取り専用 。 MongoDB Atlas Explorer は、 MCP 構成書込みロールを付与し、ALLOW_WRITE_OPERATIONS 環境変数を に設定している場合にのみ、 MongoDBtrue Atlasに書込みます。すべての書き込みは人間の承認のために一時停止されます。 MongoDB Atlas Query Insights はMongoDB Atlasに書き込みを行えません。

• トレースと対話にはデータが含まれます。 MongoDB Atlas Agent Engine は、プロジェクト内の各トレースとメンバーシップを保存します。トレースと対話には、データベース、コレクション、 のフィールド名と、エージェントが読み取るドキュメントが含まれる場合があります。プロジェクトにアクセスできるユーザーのみがそれらを表示できます。データを管理する責任があります。詳細については、 MongoDB Atlas Agent エンジンのドキュメントの「 検査トレース書 」を参照してください。

• LVM プロバイダーには プロンプトとツールの結果が表示されます。これには、エージェントが読み取ったクエリ結果が含まれます。データ処理ポリシーが組織のデータ ポリシーを満たす LVM プロバイダーを選択します。

• シェルアクセスなし。エージェントは、サンドボックス内でシェルコマンドを実行できません。

• 任意のSlackボットをホストします。 Slackボットは例であり、マネージド サービスではありません。ホスト、保護、保守は自分で行います。

制限

MongoDB Agent テンプレートには、次の制限があります。

• テンプレートにはMongoDB Atlas が必要です。 MongoDB Enterprise Advanced、オンプレミス配置、またはMongoDB Atlas for Government はサポートされていません。

• 公式配置ワークフローはMongoDB Atlas Agent Engine のみをサポートします。セルフホスト型ランタイムはサポートされていません。

• エージェントは、MongoDB Atlas環境の経時的な変更を追跡しません。

• 各 MCP 構成には 1 時間あたりのキャパシティー制限があります。 MongoDB Atlasサービス100 アカウントは最大 のアクティブなアクセス トークンを保持でき、各トークンは 1 時間有効です。同じ MCP 構成を使用するすべてのワークスペースとクライアントがその制限を共有します。 MongoDB Atlas Agent Engine は、通信を開始するたびに 2 つのトークンを作成するか、アイドル タイムアウト後に再開するたびに 2 つのトークンを作成します。そのウィンドウ内の追跡メッセージはセッションのプロセスを再利用し、トークンを作成しません。これにより、40 は50 1 時間あたりの新規または再開で を可能にします。エージェントがトークンの制限に達すると、古いトークンの有効期限が切れるまで新しい対話は失敗します。これには最大 1 時間かかります。詳細については、 MongoDBエージェントリポジトリの「アクセス トークン制限」を参照してください。

各テンプレートには、このリストがカバーしていない個々の制限もあります。最新の制限情報については、 MongoDBエージェントのリポジトリを参照してください。

詳細

MongoDBで動作するエージェントの詳細については、次のリソースを参照してください。

• MongoDBエージェント リポジトリ

• MongoDB Agent 実力

• MongoDB MCP サーバー ドキュメント

• MongoDB Atlas Agent Engine のドキュメント