Chuyển đến nội dung chính
Kết nối một deployment MongoDB hoặc cluster MongoDB Atlas để các agent CloudThinker xem database, collection, index và query plan. Bạn đưa cho CloudThinker một connection string của database user dành riêng, và kết nối luôn chạy ở chế độ chỉ đọc: agent truy vấn và explain được, nhưng không insert, update, drop hay tạo index được.

Điều kiện tiên quyết

  • Một deployment MongoDB hoặc cluster Atlas mà CloudThinker truy cập được từ internet. Agent kết nối từ CloudThinker Cloud, nên localhost và địa chỉ nội bộ được phân giải ở phía CloudThinker, không phải trong mạng của bạn. Atlas private endpoint và VPC peering không được hỗ trợ. Xem Truy cập dịch vụ nội bộ.
  • Quyền tạo database user: userAdmin trên admin với MongoDB tự vận hành, hoặc Project Database Access Admin (hoặc cao hơn) trong Atlas.

Thiết lập

1

Tạo user chỉ đọc

Kết nối bằng mongosh với quyền admin, rồi tạo user trên database admin:
2

Mở quyền truy cập mạng

Cho phép các egress IP của CloudThinker truy cập deployment. Tài liệu này không công bố danh sách egress IP của CloudThinker: hãy hỏi đầu mối CloudThinker của bạn, hoặc liên hệ chúng tôi. Với MongoDB tự vận hành, cho phép kết nối vào cổng 27017 trên firewall hoặc security group, và đảm bảo bindIp trong mongod.conf không chỉ là 127.0.0.1. Trong Atlas, thêm mỗi IP một mục trong Security → Network Access → IP Access List.
3

Tạo connection string

Với replica set, liệt kê mọi thành viên và đặt tên set:
Với máy chủ đơn, dùng một host và bỏ replicaSet. Chỉ bỏ tls=true khi máy chủ không hỗ trợ TLS.
readPreference=secondaryPreferred đưa các lượt đọc của agent tới secondary, để chúng không đè lên primary production. Khi không có secondary nào, lượt đọc quay về primary. appName=CloudThinker gắn nhãn kết nối trong log MongoDB. Mã hóa URL các ký tự đặc biệt trong mật khẩu (@ thành %40).
4

Thêm kết nối trong CloudThinker

Mở More → Workspace settings → Connections, chọn MongoDB, và nhấn Connect trên bảng chi tiết. Trong hộp thoại, bạn có thể đổi Alias và Description nếu muốn. Dán chuỗi vào trường connection string, có nhãn MDB_MCP_CONNECTION_STRING, rồi nhấn Connect.Trạng thái thành công: kết nối hiện Connecting và Verifying, rồi Connected. Sau đó CloudThinker chạy Discovery một lần: một lượt xem chỉ đọc qua database và collection của bạn, kết quả hiện trong mục Discovery trên bảng chi tiết của kết nối.

Chi tiết kết nối

Các tùy chọn hữu ích trong chuỗi:

Quyền yêu cầu

Để giới hạn agent trong một database, cấp read trên database đó thay cho readAnyDatabase, như ở bước 1. Không bao giờ cấp readWrite, dbAdmin hay root: kết nối vốn đã chỉ đọc, nên role thừa chỉ thêm rủi ro mà không thêm khả năng.

Khả năng của agent

Agent không ghi được. Các công cụ insert, update, delete, drop và tạo index đều bị tắt cho kết nối này, nên yêu cầu như “drop the sessions collection” không chạy được. Agent vẫn có thể đề xuất index để bạn tự tạo. Suy ra schema và truy vấn trả về document thật, có thể chứa dữ liệu cá nhân. Guardrails quyết định những định danh nào agent chỉ thấy dưới dạng placeholder. Email và số điện thoại được bật mặc định.

Xác minh kết nối

Kết quả mong đợi là tên từng database kèm collection và dung lượng. Trên Atlas, các database hệ thống local và config bị bỏ qua vì Atlas chặn truy cập vào chúng.

Ví dụ prompt

Khắc phục sự cố

User, mật khẩu hoặc auth database bị sai. Nếu bạn tạo user trên admin và chuỗi ghi một database khác, thêm authSource=admin. Trong Atlas, kiểm tra user có trong Database Access và các ký tự đặc biệt trong mật khẩu đã được mã hóa URL.
CloudThinker không truy cập được deployment. Trong Atlas, kiểm tra IP Access List. Với MongoDB tự vận hành, kiểm tra firewall và đảm bảo bindIp không chỉ là 127.0.0.1. Deployment trong mạng nội bộ cần có một endpoint truy cập được trước.
User thiếu clusterMonitor. Thêm role này trên database admin, rồi hỏi lại agent. Truy vấn vào dữ liệu của bạn vẫn chạy được khi không có role này.
Đây là hành vi đúng. Kết nối MongoDB là chỉ đọc. Hãy tự thực hiện thay đổi, hoặc yêu cầu agent đưa câu lệnh chính xác để bạn chạy.

Bảo mật

  • Quyền tối thiểu — chỉ cấp các quyền mà agent cần cho trường hợp sử dụng của bạn; bắt đầu với quyền chỉ đọc và mở rộng sau.
  • Chỉ đọc theo mặc định — sử dụng thông tin xác thực chỉ đọc trừ khi bạn muốn agent thực hiện thay đổi qua kết nối này.
  • Xoay vòng thông tin xác thực — xoay vòng khóa và token theo lịch trình thông thường của bạn; CloudThinker sẽ lấy giá trị mới khi bạn cập nhật kết nối.
  • Thu hồi khi bàn giao — xóa thông tin xác thực tại nhà cung cấp khi bạn xóa một kết nối hoặc khi đồng nghiệp rời nhóm.
  • Chỉ đọc ở hai lớp: bản thân kết nối không ghi được, và user chỉ có read hoặc readAnyDatabase cũng không ghi được, kể cả khi chuỗi bị lộ.
  • Dùng TLS: dùng mongodb+srv:// trên Atlas, hoặc tls=true với MongoDB tự vận hành, để thông tin xác thực và kết quả truy vấn được mã hóa khi truyền.

Liên quan

Redis

Kết nối cache Redis với ACL user chỉ đọc.

Kết nối

Xem mọi dịch vụ bạn kết nối được và cách trạng thái kết nối hoạt động.