Các kết nối MCP cho trợ lý tùy chỉnh

Các kết nối MCP (Model Context Protocol) cho phép trợ lý tùy chỉnh của bạn kết nối an toàn với các ứng dụng bên ngoài. Với các kết nối MCP, trợ lý của bạn có thể đọc thông tin và thực hiện các Hành động bằng cách sử dụng các kết nối được cấu hình sẵn với các ứng dụng như Linear, Ramp, Figma, v.v.—hoặc kết nối với bất kỳ ứng dụng nào bằng cách thiết lập các kết nối MCP tùy chỉnh.

Lưu ý: Các kết nối MCP chỉ khả dụng trên các gói Business và Enterprise.

Các kết nối MCP cho phép các trợ lý tùy chỉnh tương tác với các công cụ và dịch vụ bên ngoài thông qua Model Context Protocol. Các công cụ MCP hoạt động với tất cả các loại kích hoạt, bao gồm các lượt chạy theo lịch trình, các lượt chạy được kích hoạt dựa trên sự kiện Notion hoặc Slack, và các lượt chạy thủ công từ trò chuyện hoặc @đề cập.

Các tính năng chính:

• Máy chủ được cấu hình sẵn: Kết nối nhanh chóng với các ứng dụng phổ biến mà không cần thêm bất kỳ cấu hình nào.

• Máy chủ tùy chỉnh: Kết nối với bất kỳ công cụ nào hỗ trợ máy chủ MCP được lưu trữ bằng cách sử dụng các URL có sẵn công khai.

• Tùy chỉnh: Các công cụ cho mỗi kết nối có thể được chuyển đổi bật hoặc tắt, và bạn có thể chọn yêu cầu xác nhận trước khi chạy, chạy tự động hoặc cho phép vĩnh viễn tất cả các công cụ từ một máy chủ.

Mỗi kết nối MCP là duy nhất cho một trợ lý tùy chỉnh và sử dụng thông tin đăng nhập của người đã xác thực nó. Các kết nối MCP không được đặt ở trạng thái 'đã chia sẻ' giữa các trợ lý, ngay cả khi chúng kết nối với cùng một dịch vụ.

Điều này có nghĩa là:

• Nếu bạn thiết lập kết nối Figma cho trợ lý A, trợ lý B sẽ cần kết nối Figma riêng của nó.

• Bạn phải đăng nhập vào từng máy chủ MCP cho mỗi trợ lý tùy chỉnh mà bạn cấu hình.

• Việc thu hồi kết nối trong một trợ lý tùy chỉnh không ảnh hưởng đến các trợ lý tùy chỉnh khác.

Bạn có thể kết nối với các ứng dụng sau mà không cần thêm bất kỳ cấu hình nào:

• Amplitude

• Attio

• Box

• ClickHouse

• Figma

• GitHub

• HubSpot

• Intercom

• Linear

• Mercury

• Miro

• Mixpanel

• n8n

• Ramp

• Stripe

• Sentry

• Wiz

1. Mở Cài đặt của trợ lý tùy chỉnh của bạn.

2. Đi tới Công cụ & Truy cập.

3. Nhấp vào Thêm kết nối → Thêm.

4. Chọn một máy chủ được định cấu hình sẵn.

5. Làm theo các lời nhắc xác thực để kết nối tài khoản của bạn.

6. Chọn các công cụ từ máy chủ mà bạn muốn trợ lý tùy chỉnh sử dụng. Các công cụ này sẽ khác nhau tùy thuộc vào máy chủ bạn chọn.

7. Nhấp vào Kết nối.

Để kết nối với máy chủ MCP không có trong danh sách được định cấu hình sẵn, quản trị viên không gian làm việc trước tiên phải bật tùy chọn này. Có hai cài đặt riêng biệt: một để cho phép các máy chủ MCP tùy chỉnh và một để quyết định xem thành viên có thể cài đặt bất kỳ kết nối nào hay chỉ những kết nối mà bạn phê duyệt.

Để cho phép các máy chủ MCP tùy chỉnh:

1. Với tư cách là quản trị viên không gian làm việc, hãy đi tới Cài đặt → Kết nối.

2. Trong tab Quản lý, hãy chuyển đổi sang bật Cho phép máy chủ MCP tùy chỉnh.

Để chọn xem thành viên có thể cài đặt bất kỳ kết nối nào hay chỉ các kết nối đã phê duyệt do quản trị viên thực hiện:

1. Với tư cách là quản trị viên không gian làm việc, hãy đi tới Cài đặt → Kết nối.

2. Trong tab Quản lý, hãy tìm phần Quản lý quyền.

