MCP Server
Kết nối assistant với MCP server qua URL và enable tools từ server đó.
MCP Server dùng khi bạn đã có một server hỗ trợ Model Context Protocol và muốn assistant gọi tools từ server đó. Đây là cách phù hợp để kết nối CRM, database, internal tools, automation service hoặc hệ thống riêng của công ty.
Khi Nào Dùng MCP Server?
Dùng MCP Server khi:
- Bạn có một MCP server chạy ổn định và có URL truy cập được từ Assistant Core.
- Bạn muốn một assistant dùng nhiều tools do server đó cung cấp.
- Bạn muốn connect hoặc disconnect server theo từng assistant.
Nếu bạn chỉ cần gọi một HTTP API đơn giản, Custom API Tools thường dễ cấu hình hơn.
Thêm MCP Server
- Mở Admin Panel.
- Chọn assistant.
- Vào MCP Server.
- Nhấn New MCP.
- Điền server details (URL, transport, authentication nếu cần).
- Nhấn Create MCP.
- Bật trạng thái Connected cho MCP đó.
Khi MCP được connected, Assistant Core sẽ discover tool list từ server khi chat hoặc voice session bắt đầu. User không cần gọi tên tool; assistant sẽ tự dùng khi phù hợp.
Fields
| Field | Ý nghĩa |
|---|---|
| Name | Tên MCP server để bạn dễ nhận biết |
| Description | Mô tả server cung cấp tools gì |
| Server URL | URL của MCP server |
| Transport | SSE hoặc HTTP (streamable-http) |
| Auth Type | Loại authentication nếu server yêu cầu |
| Credential | Token, API key, hoặc username:password (xem bảng bên dưới) |
| Header Name | Tên header tùy chỉnh (cho API Key hoặc Custom Header) |
| Icon URL | Icon hiển thị trong Admin UI, nếu có |
Transport
| Transport | Mô tả | Khi nào dùng |
|---|---|---|
| SSE | Server-Sent Events — MCP transport mặc định | Hầu hết MCP server hiện tại |
| HTTP | Streamable HTTP — MCP transport mới (2025+) | MCP server hỗ trợ streamable-http |
Authentication
Nhiều MCP server yêu cầu authentication để truy cập. Platform hỗ trợ 5 loại auth:
| Auth Type | Credential cần điền | Header được tạo |
|---|---|---|
| None | (không cần) | (không gửi header) |
| Bearer | Token (ví dụ: sk-abc123) | Authorization: Bearer sk-abc123 |
| API Key | API key value | X-API-Key: <value> (hoặc header tùy chỉnh) |
| Basic | username:password | Authorization: Basic <base64 encoded> |
| Custom Header | Giá trị header | <Header Name>: <value> |
Credential được mã hóa AES-256 trước khi lưu vào database. Admin UI không bao giờ hiển thị credential đã lưu — chỉ hiện trạng thái "Credential saved (encrypted)".
Ví Dụ Cấu Hình Auth
MCP server dùng Bearer token:
| Field | Value |
|---|---|
| Auth Type | Bearer |
| Credential | your-api-token-here |
MCP server dùng API Key với custom header:
| Field | Value |
|---|---|
| Auth Type | API Key |
| Credential | abc123-your-key |
| Header Name | X-Custom-API-Key |
Khi update MCP server, nếu bạn để trống credential thì credential cũ sẽ được giữ nguyên. Chỉ điền credential mới khi bạn muốn thay đổi.
Created Vs Connected
Sau khi create MCP, server được attach với assistant nhưng chưa nhất thiết được dùng trong conversation.
| State | Ý nghĩa |
|---|---|
| Created | MCP đã được lưu và attach với assistant |
| Connected | Assistant sẽ connect MCP này và dùng tools của nó |
| Disconnected | MCP vẫn còn trong list, nhưng assistant không dùng trong conversation |
MCP Tools Được Dùng Như Thế Nào?
Khi MCP đã connected:
- Assistant Core connect tới MCP server (qua SSE hoặc HTTP).
- Auth headers được inject tự động nếu đã cấu hình.
- Server trả về tool list.
- Tools được đưa vào chat hoặc voice session.
- Nếu user hỏi việc phù hợp, assistant call tool.
- Tool result được assistant summarize lại cho user.
Use Cases
| Nhu cầu | MCP tool có thể cung cấp |
|---|---|
| Customer lookup | find_customer, list_recent_orders |
| Database access | query_sales_report, lookup_invoice |
| Task management | create_ticket, update_task_status |
| Internal operations | restart_service, get_service_health |
| Travel services | search_flights, search_hotels, search_places |
Troubleshooting
| Issue | Check |
|---|---|
| Không thấy MCP tools | Kiểm tra MCP đã bật Connected chưa |
| Connection fails | Kiểm tra Server URL có truy cập được từ backend không |
| Authentication fails | Kiểm tra auth type và credential đã đúng chưa. Thử đổi credential mới |
| Tool call fails | Kiểm tra parameter schema của MCP server và server logs |
| Assistant không dùng tool | Viết description rõ hơn hoặc thêm guidance trong system prompt |