Ứng dụng và MCP gateway

Ứng dụng là một MCPMCPMCPModel Context Protocol, chuẩn để agent làm việc với ứng dụng bên ngoài. Portal kết nối mọi ứng dụng qua một cổng MCP trong tài khoản AWS của bạn.Mở trong Thuật ngữ server mà tổ chức của bạn cho phép. Agent dùng tool của nó thông qua LiteLLMLiteLLM (cổng mô hình)LiteLLM (model gateway)Cổng mà mọi lệnh gọi mô hình đi qua. Nó định tuyến tới Bedrock, áp khoá và ngân sách của từng phòng ban, và ghi chi phí từng lệnh gọi.Mở trong Thuật ngữ, vốn vừa là mô hình gateway vừa là MCP gateway. Với người dùng, một ứng dụng hiện ra dưới dạng ứng dụng đã kết nốiỨng dụng kết nối (Connected app)Connected appỨng dụng bên ngoài, như hệ thống ticket hoặc CRM, mà agent dùng thay bạn sau khi bạn đăng nhập trong Settings › Connected apps.Mở trong Thuật ngữ.

Quy tắc chính

1. LiteLLM là MCP gateway, nằm trong chính tài khoản AWS của bạn, phía sau một adapter do portal sở hữu.
2. Bí mật không bao giờ đến tay agent. Thông tin xác thực, phiên của nhà cung cấp và chính sách gateway nằm ngoài cấu hình agent và dữ liệu hội thoại.
3. Phạm vi hiển thị quyết định ai với tới ứng dụng — được xác định trước khi dựng danh sách tool của lượt.
4. Run without asking chỉ bỏ bước xác nhận. Quyền, OAuth scope, chính sách, tính idempotent và nhật ký kiểm tra luôn áp dụng.
5. SharePoint không phải ứng dụng kết nối trực tiếp. Nó chỉ đến với agent qua việc đồng bộ vào kho tri thức.

Gateway

Portal không tự vận hành MCP gateway riêng. LiteLLM — vốn đã là mô hình gateway — cũng phục vụ MCP, được triển khai trong tài khoản AWS của khách hàng và không có địa chỉ công khai. Portal làm việc với nó qua adapter của mình, nên thông tin xác thực, phiên của nhà cung cấp và chính sách gateway không bao giờ xuất hiện trong cấu hình agent hay trong cuộc hội thoại.

Xem Triển khai để biết gateway chạy ở đâu.

Ứng dụng khai báo những gì

Một ứng dụng nêu địa chỉ của server, phương thức truyền tải và cách xác thực:

Kiểu	Thông tin xác thực
NONE	Không có.
API_KEY	Một key của tổ chức.
OAUTH2_CODE	Sự đồng ý OAuth của chính từng người, lưu thành một kết nối.
OAUTH2_TOKEN_EXCHANGE	Token của chính người gọi, được đổi tại Keycloak lấy một token có phạm vi hẹp.

Chỉ OAUTH2_CODE tạo kết nối theo từng người; ba kiểu còn lại không cần. Quản trị viên đăng ký và bật ứng dụng ở Admin console (bảng điều khiển quản trị) → Applications — xem Ứng dụng.

Sổ đăng ký và alias

Portal sở hữu sổ đăng ký ứng dụng và đồng bộ nó sang LiteLLM giống như cách đồng bộ một mô hình. Mỗi server có một alias duy nhất trong toàn bản triển khai, và mỗi tool của nó được đặt tên alias/tool_name trên gateway.

Một người với tới những server nào là do phạm vi hiển thị của ứng dụng, được xác định trước khi dựng danh sách tool của lượt. Gateway key cấp cho người đó nêu đúng những server ấy, nên gateway và portal thống nhất về những gì với tới được. Quy tắc giữ lại từng tool trong một lượt có ở Xác định quyền truy cập.

Đăng nhập cho từng người

Ứng dụng OAUTH2_CODE đưa mỗi người qua bước đồng ý OAuth ở lần đầu. Gateway không có địa chỉ công khai, nên portal chuyển tiếp hai chặng:

• Portal mang cookie riêng của gateway theo cả hai chiều và không đọc nội dung nào của nó.
• Gateway được báo dùng đúng đường dẫn /api/mcp đó khi hỏi nhà cung cấp nơi gửi kết quả về. Đó là thiết lập gateway duy nhất mà một bản triển khai cung cấp.
• Không phần nào của gateway được công khai. Ba kiểu xác thực còn lại không đưa trình duyệt đi đâu cả.

Bạn xem, kết nối, ngắt kết nối ứng dụng của mình — và tự tắt từng tool cho riêng mình — ở Settings → Connected apps (ứng dụng đã kết nối). Xem Ứng dụng đã kết nối.

Chế độ phê duyệt

Mọi lời gọi tool qua một ứng dụng chạy theo một trong hai chế độ:

Chế độ	Hành vi
Run without asking (chạy không cần hỏi, YOLO)	Tool chạy mà không cần xác nhận từng thao tác.
Ask before each action (hỏi trước mỗi thao tác, ASK_EACH_OPERATION)	Một yêu cầu phê duyệt được lưu, lần chạy tạm dừng, và tool chạy sau khi người dùng duyệt. Từ chối thì quay về vòng lặp dưới dạng kết quả tool không thực thi.

Chế độ mặc định do tổ chức của bạn đặt, và quản trị viên có thể buộc một tool riêng lẻ luôn phải hỏi. Cách chọn chế độ cho một lời gọi — theo tool, agent, tổ chức — có ở Thực thi agent.

SharePoint: tri thức, không phải ứng dụng trực tiếp

SharePoint không xuất hiện như một ứng dụng đã kết nối, và không agent nào đọc SharePoint trực tiếp. Nó đến với portal như một tool do tổ chức vận hành, dưới một ứng dụng Entra được cấp quyền từng site qua Sites.Selected:

• một lần đồng bộ theo lịch kéo một thư mục vào kho tri thức;
• truy xuất có trích dẫn trả lời từ bản chụp mà lần đồng bộ giữ lại;
• thứ một người với tới được là kho tri thức đó, được xác định theo chính người đó trước khi tìm kiếm chạy.

Xem Đồng bộ SharePoint để biết cách đồng bộ hoạt động.

Vì sao lại như vậy

Liên quan