3. Bên cạnh Giới hạn các kết nối mà thành viên có thể cài đặt, hãy chọn một tùy chọn:

   • Đã phê duyệt & đề xuất: Tự động phê duyệt tất cả các kết nối do Notion đề xuất.

   • Chỉ đã phê duyệt: Chọn thủ công từng kết nối mà thành viên có thể cài đặt.

4. Chọn Các kết nối đã phê duyệt để xem lại những gì thành viên có thể cài đặt.

5. Chọn Thêm kết nối đã phê duyệt, sau đó chọn những gì bạn muốn cho phép:

   • Kết nối: Tìm kiếm kết nối theo tên hoặc ID và thêm kết nối đó vào danh sách đã phê duyệt.

   • Máy chủ MCP tùy chỉnh: Thêm URL máy chủ MCP tùy chỉnh cụ thể mà bạn muốn cho phép.

6. Nhấp vào Lưu.

Sau khi thiết lập xong, bất kỳ ai trong không gian làm việc đều có thể kết nối với các tùy chọn đã phê duyệt khi họ thiết lập trợ lý tùy chỉnh. Họ sẽ xác thực bằng thông tin đăng nhập của riêng mình.

Để thêm MCP tùy chỉnh vào trợ lý tùy chỉnh:

1. Mở Cài đặt trợ lý tùy chỉnh của bạn.

2. Đi tới Công cụ & Truy cập.

3. Nhấp vào Thêm kết nối → Máy chủ MCP tùy chỉnh.

4. Bạn sẽ cần nhập URL của máy chủ MCP từ công cụ hoặc nhà cung cấp mà bạn đang kết nối (ví dụ: nhóm công cụ nội bộ của công ty bạn).

5. Cung cấp tên hiển thị cho kết nối (tùy chọn).

6. Thêm mọi chi tiết xác thực bắt buộc.

7. Nhấp vào Kết nối.

Các máy chủ MCP tùy chỉnh có thể hỗ trợ một hoặc cả hai phương thức đăng nhập sau:

• OAuth

• Xác thực dựa trên tiêu đề

  (ví dụ: khóa API hoặc mã thông báo bearer)

Một số máy chủ OAuth không hỗ trợ đăng ký máy khách động (DCR). Điều này có nghĩa là Notion phải đăng ký trước một ứng dụng máy khách với dịch vụ của bên thứ ba trước khi đăng nhập OAuth có thể hoạt động. Nếu máy chủ bạn muốn sử dụng không hỗ trợ DCR, hãy kiểm tra tài liệu của máy chủ đó để xem liệu bạn có thể sử dụng khóa API hoặc mã thông báo bearer thay thế hay không. Nếu không có tùy chọn nào khả dụng, máy chủ MCP không thể được sử dụng với các trợ lý tùy chỉnh.

Bạn có thể quyết định cách một trợ lý tùy chỉnh sử dụng kết nối MCP trong Cài đặt của trợ lý tùy chỉnh đó tại mục Công cụ & Truy cập. Mở rộng mục kết nối MCP để xem các công cụ khả dụng và xác định cách chúng chạy. Các công cụ có thể được chuyển đổi bật hoặc tắt bằng cách sử dụng nút chuyển đổi bên cạnh.

Công cụ đọc và ghi

• Các công cụ đọc (ví dụ: tìm kiếm, tìm nạp, liệt kê, xem) cho phép trợ lý tùy chỉnh truy xuất hoặc xem thông tin mà không thực hiện thay đổi đối với các hệ thống bên ngoài.

• Các công cụ ghi (ví dụ: tạo, cập nhật, xóa, gửi, đăng) thực hiện thay đổi đối với dữ liệu trong các hệ thống bên ngoài. Theo mặc định, các công cụ này yêu cầu xác nhậntrước khi trợ lý tùy chỉnh thực thi Hành động.

Chạy tự động hoặc luôn hỏi

• Chạy tự động cho phép công cụ thực thi mà không yêu cầu xác nhận từ người dùng. Cài đặt này phù hợp nhất cho các công cụ đọc (tìm kiếm, tìm nạp, danh sách, xem) vì chúng không sửa đổi dữ liệu.

• Luôn hỏi <1>yêu cầu người dùng phê duyệt hoặc hủy hành động trước khi hành động đó thực thi. Đây là cài đặt mặc định cho các công cụ ghi (tạo, cập nhật, xóa, gửi) để ngăn chặn các thay đổi ngoài ý muốn.

• Luôn cho phép<1> phê duyệt vĩnh viễn tất cả các công cụ từ một máy chủ và xóa các lời nhắc xác nhận trong tương lai.

Để xóa kết nối MCP

1. Mở Cài đặt của trợ lý.

2. Đi tới Công cụ & Truy cập.

3. Tìm kết nối MCP và nhấp vào Ngắt kết nối.

4. Nhấp vào Ngắt kết nối để xác nhận.

