Ứng dụng
Tổ chức cho phép ứng dụng kết nối (máy chủ MCP) nào, mỗi ứng dụng xác thực ra sao, và mỗi lần gọi có hỏi trước không.
Ứng dụng là một máy chủ MCP mà agent gọi như một công cụ được kiểm soát, qua cùng gateway với mọi lần gọi mô hình. Ai dùng được là do quy tắc chia sẻ trên ứng dụng: mỗi lượt chỉ được dùng công cụ của những ứng dụng người đó thấy được. Người dùng thấy chúng dưới tên Connected apps (ứng dụng kết nối).
Thứ tổ chức tự chạy bằng thông tin xác thực riêng là một công cụ.
Hai ô đếm số ứng dụng và số ứng dụng đang tắt. Mỗi thẻ hiện địa chỉ máy chủ, Available hay đã tắt, và Scope, ví dụ toàn tổ chức kèm các quy tắc chặn.
| Nút | Làm gì |
|---|---|
| Add application | Chọn máy chủ portal đã biết, hoặc nhập địa chỉ, và đặt ai được dùng |
| Configure | Mở ứng dụng đã đăng ký: tên, máy chủ, ai được dùng, và tổ chức có cho phép không |
Đăng ký ứng dụng
Portal biết sẵn cách kết nối Notion, GitHub, GitLab, Linear, Atlassian, Asana, Sentry, Stripe và PayPal. Chọn một cái sẽ điền sẵn địa chỉ, transport và cách xác thực; địa chỉ vẫn sửa được.
Máy chủ không có trong danh sách, ví dụ máy chủ trong tài khoản AWS của bạn, được đăng ký bằng cách nhập địa chỉ. Địa chỉ nhập tay mặc định dùng streamable HTTP; ngăn kéo cho phép chuyển sang transport cũ với máy chủ chỉ hỗ trợ loại đó.
SharePoint không có trong danh sách: nó là công cụ tổ chức tự chạy, thiết lập ở Thiết lập SharePoint.
Ai được dùng ứng dụng được hỏi lúc tạo, và đổi trong ngăn kéo về sau.
Xác thực
| Loại | Ai giữ thông tin xác thực | Form hỏi |
|---|---|---|
| Không | Không ai. Máy chủ chỉ truy cập được trong VPC | Địa chỉ |
| Một khóa cho cả tổ chức | Tổ chức, dưới dạng tham chiếu secret | Địa chỉ và tham chiếu |
| Mỗi người tự đăng nhập | Mỗi người, qua sự đồng ý của chính họ | Địa chỉ, thêm client ID và secret khi nhà cung cấp không hỗ trợ đăng ký động |
| Đổi token của người gọi | Không ai. Gateway đổi token của người gọi lấy một token giới hạn cho máy chủ đó | Địa chỉ và audience |
Máy chủ có trong danh sách đã mang sẵn loại xác thực, màn hình chỉ nêu ra chứ không hỏi. Nhà cung cấp hỗ trợ đăng ký động thì không cần gì thêm. Những nhà cung cấp khác cần admin đăng ký một OAuth app và nhập client ID và secret. Các giá trị này định danh portal; mỗi người vẫn tự cấp quyền bằng tài khoản của mình.
GitHub
Máy chủ MCP của GitHub không hỗ trợ đăng ký client động, nên mục GitHub hỏi thông tin của một OAuth App.
-
Tạo GitHub OAuth App
-
Đặt callback
Authorization callback URL = địa chỉ portal của bạn, theo sau là/api/mcp/callback. -
Nhập thông tin
Nhập Client ID và Client secret của app khi thêm GitHub. Với ứng dụng đã có, mở Configure → OAuth App, nhập rồi lưu. Để trống secret thì giữ giá trị đã lưu. -
Kết nối
Bấm Connect và cấp quyền bằng tài khoản GitHub của bạn.
Dùng Client ID đúng như GitHub hiện; giá trị khác sẽ bị GitHub trả về 404.
Cho phép và kết nối
Đăng ký ứng dụng là cho phép nó trong tổ chức. Kết nối là sự đồng ý của từng người ở Settings › Connected apps, và chỉ loại “mỗi người tự đăng nhập” mới hỏi; với ba loại còn lại agent dùng được máy chủ mà không ai phải kết nối.
Tắt một ứng dụng là từ chối nó cho cả tổ chức, kể cả các kết nối đã có. Mỗi người có thể rút kết nối của mình bất cứ lúc nào.
Công cụ của ứng dụng
Công cụ của một ứng dụng là các dòng riêng, thuộc tổ chức chứ không thuộc kết nối của một người. Mỗi dòng ghi công cụ có ghi dữ liệu không, có bật không, và có dừng xin xác nhận trước mỗi lần gọi không. Agent gắn với công cụ, nên việc gắn vẫn còn khi người đăng ký ứng dụng ngắt kết nối.
- Công cụ có ghi dữ liệu sẽ hỏi trước (Ask before each action – hỏi trước mỗi thao tác) cho tới khi admin hạ xuống.
- Run without asking (YOLO) chỉ bỏ bước xác nhận. Quyền hạn, phạm vi OAuth, chính sách, tính idempotent và audit vẫn áp dụng.
- Công cụ được đọc từ chính máy chủ, qua gateway. Đồng bộ lại sẽ nhận những gì máy chủ đang cung cấp; công cụ máy chủ ngừng cung cấp sẽ bị tắt chứ không xoá, vì agent có thể vẫn gắn với nó.
- Máy chủ yêu cầu mỗi người đăng nhập sẽ trả lời theo người đang hỏi, nên admin chưa kết nối sẽ thấy danh sách trống; ngăn kéo đưa nút đăng nhập vào chỗ nút đồng bộ.
Mặc định cho cả tổ chức về việc ứng dụng kết nối có hỏi trước mỗi thao tác hay không nằm ở Organisation › Agent policies.