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

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