Điều kiện tiên quyết
- Tài khoản Cloudflare với quyền truy cập API.
- Account ID của bạn (tìm thấy ở thanh bên phải của Cloudflare dashboard).
- Một API token với quyền cho các dịch vụ bạn đã chọn.
Bạn có thể kết hợp quyền cho nhiều dịch vụ vào một token. Giới hạn token chỉ cho các zone và quyền mà CloudThinker cần.
Thiết lập
Lấy Account ID của bạn
Đăng nhập vào Cloudflare Dashboard → chọn bất kỳ domain nào → sao chép Account ID từ thanh bên phải trong phần API.
Tạo API token
Vào My Profile → API Tokens → Create Token và chọn Create Custom Token. Thêm quyền cho các dịch vụ bạn muốn bật (xem Quyền cần thiết bên dưới). Sao chép token ngay — Cloudflare sẽ không hiển thị lại.
Hộp thoại kết nối Cloudflare với API token, Account ID và lựa chọn dịch vụ
Tạo API token
Điều hướng đến API Tokens
Vào Cloudflare Dashboard → My Profile (góc trên phải) → API Tokens.
Cấu hình quyền
Thêm quyền cho các dịch vụ bạn đã chọn:Cho DNS Analytics:
- Account → Account Settings → Read
- Zone → Zone → Read
- Zone → Analytics → Read
- Zone → DNS → Read
- Account → Account Analytics → Read
- Zone → Zone Analytics → Read
Chi tiết kết nối
| Trường | Mô tả | Ví dụ |
|---|---|---|
| CLOUDFLARE_API_TOKEN | API token được tạo trong hồ sơ Cloudflare của bạn | — |
| CLOUDFLARE_ACCOUNT_ID | Cloudflare account ID của bạn từ dashboard | — |
| ENABLED_SERVICES | Dịch vụ cần bật (Documentation, DNS Analytics, GraphQL Analytics) | — |
Quyền cần thiết
Documentation
Không cần quyền đặc biệt. Dịch vụ này cung cấp quyền truy cập vào tài liệu công khai của Cloudflare.DNS Analytics
| Quyền | Cấp truy cập |
|---|---|
| Zone | Read |
| Analytics | Read |
| DNS | Read |
| Account Settings | Read |
GraphQL Analytics
| Quyền | Cấp truy cập |
|---|---|
| Account Analytics | Read |
| Zone Analytics | Read |
Khả năng của agent
Sau khi kết nối, các agent có thể tương tác với các dịch vụ bạn đã bật.| Khả năng | Mô tả |
|---|---|
| Documentation | Tìm kiếm và tham khảo tài liệu chính thức của Cloudflare trong quá trình xử lý sự cố |
| DNS Analytics | Truy vấn mẫu lưu lượng DNS, xác định bất thường và phân tích khối lượng truy vấn |
| GraphQL Analytics | Chạy truy vấn analytics nâng cao cho báo cáo lưu lượng và bảo mật tùy chỉnh |
Xác minh kết nối
Ví dụ câu lệnh
Xử lý sự cố
Xác thực thất bại
Xác thực thất bại
Xác minh API token đúng và chưa bị thu hồi. Kiểm tra token có đủ quyền cho các dịch vụ đã chọn và Account ID khớp với tài khoản tạo token.
Thiếu dữ liệu analytics
Thiếu dữ liệu analytics
Xác minh token có quyền đọc Analytics. Dữ liệu analytics có thể mất tới 24 giờ để xuất hiện cho zone mới. Kiểm tra rằng các zone có lưu lượng đang tạo dữ liệu.
DNS Analytics không hoạt động
DNS Analytics không hoạt động
Đảm bảo đủ bốn quyền: Zone, Analytics, DNS và Account Settings. Xác minh token có quyền truy cập vào các zone cụ thể bạn đang truy vấn và DNS được proxy qua Cloudflare (biểu tượng đám mây cam được bật).
Truy vấn GraphQL thất bại
Truy vấn GraphQL thất bại
Xác minh quyền Account Analytics và Zone Analytics đã được cấp. Kiểm tra cú pháp truy vấn theo GraphQL schema của Cloudflare và đảm bảo bạn đang truy vấn trong phạm vi thời gian cho phép.
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 API token cho các zone cụ thể thay vì “All zones” khi có thể để giảm blast radius.
- Giới hạn IP — thêm hạn chế IP allowlist cho token nếu dải IP CloudThinker của bạn ổn định.
Liên quan
Kết nối MCP
Tìm hiểu về tích hợp dựa trên MCP
Kết nối AWS
Kết nối hạ tầng AWS của bạn