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 Dashboard.
Chọn assistant.
Vào MCP Server.
Nhấn New MCP.
Điền server details.
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	Connection type, thường là `sse` hoặc `streamable-http`
Authorization Type	Auth type nếu server yêu cầu
Icon URL	Icon hiển thị trong Admin UI, nếu có

Nếu MCP server cần auth đặc biệt, hãy chuẩn bị endpoint hoặc proxy phù hợp trước khi connect.

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.
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`

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
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