MongoDB Atlas App Connections 讓 Claude Code、Codex、ChatGPT、Cursor 等 AI 工具，透過 OAuth 2.1 與官方 Atlas MCP Server 操作雲端資料庫。開發者不用再把 Atlas 密碼、connection string 或長期 service account 憑證交給 AI 工具。
這項功能已在 2026 年 8 月進入 GA（Generally Available，正式可用）。設定變簡單不代表權限可以略過：App Connections 會沿用授權者的 Atlas 身分，而且目前主要控管範圍是整個 organization。本文整理連線流程、權限邊界，以及互動式 AI 工具和自動化 Agent 應選的不同 access model。
MongoDB Atlas App Connections 是什麼
Atlas App Connections 是 MongoDB Atlas 內建的 OAuth 2.1 使用者委派平台。MongoDB Atlas 是 MongoDB 的雲端資料庫服務，負責建立 cluster、管理帳號、備份、監控與資料存取；本站的 MariaDB 與 MongoDB 選型 文章另有整理文件型資料庫的用途。
MCP（Model Context Protocol）負責讓 AI client 呼叫外部工具，App Connections 則負責「這個 client 以誰的身分進入 Atlas、能做什麼、何時失效」。使用者在瀏覽器直接登入 Atlas 並核准權限，AI client 不會取得 Atlas 密碼或長期憑證；後續透過 MongoDB Atlas MCP Server 管理 cluster、查看設定或查詢資料。
MongoDB 在 2026 年 8 月 14 日把 AI coding tools 的 App Connections 標為 GA，8 月 26 日再發布完整公告。這次變更的價值在於把 AI coding tool 原本需要建立、保管並交付長期 service account credential 的連線方式，改成可撤銷、可歸屬到個別使用者的委派連線。
支援哪些 AI 工具
MongoDB 官方文件截至 2026 年 8 月 27 日列出的 user-delegated clients 包含 ChatGPT Desktop 與 Web、Claude Desktop 與 Web、Claude Code、Codex、Cursor、Devin AI 和 Grok Build。各 client 的安裝入口不同，但都由使用者從 client 端啟動，再跳到 Atlas 完成授權。
這份名單不代表任何支援 MCP 的 client 都能直接使用 App Connections。User-delegated access 只開放給 MongoDB 預先註冊的 clients；自行開發的 Agent 或無人值守流程，要改用 MCP Configurations 的 programmatic access。
OAuth 2.1 連線流程
App Connections 採 OAuth 2.1 Authorization Code flow 與 PKCE。開發者先在 AI client 安裝 MongoDB 的 plugin 或 connector，從 client 發起連線，再由瀏覽器登入 Atlas、閱讀 consent 畫面並核准。Atlas 隨後發出短期 access token 與 refresh token，client 不必為每次操作重新要求登入。
AI client 取得的有效權限，是「授權者原有的 Atlas role」和「Organization Owner 設定的 AI client access mode」兩者中較嚴格的一方。使用者只有 read-only role 時，組織即使允許 read and write，AI client 仍然只能讀取；組織設成 read-only，也能把原本具有寫入權限的使用者限制在唯讀工具。
| Access mode | AI client 可見工具 | 適合情境 |
|---|---|---|
| Read | find、aggregate、count、schema inspection 等讀取工具 | 查詢資料、分析 schema、檢查索引 |
| Read and write | 再加入 insert-many、update-many、create-collection、create-index 等工具 | 確定需要由 AI client 修改資料或資源 |
| Disabled | 不允許 AI client 建立連線 | 組織不使用 delegated AI access |
安全上建議先用 Read。MongoDB 的 安全文件 提醒，MCP tool 的 readOnlyHint 與 destructiveHint 是給 client 顯示風險的提示，不是權限邊界。部分操作是否先跳確認，還取決於 client 有沒有支援 MCP elicitation；沒有支援時，MCP Server 可能直接執行工具。
App Connections 與 MCP Configurations 的差別
App Connections 適合人在 client 裡發出提示詞的互動工作，例如請 Claude Code 查看 schema、讓 Codex 分析 index，或從 ChatGPT 查詢資料。操作會歸屬到核准連線的 Atlas 使用者，權限也跟著該使用者的 role 變動。
MCP Configurations 適合 production pipeline、排程或自行開發的自動化 Agent。管理員會為每組 configuration 指定 Atlas roles、選用 IP access list 與 read-only 設定，Agent 以專用 MCP configuration 身分操作，不依賴某位使用者持續登入。Atlas 會在背後建立一對 Service Accounts：一個讓 Agent 連到 MCP Server，另一個用於 audit event 歸屬。兩種存取模式使用同一套 MongoDB MCP Server tools，但身分、設定範圍與稽核歸屬不同。
| 項目 | App Connections | MCP Configurations |
|---|---|---|
| 主要用途 | 互動式 AI coding／查詢 | 無人值守與 production Agent |
| 身分 | 授權的 Atlas 使用者 | 專用 MCP configuration |
| 權限 | 使用者 role 加組織 access mode | configuration 指定的 Atlas roles |
| 管理範圍 | 整個 organization 共用 read-only 或 read-write | 每組 configuration 獨立設定 |
| IP access list | delegated access 不套用 Atlas Administration API IP allowlist | 可為 configuration 設定 |
Token 期限、撤銷與稽核
User-delegated access 預設在 7 天沒有活動後到期；即使持續使用，從第一次核准起最多 30 天也要重新驗證。Organization Owner 可以縮短組織的 maximum token lifetime，不能把期限延長到官方上限之外。
使用者能在 Atlas UI 撤銷自己的 client connection。Refresh token 會失效；依現行 Atlas 文件，當下的 access token 最多還能存活 10 分鐘，但 MongoDB 8 月 26 日公告仍寫 15 分鐘，實務上應以最新文件與實際組織設定為準。Organization Owner 若把整個 organization 的 AI client access 設為 Disabled，Atlas 會在每次 Administration API call 檢查開關，因此 control-plane access 會立即終止。
Atlas 會把產生 audit event 的操作記到授權使用者與 AI client 名下，方便分辨一般操作和委派操作。不過，read-only Atlas Administration API calls 原本就不會寫入 audit log，不能把「有使用者歸屬」理解成每一次 tool call 都有完整紀錄。
目前的管理限制
App Connections 的控制面目前以 organization 為單位，不能只允許特定 AI client，也不能針對單一使用者、project 或 cluster 設定不同 access mode。組織一旦啟用 delegated AI access，現在與未來支援這個模式的 clients 都一起納入。
Organization Owner 也不能從管理端撤銷某位使用者授權的單一 connection；可以由使用者自行撤銷，或由 Owner 關閉整個 organization。對需要精準分隔 project、client 與 Agent 身分的團隊，MCP Configurations 會比 App Connections 合適。
撤銷 token 不會刪除 AI client 在有效期間建立的 service account、API key 或 database user。關閉連線後仍要稽核這些 security artifacts，視需要刪除、停用或 rotate。Atlas Administration API 的 IP access list 也不套用到 delegated-access traffic，不能拿它當成 App Connections 的來源 IP 防線。
適合採用 App Connections 的情境
個人開發者或小型團隊若已在 Atlas 使用清楚的 least-privilege roles，希望從支援的 AI client 互動查詢資料、檢查 schema 或管理開發環境，App Connections 能省下手動建立與散發長期憑證的流程。第一次啟用時先選 Read，再為確定需要的寫入工作評估 read and write。
組織若需要只開放特定 client、只允許單一 project，或讓 Agent 長時間無人值守執行，App Connections 現有的 organization-wide 模型會太寬。這些情境應使用 MCP Configurations，為不同工作建立獨立身分與最小 roles，而不是借用管理員帳號授權。
常見問答
App Connections 可以連自架 MongoDB 嗎？
不行。User-delegated App Connections 與 programmatic MCP Configurations 都是給 Atlas-hosted clusters 使用。MongoDB Community Edition 或 Enterprise Advanced 等自架 deployment，需要自行執行 MongoDB MCP Server。
AI client 會看到 Atlas 密碼或 connection string 嗎？
不會。使用者在瀏覽器直接向 Atlas 驗證，client 不會收到 Atlas 密碼或長期憑證。資料平面連線使用帶有個別身分的短期 credentials，連線細節不會暴露給 AI client。
Read mode 能完全避免資料被修改嗎？
Read mode 會讓寫入工具從 session 中消失，也會阻止需要寫入權限的操作。MongoDB 特別提醒，aggregate 雖標為 read tool，pipeline 仍可能含 $out 或 $merge；在 read-only role 或 access mode 下，這類寫入會因權限不足而失敗。不要只依賴 tool annotation 或確認視窗判斷風險。