Máy chủ MCP
Đăng ký điểm cuối Model Context Protocol bên ngoài để nút Trợ lý AI gọi công cụ, và mở AgentFlow ra ngoài qua tích hợp MCP.
Máy chủ MCP là gì?
Model Context Protocol (MCP) là tiêu chuẩn mở cho phép một mô hình AI gọi các công cụ bên ngoài — tra cứu dữ liệu, chạy thao tác, hoặc tích hợp với dịch vụ khác. Trong AgentFlow, mỗi Máy chủ MCP bạn đăng ký sẽ cung cấp một tập hợp công cụ mà nút Trợ lý AI (Agent) có thể gọi khi thực thi quy trình.
Ví dụ: trong quy trình Đề xuất mua sắm, nút Trợ lý AI có thể gọi một máy chủ MCP để kiểm tra ngân sách tồn kho trước khi đưa ra khuyến nghị phê duyệt.
Đăng ký máy chủ MCP bên ngoài
Đi đến Quản trị → Máy chủ MCP rồi chọn Máy chủ mới.
| Trường | Bắt buộc | Mô tả |
|---|---|---|
| Tên hiển thị | Có | Tên thân thiện, hiển thị trong giao diện trình thiết kế |
| Slug | Có | Định danh kỹ thuật (chữ thường, số, gạch ngang, gạch dưới; bắt đầu bằng chữ cái) |
| URL | Có | Điểm cuối HTTPS của máy chủ, ví dụ https://mcp.example.com/v1 |
| Token Bearer | Không | Token xác thực gửi kèm mỗi yêu cầu; được lưu mã hóa và không hiển thị lại |
| Mô tả | Không | Ghi chú nội bộ về mục đích của máy chủ này |
Chỉ chấp nhận điểm cuối HTTPS trỏ đến máy chủ công khai. URL http:// hoặc địa chỉ nội bộ sẽ bị từ chối.
Kiểm tra kết nối
Sau khi nhập URL (và token nếu có), nhấn Dò để AgentFlow kết nối thử và liệt kê các công cụ tìm thấy, ví dụ: ✓ Đã phát hiện 5 công cụ. Nếu không kết nối được, hãy kiểm tra lại URL và token Bearer.
Bật/tắt máy chủ
Dùng công tắc Bật/tắt trên mỗi hàng để tạm dừng mà không xóa cấu hình. Khi tắt, các nút Trợ lý AI đang liên kết vẫn giữ cấu hình nhưng sẽ không gọi được công cụ cho đến khi bật lại.
Không thể xóa một máy chủ đang được liên kết bởi bản nháp quy trình. Hãy tắt máy chủ hoặc gỡ liên kết khỏi trình thiết kế trước.
Dùng máy chủ MCP trong nút Trợ lý AI
Trong trình thiết kế quy trình, chọn một nút Trợ lý AI (Agent) rồi mở phần cấu hình công cụ. Các máy chủ MCP đang hoạt động sẽ hiển thị để bạn chọn. Khi quy trình chạy, nút Trợ lý AI sẽ tự động khám phá lại danh sách công cụ từ các máy chủ đã chọn.
Mở AgentFlow như một máy chủ MCP
AgentFlow cũng có thể đóng vai trò máy chủ MCP — cho phép trợ lý chat bên ngoài (ví dụ Claude Desktop) khám phá và khởi chạy quy trình của bạn.
Đi đến Quản trị → Tích hợp MCP để xem:
- Điểm cuối MCP: URL mà client bên ngoài kết nối vào.
- Khám phá OAuth: URL metadata để client đăng ký tự động.
Các công cụ mà điểm cuối này cung cấp — đầu vào, kết quả và mã lỗi của từng công cụ — được mô tả ở Công cụ MCP.
Tạo khóa API (Chủ thể dịch vụ)
Trong mục Khóa API, chọn Khóa mới và điền:
| Trường | Mô tả |
|---|---|
| Tên | Ví dụ chatbot-prod — dễ nhận biết khi cần thu hồi |
| Hết hạn | 30 ngày / 90 ngày / 1 năm / Không hết hạn / Tùy chỉnh |
| Quyền | Mức trần quyền cho chủ thể đứng sau khóa; hệ thống dựng chúng thành một vai trò riêng |
Sao chép token ngay sau khi tạo — token chỉ hiển thị một lần và không thể lấy lại.
Dùng token này làm Bearer header khi client bên ngoài gọi điểm cuối MCP của AgentFlow.
Khóa dựng nên một chủ thể dịch vụ
Một lần tạo khóa dựng ra ba thứ, không phải một:
- Một chủ thể dịch vụ (service principal) lấy tên theo khóa — danh tính bền vững mà lượt chạy, hồ sơ và dòng nhật ký trỏ tới. Nó xuất hiện ở Quản trị → Chủ thể dịch vụ. Nếu tên đó đã có chủ thể khác dùng, hệ thống thêm hậu tố cho tới khi được (
Zapier (2)). - Một vai trò riêng tên
Automation: {tên khóa}, mang đúng tập quyền bạn vừa chọn và được gán cho chủ thể đó. Vai trò này hiện trong danh sách vai trò và không bao giờ dùng chung với vai trò của người dùng. - Bản thân khóa, gắn vào chủ thể đó.
Danh tính mới là thứ được ủy quyền; khóa chỉ chứng minh cuộc gọi đến từ đâu. Từ trang Chủ thể dịch vụ bạn cấp thêm khóa cho cùng một danh tính, xoay vòng khóa mà không gián đoạn, đổi vai trò và nhóm, hoặc vô hiệu hóa hẳn danh tính đó.
Tập quyền bạn chọn trên biểu mẫu chỉ là mức trần. Nếu client MCP sẽ đọc hoặc ghi hồ sơ trên một thực thể đang ở chế độ Hạn chế, chủ thể đứng sau khóa còn cần một lượt cấp quyền trên chính thực thể đó, với phạm vi phù hợp cho từng thao tác — xem Quyền truy cập Thực thể & Bản ghi. Thiếu lượt cấp quyền, khóa vẫn xác thực thành công nhưng không đọc được hồ sơ nào.
Thu hồi khóa không giống vô hiệu hóa danh tính
Nhấn Thu hồi trên một khóa để dừng khóa đó: các yêu cầu dùng nó ngừng được xác thực ngay lập tức, còn những lượt chạy đã khởi động vẫn giữ nguyên chủ thể của chúng.
Nhưng thu hồi chỉ chạm tới thông tin xác thực. Chủ thể dịch vụ vẫn còn nguyên vai trò, nhóm, lượt cấp quyền thực thể và lượt gán đơn vị — và mọi khóa khác của chủ thể đó vẫn xác thực bình thường.
Thu hồi một khóa chỉ cắt được đường vào của một tích hợp khi đó là khóa duy nhất của chủ thể. Muốn ngắt hẳn danh tính, hãy Vô hiệu hóa chủ thể ở Chủ thể dịch vụ — khi đó mọi thông tin xác thực của nó bị từ chối cùng lúc.