5. Luôn kiểm tra trợ lý của bạn sau khi thực hiện thay đổi. Bạn có thể kết nối lại bất kỳ lúc nào bằng cách xác thực lại.

Ghi chú: Nếu bạn xóa kết nối, trợ lý sẽ không còn quyền truy cập vào dịch vụ đó và các lượt chạy theo lịch trình phụ thuộc vào máy chủ đó có thể thất bại. Quy trình làm việc của trợ lý có thể bị gián đoạn ngay khi bạn ngắt kết nối. Bạn có thể kết nối lại bất kỳ lúc nào bằng cách xác thực lại.

Các kết nối MCP tuân thủ các cấp quyền người dùng được thiết lập trên trợ lý tùy chỉnh của bạn. Dưới đây là những gì mỗi cấp quyền có thể thực hiện với các công cụ được kết nối MCP.

Người dùng có quyền Truy cập đầy đủ và Có thể chỉnh sửa đối với trợ lý tùy chỉnh có thể:

• Thêm các kết nối MCP mới vào trợ lý tùy chỉnh.

• Trò chuyện với trợ lý và sử dụng tất cả các công cụ được kết nối, ngay cả khi họ không có quyền truy cập vào công cụ đó bên ngoài trợ lý.

• Xem nhật ký hoạt động và việc sử dụng công cụ MCP của trợ lý.

• Xóa các kết nối MCP hiện có.

• Kết nối lại hoặc cập nhật thông tin đăng nhập máy chủ MCP.

Và đối với các kết nối MCP mà họ thiết lập, người dùng có quyền Truy cập đầy đủ và Có thể chỉnh sửa có thể:

• Cấu hình công cụ nào được bật hoặc tắt và thay đổi cài đặt thực thi công cụ (chạy tự động so với luôn hỏi)

Ghi chú: Sau khi kết nối MCP được thiết lập, chỉ người xác thực kết nối MCP mới có thể cấu hình và cập nhật cài đặt công cụ - ngay cả khi những người khác có Truy cập đầy đủ hoặc Có thể chỉnh sửa đối với trợ lý tùy chỉnh. Trợ lý sử dụng thông tin đăng nhập và quyền của người đó khi truy cập dịch vụ bên ngoài.

Người dùng có quyền Có thể xem và tương tác đối với trợ lý tùy chỉnh có thể:

• Trò chuyện với trợ lý tùy chỉnh và sử dụng tất cả các công cụ được kết nối, ngay cả khi họ không có quyền truy cập vào các công cụ đó bên ngoài trợ lý tùy chỉnh.

• Kích hoạt cả hành động đọc và ghi thông qua trợ lý.

• Phê duyệt hoặc hủy hành động ghi khi cần xác nhận.

• Xem các máy chủ MCP nào đang được kết nối (trong cài đặt trợ lý tùy chỉnh).

Người dùng có quyền Có thể xem & tương tác không thể:

• Thêm hoặc xóa các kết nối MCP.

• Thay đổi các công cụ nào được bật.

• Sửa đổi cài đặt thực thi công cụ.

• Xem nhật ký hoạt động đầy đủ của trợ lý.

Ghi chú: Các hành động ghi (như tạo hoặc cập nhật mục) yêu cầu xác nhận theo mặc định để ngăn chặn các thay đổi ngoài ý muốn. Người dùng sẽ thấy một lời nhắc hiển thị chính xác hành động mà trợ lý sẽ thực hiện trước khi nó thực thi.

Nếu các công cụ không xuất hiện sau khi kết nối:

• Làm mới trang cài đặt trợ lý.

• Kiểm tra xem máy chủ MCP đã xác thực thành công chưa (tìm dấu kiểm màu xanh lục hoặc trạng thái “Đã kết nối”).

• Xác minh rằng máy chủ đang trực tuyến và trả về siêu dữ liệu công cụ.

• Thử kết nối lại máy chủ, hoặc ngắt kết nối và thêm lại.

Nếu các lượt chạy trợ lý tùy chỉnh thất bại với lỗi MCP:

• Kiểm tra tab Hoạt động để biết các thông báo lỗi cụ thể.

• Xác minh rằng kết nối của bạn vẫn hợp lệ (các mã thông báo có thể đã hết hạn).

• Đảm bảo kết nối vẫn được bật trong cài đặt của trợ lý.

• Thử kết nối lại máy chủ MCP để làm mới thông tin đăng nhập.

• Cập nhật Hướng dẫn cho trợ lý tùy chỉnh của bạn để đề cập đến tên máy chủ hoặc công cụ mà bạn muốn sử dụng. Ví dụ: “Sử dụng Linear MCP để truy xuất siêu dữ liệu cho bản mô phỏng này.”