Tích hợp với AI
Kết nối Tables với AI Agent, Workflow và Knowledge Base — biến dữ liệu thành hành động thông minh.
Mục lục
· [Tổng quan tích hợp](#tổng-quan-tích-hợp)
· [Tables + Workflow](#tables--workflow)
· [Tables + AI Agent](#tables--ai-agent)
· [Tables + Webhooks](#tables--webhooks)
· [REST API](#rest-api)
· [MCP Server — Kết nối AI qua giao thức MCP](#mcp-server--kết-nối-ai-qua-giao-thức-mcp)
· [Use-cases tích hợp AI](#use-cases-tích-hợp-ai)
· [Best Practices](#best-practices)
Tổng quan tích hợp
ClickAI Tables không chỉ là nơi lưu trữ dữ liệu — nó là trung tâm kết nối toàn bộ hệ sinh thái AI của ClickAI. Bạn có thể:
graph LR A[📊 Tables] --> B[🤖 AI Agent] A --> C[⚙️ Workflow] A --> D[🔔 Webhooks] A --> E[📡 REST API] A --> F[🔌 MCP Server] C --> A B --> A F --> B
· Đọc dữ liệu từ Tables trong Workflow/Agent
· Ghi dữ liệu vào Tables từ kết quả AI xử lý
· Trigger tự động khi dữ liệu thay đổi qua Webhooks
· Truy cập programmatic qua REST API
· Kết nối LLM trực tiếp qua MCP Server (Model Context Protocol)
Tables + Workflow
Đọc dữ liệu từ Tables trong Workflow
Sử dụng node HTTP Request trong Workflow để truy vấn dữ liệu từ Tables API:
1. Thêm node HTTP Request vào Workflow
2. Cấu hình:
· Method: GET
· URL: https://tables.clickai.vn/api/v2/tables/{table_id}/records
· Headers: xc-auth: {API_TOKEN}
3. Xử lý response data trong các node tiếp theo
Ghi dữ liệu vào Tables từ Workflow
4. Thêm node HTTP Request vào Workflow
5. Cấu hình:
· Method: POST
· URL: https://tables.clickai.vn/api/v2/tables/{table_id}/records
· Headers: xc-auth: {API_TOKEN}
· Body: JSON chứa dữ liệu record mới
{ "Title": "{{workflow.output.title}}", "Status": "Processed", "AI_Summary": "{{workflow.output.summary}}", "Score": {{workflow.output.score}} }
Ví dụ Workflow: Xử lý Lead tự động
graph TD A[🔔 Webhook: New Lead] --> B[📊 Đọc Lead từ Tables] B --> C[🧠 LLM: Phân tích Lead] C --> D{Score > 80?} D -->|Có| E[📊 Update Status = Hot] D -->|Không| F[📊 Update Status = Cold] E --> G[📧 Gửi email thông báo Sales] F --> H[📧 Gửi email nurturing]
Tables + AI Agent
Kết nối Tables như Tool cho Agent
AI Agent có thể sử dụng Tables API như một tool để tra cứu và cập nhật dữ liệu:
6. Trong Agent configuration, thêm Custom Tool
7. Cấu hình API endpoint của Tables
8. Agent sẽ tự động gọi API khi cần tra cứu thông tin
Ví dụ: Agent CSKH có thể:
· Tra cứu thông tin khách hàng từ table "Customers"
· Kiểm tra trạng thái đơn hàng từ table "Orders"
· Tạo ticket mới trong table "Support Tickets"
· Cập nhật trạng thái xử lý
Kết nối Tables qua App Integration
Sử dụng module App Integration (Composio) để kết nối Tables:
9. Vào Workspace → App Integration
10. Tìm và kết nối NocoDB/ClickAI Tables
11. Cấu hình authentication
12. Sử dụng các actions có sẵn trong Agent/Workflow
Tables + Webhooks
Webhooks cho phép gửi thông báo tự động khi dữ liệu trong Tables thay đổi:
Cấu hình Webhook
13. Mở table → Table Details → Tab Webhooks
14. Nhấn Create Webhook
15. Cấu hình:
Cấu hình
Mô tả
Event
After Insert / After Update / After Delete
URL
Endpoint nhận webhook (VD: ClickAI Workflow trigger)
Method
POST
Headers
Custom headers nếu cần
Condition
Chỉ trigger khi thỏa điều kiện cụ thể
Webhook Payload
{ "type": "records.after.insert", "data": { "table_id": "tbl_xxxxx", "rows": [ { "Id": 1, "Title": "New Customer Lead", "Email": "[email protected]", "Status": "New" } ] }, "timestamp": "2024-01-15T10:30:00Z" }
Kết nối Webhook → ClickAI Workflow
16. Tạo Workflow mới trong ClickAI Studio
17. Sử dụng Start Node với trigger type Webhook
18. Copy Webhook URL từ Workflow
19. Dán URL vào cấu hình Webhook của table
20. Mỗi khi dữ liệu thay đổi → Webhook trigger → Workflow chạy tự động
REST API
ClickAI Tables cung cấp REST API đầy đủ cho mọi thao tác dữ liệu:
Authentication
# Sử dụng API Token curl -H "xc-auth: YOUR_API_TOKEN" \ https://tables.clickai.vn/api/v2/tables/{table_id}/records
Các API Endpoints chính
Method
Endpoint
Mô tả
GET
/api/v2/tables/{id}/records
Liệt kê records
GET
/api/v2/tables/{id}/records/{row_id}
Lấy record cụ thể
POST
/api/v2/tables/{id}/records
Tạo record(s) mới
PATCH
/api/v2/tables/{id}/records
Cập nhật record(s)
DELETE
/api/v2/tables/{id}/records
Xóa record(s)
Query Parameters
Parameter
Mô tả
Ví dụ
where
Filter records
(Status,eq,Active)
sort
Sort records
-CreatedAt (desc)
fields
Chọn fields trả về
Title,Email,Status
limit
Giới hạn số records
25
offset
Phân trang
50
Ví dụ: Lấy danh sách khách hàng Active
curl -X GET \ "https://tables.clickai.vn/api/v2/tables/tbl_xxx/records?where=(Status,eq,Active)&sort=-CreatedAt&limit=10" \ -H "xc-auth: YOUR_API_TOKEN"
Ví dụ: Tạo record mới
curl -X POST \ "https://tables.clickai.vn/api/v2/tables/tbl_xxx/records" \ -H "xc-auth: YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "Title": "Nguyễn Văn A", "Email": "[email protected]", "Phone": "0901234567", "Status": "New" }'
💡 TIP: Bạn có thể tìm API Token trong **Table Details** → tab **API Snippet** hoặc trong **Workspace Settings** → **API Tokens**.
MCP Server — Kết nối AI qua giao thức MCP
MCP (Model Context Protocol) là giao thức chuẩn cho phép các ứng dụng AI (LLM) tương tác trực tiếp với dữ liệu trong Tables bằng ngôn ngữ tự nhiên — không cần viết code API.
Với MCP, bạn có thể yêu cầu AI trực tiếp:
· *"Hiển thị tất cả khách hàng ở Hà Nội"*
· *"Thêm task mới: Review tài liệu, priority High"*
· *"Cập nhật đơn hàng #123 sang trạng thái Đã giao"*
· *"Xóa tất cả leads có status = Lost"*
MCP hoạt động như thế nào?
graph LR A[👤 Người dùng] -->|Ngôn ngữ tự nhiên| B[🤖 AI Client] B -->|MCP Protocol| C[🔌 MCP Server] C -->|REST API| D[📊 ClickAI Tables] D -->|Dữ liệu| C C -->|Kết quả| B B -->|Phản hồi| A
Thành phần
Vai trò
AI Client
Ứng dụng AI (Claude Desktop, Cursor, Windsurf...)
MCP Server
Cầu nối giữa AI và Tables — dịch lệnh AI thành API calls
ClickAI Tables
Database nhận và xử lý yêu cầu dữ liệu
Các khả năng của MCP Server
Nhóm chức năng
Khả năng
Record CRUD
Tạo, đọc, cập nhật, xóa records bằng ngôn ngữ tự nhiên
Table Management
Liệt kê, tạo mới, xóa tables
Field Management
Thêm, xóa, quản lý fields/columns
View Management
Liệt kê, tạo, xóa views (Grid, Gallery, Kanban...)
Data Operations
Lọc, sắp xếp, tìm kiếm, tổng hợp dữ liệu
Cấu hình MCP trên ClickAI Tables
Cách 1: Tạo MCP Endpoint từ giao diện (Recommended)
21. Mở base trong ClickAI Tables
22. Nhấn nút Overview trên sidebar trái
23. Chọn tab Settings
24. Chọn Model Context Protocol từ menu settings
25. Nhấn New MCP Endpoint
26. Đặt tên cho endpoint và nhấn Create
27. Copy MCP Config JSON được tạo tự động
Cách 2: Cấu hình thủ công (Self-hosted)
Nếu bạn sử dụng ClickAI Tables self-hosted, cấu hình thủ công với API Token:
Bước 1: Lấy thông tin cấu hình
Thông tin
Cách lấy
NOCODB_BASE_URL
URL instance Tables (VD: https://tables.clickai.vn)
NOCODB_API_TOKEN
Account Settings → API Tokens → Create Token
NOCODB_BASE_ID
Trong URL khi mở base: .../#/nc/base/BASE_ID_HERE/...
Bước 2: Tạo MCP Config JSON
{ "mcpServers": { "clickai-tables": { "command": "npx", "args": ["-y", "nocodb-mcp-server"], "env": { "NOCODB_BASE_URL": "https://tables.clickai.vn", "NOCODB_API_TOKEN": "your_api_token_here", "NOCODB_BASE_ID": "your_base_id_here" } } } }
Kết nối với Claude Desktop
28. Mở Claude Desktop → Preferences (⌘+, trên Mac / Ctrl+, trên Windows)
29. Vào Develop → Edit Config
30. Dán MCP Config JSON vào file claude_desktop_config.json
31. Lưu file và khởi động lại Claude Desktop
32. Kiểm tra: mở Claude, bạn sẽ thấy icon 🔌 MCP Tools trong input area
// ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) // %APPDATA%\Claude\claude_desktop_config.json (Windows) { "mcpServers": { "clickai-tables": { "command": "npx", "args": ["-y", "nocodb-mcp-server"], "env": { "NOCODB_BASE_URL": "https://tables.clickai.vn", "NOCODB_API_TOKEN": "xc-auth-xxxxxxxxxxxxx", "NOCODB_BASE_ID": "p_xxxxxxxxxxxxxxxx" } } } }
Kết nối với Cursor
33. Mở Cursor → Settings (⇧+⌘+J / Ctrl+Shift+J)
34. Chuyển đến tab MCP
35. Nhấn Add Custom MCP
36. Dán MCP Config JSON và lưu
37. Khi kết nối thành công, bạn sẽ thấy danh sách NocoDB tools
Ví dụ sử dụng MCP với Claude
Sau khi kết nối, bạn có thể giao tiếp bằng ngôn ngữ tự nhiên:
👤 "Cho tôi xem 10 khách hàng mới nhất trong bảng Customers" 🤖 Claude tự động gọi MCP → list_records(table: Customers, sort: -CreatedAt, limit: 10) → Trả về bảng 10 khách hàng mới nhất 👤 "Thêm khách hàng mới: Nguyễn Văn A, email: [email protected], phone: 090xxx" 🤖 Claude tự động gọi MCP → create_record(table: Customers, data: {...}) → ✅ Đã tạo record thành công 👤 "Tạo bảng mới tên 'Feedback' với 3 cột: Customer Name, Rating, Comment" 🤖 Claude tự động gọi MCP → create_table(...) + create_fields(...) → ✅ Đã tạo bảng Feedback với 3 fields
Quản lý quyền MCP
Chế độ
Mô tả
Phù hợp cho
Always Ask Permission
AI hỏi xác nhận trước mỗi thao tác
Dữ liệu production, quan trọng
Allow Unsupervised
AI tự thực hiện không cần xác nhận
Dữ liệu test, dev environment
🚨 WARNING: **Bảo mật khi sử dụng MCP:** - Sử dụng API Token với quyền hạn tối thiểu (read-only nếu chỉ cần query) - Không sử dụng Admin token cho MCP integration - Bật chế độ "Always Ask Permission" cho dữ liệu production - Kiểm tra kỹ MCP Config JSON trước khi chia sẻ — đảm bảo không lộ token
💡 TIP: MCP đặc biệt hữu ích cho các developer muốn nhanh chóng prototype, query dữ liệu, hoặc thao tác database mà không cần mở giao diện Tables. Kết hợp MCP với Claude Desktop giúp biến Tables thành trợ lý dữ liệu cá nhân.
Use-cases tích hợp AI
1. CRM thông minh với AI Agent
Khách hàng chat → AI Agent tra cứu CRM trong Tables → Trả lời dựa trên lịch sử mua hàng → Ghi nhận tương tác vào Tables
2. Phân nhóm khách hàng tự động
Webhook: New Order → Workflow → LLM phân tích hành vi → Cập nhật Segment field trong Tables → Trigger chăm sóc tự động
3. Content Calendar AI-powered
Form View thu thập ý tưởng → Workflow → LLM viết draft → Lưu draft vào table → Kanban View quản lý tiến độ
4. Helpdesk tự động
Form View nhận ticket → Webhook → AI phân loại → Cập nhật Priority & Category → Assign cho nhân viên phù hợp
5. Báo cáo thông minh
Scheduled Workflow → Query Tables API → LLM phân tích dữ liệu → Tạo báo cáo → Gửi email cho management
Best Practices
💡 TIP: **Thiết kế Table hiệu quả:** - Mỗi table nên tập trung vào một đối tượng (Customers, Orders, Products) - Sử dụng Links để tạo quan hệ thay vì duplicate dữ liệu - Đặt tên fields rõ ràng, dễ hiểu - Sử dụng Single Select cho các trạng thái để tận dụng Kanban View
🚨 WARNING: **Lưu ý khi tích hợp API:** - Bảo mật API Token — không hardcode trong client-side code - Sử dụng rate limiting để tránh gọi API quá nhiều - Validate dữ liệu trước khi ghi vào Tables - Thiết lập error handling trong Workflow cho các trường hợp API fail
⚠️ IMPORTANT: **Tối ưu performance:** - Sử dụng `fields` parameter để chỉ lấy dữ liệu cần thiết - Phân trang (pagination) cho table có nhiều records - Sử dụng `where` filter ở API level thay vì lọc phía client - Cache kết quả API khi dữ liệu không thay đổi thường xuyên
Last updated