Kết nối Notion
Kết nối m ột workspace Notion với Rephlo để AI có thể tìm kiếm và chỉnh sửa trang cùng cơ sở dữ liệu (database) như một phần của cuộc trò chuyện (chat). Connector Notion khả dụng trên các gói Starter, Pro, Pro+, Elite, và Enterprise, cũng như trong thời gian Trial. Xem Gói & Giá để biết những gì được bao gồm trong từng gói.
Notion được kết nối trong ứng dụng desktop tại Settings → Connectors. Để hiểu thêm về cách connector hoạt động, xem Tổng quan Connectors.
Bạn có thể làm gì
Khi Notion đã được kết nối và được chọn trong menu Connectors của composer, mô hình có thể gọi các công cụ sau thay mặt bạn:
- Search trang và cơ sở dữ liệu theo truy vấn, thẻ (tag), hoặc ngày tháng.
- Read nội dung của một trang, bao gồm cả block và các hàng cơ sở dữ liệu.
- Create trang mới hoặc hàng cơ sở dữ liệu mới.
- Update các trang hiện có — thêm block, chỉnh sửa thuộc tính (properties), hoặc đổi trạng thái.
Mỗi lượt gọi công cụ xuất hiện dưới dạng một thẻ breadcrumb nhỏ trong cuộc trò chuyện, hiển thị tên công cụ, trạng thái, và thời gian thực hiện — nhờ đó bạn có thể thấy chính xác AI đã làm gì mà không cần cuộn qua đầu ra thô (raw output).
Cách kết nối
- Trong ứng dụng desktop, mở Settings → Connectors.
- Tìm thẻ Notion và nhấp Connect.
- Trình duyệt mặc định của bạn sẽ mở trang ủy quyền (authorization) của Notion. Đăng nhập nếu cần.
- Chọn workspace Notion và các trang bạn muốn Rephlo được truy cập. Bạn có thể cấp quyền truy cập cho các trang và cơ sở dữ liệu cụ thể — Notion không yêu cầu quyền truy cập toàn bộ workspace.
- Phê duyệt (Approve). Trình duyệt trả quyền điều khiển lại cho Rephlo, và thẻ chuyển sang huy hiệu Connected.
Thẻ connector Notion trong Settings, trước và sau khi kết nối.
Toàn bộ luồng này dùng OAuth 2.1 với PKCE và Dynamic Client Registration. Không có thông tin xác thực dùng chung, không có khóa API nào cần sao chép qua lại — quyền truy cập của bạn được giới hạn theo tài khoản của bạn và có thể thu hồi bất cứ lúc nào từ chính phần cài đặt tích hợp (integration settings) của Notion.
Các quyền Rephlo yêu cầu
| Quyền | AI được phép làm gì |
|---|---|
| Read content | Đọc các trang và cơ sở dữ liệu bạn đã chia sẻ rõ ràng với connector. |
| Update content | Chỉnh sửa các trang và hàng cơ sở dữ liệu bạn đã chia sẻ. |
| Insert content | Thêm trang và hàng mới trong các workspace bạn đã chia sẻ. |
Rephlo không bao giờ có quyền truy cập vào các trang bạn không chia sẻ với connector trong bước ủy quyền. Bạn có thể chạy lại luồng này bất cứ lúc nào để mở rộng hoặc thu hẹp phạm vi chia sẻ.
Dữ liệu của bạn được lưu ở đâu
- Authorization tokens (token ủy quyền) được lưu trữ ở dạng mã hóa trên thiết bị của bạn, trong thư mục dữ liệu ứng dụng của Rephlo. Chúng không bao giờ rời khỏi máy của bạn — backend của Rephlo không nhìn thấy chúng.
- Tool results (kết quả công cụ — ví dụ: một trang được trả về từ một lượt tìm kiếm) chỉ tồn tại trong bộ nhớ trong khi phiên chat đang hoạt động. Kết quả đầy đủ không được lưu xuống đĩa; chỉ một bản tóm tắt văn bản ngắn xuất hiện trong breadcrumb của cuộc trò chuyện.
- Một audit log (nhật ký kiểm toán) trên thiết bị của bạn ghi lại mọi lần connect, disconnect, refresh và gọi công cụ — chỉ gồm tên connector, tên công cụ, thời lượng và trạng thái. Đối số của công cụ (tool arguments) và nội dung kết quả không bao giờ được ghi log.
Dùng Notion trong một cuộc trò chuyện
Hãy đảm bảo Notion đã được chọn trong menu Connectors của composer. Sau đó chỉ cần hỏi một cách tự nhiên — ví dụ: "Tìm trang lập kế hoạch Q3 của tôi trong Notion và tóm tắt các công việc còn dang dở." AI sẽ gọi các công cụ search và read, và bạn sẽ thấy các breadcrumb xuất hiện trong lúc nó xử lý.
Ngắt kết nối
Nhấp Disconnect trên thẻ Notion để:
- Hủy mọi lượt gọi công cụ Notion đang thực hiện dở.
- Đóng kết nối tới Notion.
- Cố gắng thu hồi (best-effort) access token và refresh token với Notion.
- Xóa danh sách công cụ đã lưu trong bộ nhớ đệm và kết nối khỏi cơ sở dữ liệu cục bộ của bạn.
Các breadcrumb lịch sử từ những lượt gọi công cụ Notion trước đây vẫn được giữ lại — chúng là bản ghi những gì đã xảy ra, không phải thông tin xác thực đang hoạt động.
Nếu bạn cũng muốn thu hồi quyền truy cập của Rephlo từ phía Notion (khuyến nghị để dọn dẹp triệt để), mở Notion → Settings & Members → Integrations và gỡ Rephlo.
Khắc phục sự cố
"Authorization failed — please try again." Thường do phiên trình duyệt đã cũ hoặc quá trình đăng nhập bị gián đoạn. Nhấp Connect lại từ thẻ Notion.
Kết nối hiển thị "Needs re-auth." Quyền truy cập của bạn đã hết hạn hoặc bị thu hồi từ phía Notion. Mở bảng chi tiết của thẻ và ủy quyền lại.
"Some tools are unavailable because they need additional permissions." Bạn đã cấp ít quyền hơn mức Rephlo yêu cầu. Nhấp Reconnect và chấp nhận toàn bộ quyền để mọi công cụ hoạt động trở lại.
Một lượt gọi công cụ báo lỗi giao thức (protocol error). Hầu như luôn là do Notion gián đoạn tạm thời. Thử lại sau vài phút — cuộc trò chuyện vẫn tiếp tục, chỉ lượt gọi bị lỗi bị ảnh hưởng.
Một lượt gọi công cụ bị hết thời gian chờ (timeout). Các thao tác chạy lâu (tìm kiếm lớn, đọc trang dung lượng lớn) có thể chạm giới hạn 60 giây cho mỗi lượt gọi. Hãy thử một truy vấn hẹp hơn, hoặc chia nhỏ công việc thành nhiều yêu cầu.
Tiếp theo là gì
Nhiều connector khác đang được bổ sung thường xuyên — xem Tổng quan Connectors để có danh sách đầy đủ, cập nhật về những gì đã kết nối hôm nay và những gì sắp ra mắt. Bạn cũng có thể tự thêm một server do chính bạn vận hành ngay hôm nay; xem Server MCP tùy chỉnh.