Skip to main content
Kết nối Cloudflare để CloudThinker liệt kê account và zone, tóm tắt lưu lượng HTTP và hành vi cache, xem xét sự kiện firewall và tra cứu tài liệu Cloudflare. CloudThinker dùng MCP server do Cloudflare host và xác thực bằng một API token, quyền của token quyết định CloudThinker truy cập được những gì.

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

  • Một tài khoản Cloudflare có ít nhất một zone.
  • Quyền tạo API token trong Cloudflare dashboard.

Thiết lập

1

Tạo custom API token

Trong Cloudflare dashboard, vào My Profile → API Tokens → Create Token. Dưới Create Custom Token, nhấn Get started. Thêm từng quyền trong bảng Quyền yêu cầu. Mỗi hàng trong form của Cloudflare có ba dropdown, nên Zone → Analytics → Read nghĩa là nhóm Zone, quyền Analytics, mức truy cập Read.
2

Giới hạn token cho account và zone bạn cần

Dưới Account Resources, chọn Include → your account. Dưới Zone Resources, chọn Include → Specific zone cho từng zone CloudThinker cần thấy. Chỉ dùng All zones nếu bạn muốn CloudThinker bao quát mọi zone.
3

Đặt thời hạn, rồi tạo và sao chép token

Dưới TTL, đặt ngày kết thúc, ví dụ 90 ngày kể từ hôm nay. Để trống Client IP Address Filtering: các lệnh gọi API đến Cloudflare đi qua MCP server do Cloudflare host, không phải từ địa chỉ bạn kiểm soát. Nhấn Continue to summary → Create Token. Sao chép token ngay. Cloudflare chỉ hiển thị token một lần.Để kiểm tra token trước khi dán:
Trạng thái thành công: phản hồi có "status": "active".
4

Thêm kết nối trong CloudThinker

Trong thanh bên, nhấn More → Workspace settings → Connections, chọn Cloudflare và nhấn Connect. Điền Alias (ví dụ main-account) và Description (ví dụ Main Cloudflare account, production zones). Agent đọc mô tả để chọn đúng kết nối khi bạn có nhiều kết nối. Dán token vào CLOUDFLARE_API_TOKEN và nhấn Connect.Trạng thái thành công: kết nối hiển thị Connecting và Verifying, rồi trạng thái Connected. Discovery sau đó chạy một lần ở chế độ nền và tiêu tốn credit. Xem Sau khi kết nối.
5

Đặt environment

Mở Cloudflare trong More → Workspace settings → Connections, nhấn biểu tượng bút chì trên hàng của kết nối và đặt Environment trong Edit Instance. Giá trị này gắn nhãn kết nối cho người dùng và agent.

Chi tiết kết nối

Luồng dữ liệu là CloudThinker Cloud → MCP server do Cloudflare host → Cloudflare API, nên token và phản hồi API đi qua dịch vụ của chính Cloudflare. Bạn không cần nhập account ID. CloudThinker tự tìm các account và zone mà token thấy được. Nếu token bao quát nhiều zone và yêu cầu của bạn khớp với hơn một zone, CloudThinker sẽ hỏi bạn muốn zone nào. Bạn có thể thêm nhiều kết nối Cloudflare, ví dụ mỗi account một token.

Quyền yêu cầu

Mỗi quyền được viết như trong form Cloudflare: nhóm → quyền → mức truy cập. CloudThinker chỉ truy cập được những gì token cho phép.
Giữ token ở chế độ chỉ đọc và giới hạn cho các zone cụ thể. Không có danh sách cố định các thao tác ghi: execute có thể gọi bất kỳ endpoint nào của Cloudflare API, nên mọi quyền chỉnh sửa bạn thêm vào token, như Zone → DNS → Edit, đều trở thành thay đổi mà agent có thể đề xuất. Mỗi lệnh gọi vẫn đi qua phê duyệt của bạn.

Khả năng của agent

Kết nối có ba công cụ. Hai công cụ chạy mà không cần phê duyệt. Công cụ thứ ba gọi Cloudflare API và luôn đi qua Approvals, kể cả với thao tác đọc, vì cùng công cụ đó cũng có thể thực hiện thay đổi. Mọi thay đổi do agent thực hiện đều đi qua Approvals của workspace trước. Ở chế độ mặc định Auto · Rules + AI · Ask me, AI judgment có thể cho một thay đổi an toàn chạy mà không cần hỏi. Allow Rule cũng vậy, sau khi CloudThinker bật Rule enforcement cho workspace của bạn. Chọn Manual nếu bạn muốn tự phê duyệt mọi thay đổi. Discovery không bao giờ chờ người duyệt, nên Discovery bỏ qua mọi lệnh gọi execute cần hỏi và tìm được rất ít trên Cloudflare. Automation gọi execute dùng Approval mode riêng, mặc định là Refuse, nên lệnh gọi cần hỏi sẽ bị từ chối. Giới hạn truy vấn tích hợp giữ kết quả gọn: bản tóm tắt lưu lượng bao quát tối đa 7 ngày dữ liệu theo giờ cho một zone, và bản xem xét firewall bao quát tối đa 24 giờ và 50 sự kiện mẫu. Output firewall không chứa địa chỉ IP của client.

Xác minh kết nối

Câu trả lời đến từ công cụ execute, nên phải qua phê duyệt của bạn trước. Nếu CloudThinker đăng yêu cầu phê duyệt trong chat, hãy phê duyệt. Câu trả lời liệt kê tên account và tên zone thực của bạn.

Ví dụ prompt

Khắc phục sự cố

CloudThinker báo CLOUDFLARE_PERMISSION_DENIED. Token thiếu quyền đọc cho thứ bạn hỏi. Sửa token trong My Profile → API Tokens, thêm quyền và hỏi lại.
CLOUDFLARE_NO_ZONES nghĩa là token không liệt kê được zone nào. CLOUDFLARE_ZONE_NOT_FOUND nghĩa là token không thấy zone bạn nêu tên. Kiểm tra Zone Resources trên token và dùng đúng tên zone.
Mọi lệnh gọi Cloudflare API đều đi qua phê duyệt của bạn, và một số chờ người duyệt. Kiểm tra chat xem có yêu cầu phê duyệt đang chờ không, hoặc xem lại Approval mode. Nếu bạn từ chối một yêu cầu, CloudThinker sẽ không thử lại.
Zone mới hoặc zone có ít lưu lượng có thể chưa có analytics. Xác nhận zone nhận lưu lượng qua Cloudflare và token có Zone → Analytics → Read.
Kết nối mới không bao giờ gặp lỗi này. Kết nối được tạo trước khi chuyển sang MCP server do Cloudflare host sẽ hiển thị Error với thông báo này, và CloudThinker tự kết nối lại. Nếu trạng thái không đổi, mở kết nối và nhấn Retry. Các giá trị Account ID và Enabled Services cũ không còn được dùng.

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.
  • Giới hạn zone: giới hạn token cho các zone cụ thể thay vì tất cả zone để thu hẹp phạm vi ảnh hưởng.
  • Xoay vòng trước khi TTL kết thúc: xoay vòng token trước ngày kết thúc TTL bạn đặt khi tạo token.

Liên quan

Approvals

Quyết định cách phê duyệt các lệnh gọi Cloudflare API.

Tổng quan kết nối

Cách kết nối, kiểm tra và discovery hoạt động.