Đ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
localhostvà đị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:
userAdmintrênadminvớ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
- MongoDB tự vận hành
- MongoDB Atlas
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
- MongoDB tự vận hành
- MongoDB Atlas
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
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
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ố
Authentication failed
Authentication failed
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.Server selection timed out, hoặc connection refused
Server selection timed out, hoặc connection refused
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.Agent báo thao tác ghi bị chặn bởi chế độ chỉ đọc
Agent báo thao tác ghi bị chặn bởi chế độ chỉ đọc
Đâ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ó
readhoặcreadAnyDatabasecũng không ghi được, kể cả khi chuỗi bị lộ. - Dùng TLS: dùng
mongodb+srv://trên Atlas, hoặctls=truevớ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.