Tính năng công cụ kết nối - MCP Server
Tài liệu này hướng dẫn người dùng kết nối công cụ bên ngoài vào DataVero thông qua MCP Server, gồm 3 bước: Thêm MCP Server → Kiểm tra kết nối → Test với AI Gateway trong Playground.
Tổng quan
MCP Server là nguồn cung cấp công cụ (tool) bên ngoài, cho phép model AI gọi và sử dụng các tool này khi xử lý yêu cầu. Người dùng kiểm soát tool nào được phép sử dụng.
Thông tin cần chuẩn bị (do nhà cung cấp MCP Server cung cấp):
- URL của MCP Server
- Transport Type: Streamable HTTP hoặc SSE
- Bearer Token, nếu server yêu cầu xác thực
Thêm MCP Server
- Tại menu bên trái, trong mục AI/ML chọn AI Gateway → MCP Servers, sau đó chọn +Create.
- Nhập thông tin kết nối theo bảng sau:
| Trường | Bắt buộc | Mô tả | Quy tắc |
|---|---|---|---|
| Name | Có | Tên định danh của MCP Server | Chỉ gồm chữ cái, chữ số và dấu gạch dưới (_).Ví dụ: ✅ crm_tools_01 · ❌ crm-tools 01 (có dấu gạch ngang và khoảng trắng) |
| Transport Type | Có | Giao thức kết nối tới MCP Server: Streamable HTTP hoặc SSE, theo thông tin nhà cung cấp | Chọn 1 trong 2 giá trị. Ví dụ: nhà cung cấp ghi "SSE endpoint" → chọn SSE |
| Description | Không | Mô tả về MCP Server, giúp người dùng khác hiểu mục đích sử dụng | Ví dụ: Tra cứu thông tin khách hàng từ hệ thống CRM |
| Max Concurrent Requests | Không | Số yêu cầu tối đa được gửi cùng lúc tới MCP Server, dùng để tránh quá tải server | Ví dụ: nhập 10 → tối đa 10 yêu cầu được xử lý cùng lúc |
| Extra Header | Không | Header bổ sung gửi kèm request tới MCP Server. | Định dạng key:value.Ví dụ: X-Tenant-ID:tenant_01 |
| Static Header | Không | Header cố định, luôn được gửi kèm mọi request tới MCP Server. Thường dùng cho thông tin không đổi như API key hoặc phiên bản API. | Phải nhập đủ cả key và value.Ví dụ: ✅ X-API-Version:v1 · |
| URL | Có | Địa chỉ endpoint của MCP Server | Ví dụ: https://mcp.example.com/mcp |
| Authentication | Có | Phương thức xác thực khi kết nối tới MCP Server: None (không xác thực) hoặc Bearer Token | Chọn 1 trong 2 giá trị. Bắt buộc nhập Authentication Value khi chọn Bearer Token. |
- Sau khi nhập xong, hệ thống hiển thị danh sách các tool được phép truy cập từ MCP Server đó. Thiết lập quyền sử dụng tool: chọn On để cho phép, Off để chặn.
- Chọn Create để hoàn tất tạo MCP Server.
Khuyến nghị: Chỉ bật các tool cần thiết để hạn chế rủi ro và dễ kiểm soát.
Kiểm tra kết nối MCP Server
Thực hiện bước này để xác nhận MCP Server kết nối thành công trước khi sử dụng với model AI cụ thể.
- Tại danh sách MCP Servers, mở MCP Server vừa tạo.
- Chọn tab MCP Tools.
- Chọn tool muốn test, nhập các thông tin bắt buộc và chọn Call Tool.
- Kiểm tra kết quả tại phần Tool result.
Test MCP Server với AI Gateway trong Playground
Thực hiện bước này để xác nhận model AI gọi được tool từ MCP Server đã cài đặt.
- Gắn MCP Server vào Virtual Key. Tại AI Gateway, tạo mới hoặc chỉnh sửa Virtual Key, chọn MCP Server tại trường MCP Servers.
- Mở Playground: Tại AI/ML chọn Playground, chọn chế độ AI Gateway.
- Nhập Virtual Key, chọn Endpoint Type và model cần test, rồi chọn MCP Server tại Select MCP server.
- Nhập prompt test có sử dụng tool. Ví dụ, với MCP Server cung cấp dữ liệu thời tiết: "Thời tiết Hà Nội hôm nay thế nào?"
- Kiểm tra kết quả. Model AI gọi tool và phản hồi dựa trên dữ liệu tool trả về.
Để tìm hiểu cách thức sử dụng tính năng Playground, bạn đọc có thể tham khảo thêm tại: AI Playground (Thử nghiệm mô hình trực quan).
Áp dụng MCP Server qua Virtual Key
Ngoài ra, MCP Server còn được gắn với Virtual Key cho các request sử dụng Key đó:
- Tại AI Gateway, tạo mới hoặc chỉnh sửa Virtual Key.
- Tại trường MCP Server, chọn MCP Server cần áp dụng.
- Lưu Virtual Key và sử dụng.
Để tìm hiểu cách thức sử dụng Virtual Key, bạn đọc tham khảo tại: Quản lý Virtual Key trong AI Gateway.