Devin を MongoDB に接続する

​

2 つのプレーンと 2 つの ID

• データベースユーザーを作成できるサービスアカウント (GROUP_OWNER、GROUP_DATABASE_ACCESS_ADMIN) は、データプレーン用の ID を自身で発行できます。実際に MongoDB MCP サーバーは、クラスターへの接続を指示されるとこれを行います (オプション B) 。
• スロークエリのデータには、クエリのリテラル値がそのまま含まれます。

​

Devin の接続方法を選択する

​

Devin を MongoDB に接続する理由

• スキーマはドキュメント自体に存在します。 MongoDB には information_schema がなく、Mongoose や Prisma のモデルは実際に保存されているデータとずれていきます。Devin は稼働中のコレクションからサンプルを取得し、実際のデータ構造に基づいて作業します。
• 低速クエリの調査から修正までが 1 つのセッションで完結します。 Devin は Performance Advisor とスロークエリログを読み取り、実際のコレクションに対して explain() を実行します。さらに、そのクエリを発行しているコードを特定し、修正内容と推奨インデックスを含むプルリクエスト (PR) を作成します。
• Devin が操作できる範囲は、データベースユーザーのロールによって決まります。 まずは本番環境への権限を読み取り専用にとどめ、書き込みには devin_dev サンドボックスを使用してください。すべてのアクションは Devin 専用の ID で Atlas のログに記録されます。

​

前提条件

• クラスターを含むプロジェクト。
• サービスアカウントの作成には Organization Owner、データベースユーザーとアクセスリストの設定には Project Owner のロール。

• 環境ブループリントの編集とシークレットの追加を行う権限。
• MCP を利用する方法の場合は、Manage MCP Servers 権限。

• プロジェクトの IP アクセスリストに Devin の IP が登録されていること (ステップ 1) 。
• Devin のネットワークポリシーを利用している場合は、*.mongodb.net と cloud.mongodb.com に加え、ブループリントがインストール元として使用するホスト (オプション A では pgp.mongodb.com と repo.mongodb.org、オプション B では registry.npmjs.org と nodejs.org) を許可してください。ドライバーは 443 ではなくポート 27017 で接続しますが、ポリシーの項目はホスト名または CIDR で指定するため、ポートの設定は不要です。スナップショットの build にも同じポリシーが適用されます。

​

ステップ 1: ネットワークアクセスを許可する

atlas accessLists create <ip> --type ipAddress --comment "Devin" --projectId <project-id>
atlas accessLists create <cidr> --type cidrBlock --comment "Devin" --projectId <project-id>

​

ステップ 2: Devin の ID を作成する

​

データベースユーザー

atlas dbusers create \
  --username devin-sessions \
  --password "<generated-password>" \
  --role read@analytics,read@billing,readWrite@devin_dev \
  --scope <cluster-name> \
  --projectId <project-id>

​

サービスアカウント (Devin がコントロールプレーンを必要とする場合のみ)

​

ステップ 3: Devin を接続する

​

オプション A: ブループリントで CLI を使用する

​

1. Devin シークレット を追加する

​

2. ブループリントを追加する

initialize:
  - name: Install the Atlas CLI and mongosh
    run: |
      curl -fsSL https://pgp.mongodb.com/server-8.0.asc \
        | sudo gpg --batch --yes -o /usr/share/keyrings/mongodb-server-8.0.gpg --dearmor
      echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/8.0 multiverse" \
        | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list
      sudo apt-get update
      sudo apt-get install -y mongodb-atlas-cli mongodb-mongosh
      atlas --version && mongosh --version

knowledge:
  - name: mongodb-access
    contents: |
      Connect to MongoDB with `mongosh "$MONGODB_URI"`; the URI is a Devin Secret. The Atlas CLI
      authenticates as a service account from MONGODB_ATLAS_CLIENT_ID and MONGODB_ATLAS_CLIENT_SECRET,
      with MONGODB_ATLAS_PROJECT_ID as the default project. Do not run `atlas auth login`, do not ask
      for a username, password, or API key, and never write the connection string into a file, script,
      log, or PR. Production databases are read-only; write only to the devin_dev database. Ship
      schema, index, and migration changes through a pull request.

​

3. スナップショットを build する

​

オプション B: MongoDB MCP サーバー

• --readOnly を指定すると、create、update、delete 系のツールは登録されず、$out または $merge を含む集計は拒否されます。指定しない場合、これらの集計は確認プロンプトの後に実行されます。MCP クライアントがプロンプトに対応していない場合は、確認なしで実行されます。本番環境に接続する場合は必ず指定してください。
• --indexCheck は、実行計画がコレクションスキャンになるクエリを拒否します。これはパフォーマンスのための Guardrails です。なお、explain 自体が失敗した場合、クエリはそのまま実行されます。

initialize:
  - name: Install Node.js for the MongoDB MCP server
    uses: github.com/actions/setup-node@v4
    with:
      node-version: "22"

​

オプション C: MongoDB Atlas プラグイン

1. 組織のオーナーが AI クライアント アクセスを有効にし (Organization Settings > App Connections) 、アクセス モードを Read に設定します。これにより、書き込み系のツールは登録されなくなります。この設定は Devin に限らず、組織内のすべての AI クライアントに適用されます。
2. Devin 専用の Atlas ユーザーを作成し、読み取りを許可するプロジェクトに限定して GROUP_READ_ONLY と GROUP_DATA_ACCESS_READ_ONLY を付与します。GROUP_DATA_ACCESS_READ_ONLY ではプロジェクト内のすべてのデータベースのドキュメントを読み取れるため、devin-sessions ユーザーよりも権限の範囲が広くなります。
3. プラグインをインストールし、Customize > MCPs で OAuth ログインを一度だけ行います。その際は、自分のアカウントではなく、作成した専用ユーザーでサインインしてください。
4. 動作を確認できたら、プラグインをコミットに固定します。

​

再ビルドとバージョンの固定

​

ステップ 4: 権限を設定する

​

ステップ 5: 検証

mongosh "$MONGODB_URI" --quiet --eval 'JSON.stringify(db.runCommand({connectionStatus: 1}), null, 2)'
atlas clusters list --projectId "$MONGODB_ATLAS_PROJECT_ID"

mongosh "$MONGODB_URI" --quiet --eval 'db.getSiblingDB("<prod-db>").devin_probe.insertOne({probe: 1})'
mongosh "$MONGODB_URI" --quiet --eval 'db.getSiblingDB("devin_dev").devin_probe.insertOne({probe: 1}); db.getSiblingDB("devin_dev").devin_probe.drop()'

​

トラブルシューティング

​

制限事項

​

サポート