MCP Endpoint
Kết nối MCP server chạy trên máy tính hoặc mạng nội bộ của bạn bằng connector kết nối ngược.
MCP Endpoint cho phép assistant dùng tools chạy trên máy tính hoặc mạng nội bộ của bạn mà không cần URL công khai hay mở port. Một connector chạy cạnh MCP server của bạn sẽ chủ động mở kết nối WebSocket ra Assistant Core, và assistant gọi tools qua kết nối đó trong chat, voice và device sessions.
Connector có thể là mcp_pipe.py, xiaozhi-client hoặc bất kỳ client nào hỗ trợ MCP Endpoint của Xiaozhi. Thiết bị và tool đang dùng với Xiaozhi có thể chuyển sang Assistant Core mà không cần sửa.
MCP Server Hay MCP Endpoint?
Cả hai nằm trong trang MCP của Admin Panel.
| Tab Máy chủ từ xa (MCP Server) | Tab Connector cục bộ (MCP Endpoint) |
|---|---|
| Assistant Core gọi tới Server URL của bạn | Connector của bạn kết nối tới Assistant Core |
| MCP server phải có URL truy cập được từ internet | MCP server có thể nằm sau NAT, firewall hoặc chỉ chạy local (stdio) |
| Xác thực bằng OAuth, Bearer, API key… | Xác thực bằng Connector URL bí mật |
Nếu MCP server đã có URL công khai, hãy dùng MCP Server.
Kết Nối Connector
-
Mở Admin Panel và chọn assistant.
-
Vào MCP → tab Connector cục bộ.
-
Bật MCP Endpoint.
-
Nhấn Tạo Connector URL và sao chép URL ngay. URL chỉ hiển thị một lần.
-
Cấu hình connector với URL đó, ví dụ:
export MCP_ENDPOINT="wss://api.assistantcore.com/mcp_endpoint/mcp/?token=mcpe_..." python mcp_pipe.py server.py -
Quay lại Admin Panel và nhấn Làm mới để xem danh sách tools. Tắt những tool assistant không cần dùng.
Nếu UI báo MCP Endpoint chưa sẵn sàng, system admin cần cấu hình backend trước.
Bảo Mật Connector URL
Connector URL là credential. Ai có URL đều có thể đăng ký tools cho assistant và nhận các tool call cùng tham số của chúng.
- Không commit URL vào git hay dán vào nơi công khai.
- Nếu URL bị lộ hoặc bị mất, nhấn Tạo lại URL. URL cũ ngừng hoạt động ngay và các connector đang dùng nó bị ngắt kết nối.
- Nhấn Thu hồi URL để ngắt hẳn mọi connector.
Nếu connector cung cấp tool chạy lệnh shell hoặc truy cập file, assistant có thể thao tác trên máy đó theo yêu cầu của người dùng chat. Chỉ bật cho assistant mà bạn tin tưởng người dùng, chạy connector bằng tài khoản ít quyền, và tắt những tool không cần dùng.
Không Thấy Tool?
- Kiểm tra MCP Endpoint đã bật và đã có Connector URL.
- Kiểm tra connector đang chạy và dùng URL mới nhất. URL cũ sẽ bị từ chối sau khi tạo lại.
- Kiểm tra log của connector để xem MCP server có khởi động được không.
- Kiểm tra vai trò và quyền của tài khoản trong assistant.