> For the complete documentation index, see [llms.txt](https://docs.clickai.vn/clickai-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.clickai.vn/clickai-docs/tinh-nang/bang-so-lieu/tich-hop-voi-ai.md). # Tích hợp với AI ## 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: · 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: · 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ìnhMô tả
EventAfter Insert / After Update / After Delete
URLEndpoint nhận webhook (VD: ClickAI Workflow trigger)
MethodPOST
HeadersCustom headers nếu cần
ConditionChỉ 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": "",\ "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" \\\ ### Các API Endpoints chính
MethodEndpointMô tả
GET/api/v2/tables/{id}/recordsLiệt kê records
GET/api/v2/tables/{id}/records/{row_id}Lấy record cụ thể
POST/api/v2/tables/{id}/recordsTạo record(s) mới
PATCH/api/v2/tables/{id}/recordsCập nhật record(s)
DELETE/api/v2/tables/{id}/recordsXóa record(s)
### Query Parameters
ParameterMô tảVí dụ
whereFilter records(Status,eq,Active)
sortSort records-CreatedAt (desc)
fieldsChọn fields trả vềTitle,Email,Status
limitGiới hạn số records25
offsetPhân trang50
### Ví dụ: Lấy danh sách khách hàng Active curl -X GET \\\ "" \\\ -H "xc-auth: YOUR\_API\_TOKEN" ### Ví dụ: Tạo record mới curl -X POST \\\ "" \\\ -H "xc-auth: YOUR\_API\_TOKEN" \\\ -H "Content-Type: application/json" \\\ -d '{\ "Title": "Nguyễn Văn A",\ "Email": "",\ "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ầnVai trò
AI ClientỨng dụng AI (Claude Desktop, Cursor, Windsurf...)
MCP ServerCầu nối giữa AI và Tables — dịch lệnh AI thành API calls
ClickAI TablesDatabase 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ăngKhả năng
Record CRUDTạo, đọc, cập nhật, xóa records bằng ngôn ngữ tự nhiên
Table ManagementLiệt kê, tạo mới, xóa tables
Field ManagementThêm, xóa, quản lý fields/columns
View ManagementLiệt kê, tạo, xóa views (Grid, Gallery, Kanban...)
Data OperationsLọ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 tinCách lấy
NOCODB_BASE_URLURL instance Tables (VD: https://tables.clickai.vn)
NOCODB_API_TOKENAccount Settings → API Tokens → Create Token
NOCODB_BASE_IDTrong 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": " "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": " "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: , 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 PermissionAI hỏi xác nhận trước mỗi thao tácDữ liệu production, quan trọng
Allow UnsupervisedAI tự thực hiện không cần xác nhậnDữ 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 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.clickai.vn/clickai-docs/tinh-nang/bang-so-lieu/tich-hop-voi-ai.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.