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 → tab Máy chủ từ xa.
- Nhấn Thêm máy chủ.
- Nhập tên và URL máy chủ. Chỉ thêm xác thực khi nhà cung cấp yêu cầu.
- Nhấn Thêm máy chủ trong hộp thoại. Assistant Core tải danh sách công cụ của máy chủ ngay.
- Với máy chủ OAuth, nhấn Đăng nhập ở dòng của máy chủ và hoàn tất đăng nhập trong cửa sổ bật lên.
- Bật Dùng cho trợ lý cho máy chủ đó.
Mỗi dòng cho biết máy chủ đã kết nối chưa và lý do nếu chưa (ví dụ Cần đăng nhập hoặc Không truy cập được). Nhấn vào số công cụ để xem máy chủ cung cấp những công cụ nào.
Khi MCP được connected, trợ lý có thể dùng các công cụ của máy chủ trong chat và voice. User không cần gọi tên tool; assistant sẽ tự dùng khi phù hợp.
Chọn và kiểm tra công cụ
Trong hộp thoại công cụ (nhấn vào số công cụ), mỗi công cụ có công tắc riêng. Tắt những công cụ bạn không muốn trợ lý gọi, ví dụ công cụ xoá hoặc sửa dữ liệu.
Assistant Core chỉ dùng một công cụ đúng như lúc danh sách công cụ được tải lần cuối. Nếu sau đó máy chủ đổi mô tả hoặc tham số của công cụ, hoặc thêm công cụ mới, công cụ đó sẽ tạm tắt và dòng của máy chủ hiện Máy chủ đã thay đổi công cụ. Mở hộp thoại công cụ để xem thay đổi, rồi nhấn Làm mới công cụ trong menu của dòng để chấp nhận. Các công cụ không đổi vẫn hoạt động bình thường.
Cơ chế này bảo vệ trợ lý khỏi máy chủ thay đổi công cụ sau khi bạn đã duyệt, ví dụ để chèn chỉ dẫn ẩn. Kết quả trả về từ MCP server cũng được đánh dấu là dữ liệu không tin cậy khi gửi cho mô hình AI.
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 | Chỉ hiện với máy chủ đã lưu bằng transport SSE (đã ngừng hỗ trợ), để bạn chuyển sang 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.
- Các công cụ đang bật và không đổi kể từ lần Làm mới công cụ gần nhất đượ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 và công cụ đang bật trong hộp thoại công cụ |
| Dòng máy chủ báo đã thay đổi công cụ | Xem hộp thoại công cụ, rồi nhấn Làm mới công cụ để chấp nhận phiên bản mới |
| 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 |