Dvina có máy chủ MCP riêng. Kết nối một ứng dụng hỗ trợ MCP như Claude Code, ChatGPT hoặc Cursor để ứng dụng đó có thể thay mặt bạn tìm kiếm trong Dvina, đọc tài liệu và bộ nhớ của bạn, cũng như thêm ghi chú, tác vụ và lời nhắc.
Trước khi bắt đầu
Bạn cần địa chỉ máy chủ:
https://api.dvina.ai/mcp
Nếu công ty bạn chạy Dvina trên máy chủ riêng, hãy dùng địa chỉ API Dvina của công ty và thêm /mcp ở cuối. Hãy hỏi quản trị viên để lấy địa chỉ này.
Máy chủ sử dụng Streamable HTTP. Nếu ứng dụng yêu cầu chọn phương thức truyền tải, hãy chọn HTTP.
Kết nối ứng dụng
Claude Code
Trong terminal, chạy:
claude mcp add --transport http dvina https://api.dvina.ai/mcpKhởi động Claude Code, chạy
/mcp, chọn dvina rồi đăng nhập vào Dvina.
ChatGPT
- Mở phần cho phép thêm máy chủ MCP trong ChatGPT.
- Nhập
https://api.dvina.ai/mcplàm địa chỉ máy chủ và chọn OAuth nếu được hỏi về cách đăng nhập. - Đăng nhập vào Dvina khi ChatGPT yêu cầu.
Cursor
- Mở phần cho phép thêm máy chủ MCP trong Cursor.
- Thêm máy chủ có tên
dvinavới địa chỉhttps://api.dvina.ai/mcp. - Đăng nhập vào Dvina khi Cursor yêu cầu.
Bạn không cần ID ứng dụng khách hay khóa bí mật. Ứng dụng sẽ tự đăng ký với Dvina trong lần kết nối đầu tiên.
Đăng nhập
Máy chủ MCP của Dvina cho phép bạn đăng nhập bằng OAuth trong trình duyệt:
- Đăng nhập vào Dvina như bình thường.
- Nếu bạn thuộc nhiều không gian làm việc, hãy chọn một không gian trong phần Chọn không gian làm việc, rồi chọn Tiếp tục. Ứng dụng chỉ hoạt động trong không gian làm việc đó.
- Trong phần Cấp quyền truy cập, kiểm tra tên ứng dụng rồi chọn Cho phép truy cập. Chọn Từ chối nếu bạn không nhận ra ứng dụng đó.
Ứng dụng sẽ duy trì kết nối nên bạn không cần đăng nhập mỗi lần sử dụng.
Ứng dụng có thể làm gì
Ứng dụng có thể thấy các công cụ của Dvina và sử dụng chúng khi cần để thực hiện yêu cầu của bạn:
| Khu vực | Những việc ứng dụng khách có thể làm |
|---|---|
| Tìm kiếm | Tìm kiếm đồng thời trong các cuộc trò chuyện, tài liệu, bộ nhớ và thế giới của bạn. |
| Bộ nhớ | Liệt kê và đọc các tệp bộ nhớ của bạn, thêm tệp mới hoặc chỉnh sửa tệp. |
| Thế giới | Liệt kê các chủ đề của bạn, hiển thị những gì Dvina biết về một chủ đề hoặc bất kỳ điều gì khác, và liệt kê nội dung trong Bảng tin của bạn. |
| Tài liệu | Liệt kê, đọc và tìm kiếm trong Thư viện của bạn, tạo ghi chú và thư mục, tải tệp lên, thay thế, di chuyển hoặc đổi tên tài liệu, hoặc chuyển tài liệu vào thùng rác. |
| Canvas | Liệt kê và đọc các canvas của bạn, tạo canvas hoặc viết lại một trang. |
| Tác vụ và mục tiêu | Liệt kê các tác vụ của bạn và đọc những việc chúng đã thực hiện, bắt đầu một tác vụ hoặc một tác vụ hướng tới mục tiêu, giao thêm việc cho tác vụ hoặc dừng tác vụ. |
| Tin nhắn đã lên lịch | Liệt kê các tin nhắn này, lên lịch gửi tin nhắn hoặc lời nhắc một lần hay lặp lại, hoặc hủy lịch. |
| Tác nhân và kỹ năng | Liệt kê và đọc các tác nhân và kỹ năng của bạn, tạo tác nhân, thêm kỹ năng hoặc chỉnh sửa tác nhân hay kỹ năng. |
| Dự án | Liệt kê các dự án của bạn và hiển thị thư mục cùng các tác vụ gần đây của một dự án. |
| Chia sẻ | Xem ai có quyền truy cập một mục và những gì người khác đã chia sẻ với bạn, hoặc cấp hay thu hồi quyền truy cập của một người. |
| Cài đặt | Hiển thị các tùy chọn của bạn hoặc bật hay tắt bộ nhớ. |
Ứng dụng khách không thể xóa vĩnh viễn bất cứ thứ gì, mở liên kết công khai, kết nối hoặc ngắt kết nối ứng dụng, hay thay đổi cài đặt quản trị hoặc thanh toán.
Phê duyệt thay đổi
Mọi thao tác của ứng dụng khách đều tuân theo các quy tắc áp dụng trên toàn bộ Dvina:
- Các thao tác đọc được thực hiện mà không cần hỏi bạn.
- Việc thêm nội dung mới, như ghi chú, tệp bộ nhớ hoặc tác vụ, được thực hiện mà không cần hỏi bạn. Thao tác này không bao giờ thay đổi nội dung đã có.
- Việc thay đổi hoặc xóa nội dung, như chuyển tài liệu vào thùng rác, viết lại một trang canvas, dừng tác vụ hoặc chia sẻ một mục, đều cần hỏi bạn trước. Ứng dụng khách hiển thị bản tóm tắt thay đổi do chính Dvina cung cấp để bạn phê duyệt hoặc từ chối. Nếu bạn từ chối, không có gì thay đổi.
Lưu ý
Nếu ứng dụng khách không thể yêu cầu bạn xác nhận, Dvina sẽ không thực hiện thay đổi từ ứng dụng đó. Thay vào đó, hãy thực hiện thay đổi trong ứng dụng Dvina hoặc dùng một ứng dụng khách có thể yêu cầu xác nhận.
Quyền truy cập của bạn và các quy định của công ty
Ứng dụng khách hoạt động dưới danh nghĩa của bạn, với quyền xem và thao tác mà bạn có trong Dvina:
- Ứng dụng khách chỉ hoạt động khi bạn vẫn là thành viên của không gian làm việc và chỉ thực hiện những gì vai trò của bạn cho phép.
- Nếu quản trị viên tắt một tính năng, chẳng hạn như tải tệp lên, ứng dụng khách cũng không thể sử dụng tính năng đó.
- Nội dung mà ứng dụng khách thêm hoặc thay đổi đều được xử lý theo các quy định bảo vệ dữ liệu của công ty bạn, giống như trong ứng dụng.
- Nội dung mà ứng dụng khách thêm hoặc thay đổi được ghi vào nhật ký kiểm tra của bạn dưới dạng thao tác do trợ lý thực hiện thay bạn, kèm theo ứng dụng khách đã thực hiện thao tác đó.
- Các thao tác của ứng dụng khách được tính vào mức sử dụng của bạn, trong phạm vi giới hạn thông thường.
Kết nối bằng khóa API thay cho OAuth
Với gói Enterprise, ứng dụng khách có thể kết nối bằng mã thông báo truy cập cá nhân thay vì đăng nhập. Hãy dùng cách này cho ứng dụng khách không thể đăng nhập bằng OAuth hoặc cho một tập lệnh.
- Mở Cài đặt và chọn Truy cập API.
- Trong Mã thông báo truy cập cá nhân, chọn Tạo mã thông báo.
- Nhập Tên, chọn Quyền truy cập và thời điểm Hết hạn, rồi chọn Tạo mã thông báo.
- Trong Sao chép mã thông báo của bạn, sao chép mã thông báo. Đây là lần duy nhất mã thông báo được hiển thị.
Chọn quyền truy cập mà ứng dụng khách cần:
- Chỉ đọc: ứng dụng khách chỉ thấy các công cụ đọc. Ứng dụng khách có thể tìm kiếm và đọc nội dung của bạn trong Dvina, nhưng không thể thêm hoặc thay đổi bất cứ thứ gì.
- Đọc và ghi: ứng dụng khách thấy tất cả các công cụ, và mọi thay đổi vẫn cần bạn phê duyệt, giống như khi dùng OAuth.
Gửi mã thông báo trong tiêu đề Authorization, sau Bearer. Ví dụ, trong Claude Code:
claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer <your token>"
Trong ứng dụng khách khác, hãy thêm cùng tiêu đề này ở nơi cho phép bạn thiết lập tiêu đề cho máy chủ MCP.
Mã thông báo hoạt động dưới danh nghĩa của bạn, trong không gian làm việc nơi bạn tạo mã, với vai trò hiện tại của bạn tại đó. Để thay thế mã, hãy mở mã trong Mã thông báo truy cập cá nhân và chọn Thay mới…: mã thông báo mới sẽ thay thế mã cũ, và mã cũ ngừng hoạt động ngay lập tức. Để vô hiệu hóa mã, chọn Thu hồi…: mọi thứ sử dụng mã đó sẽ ngừng hoạt động ngay lập tức.
Để tìm hiểu thêm về mã thông báo, xem Truy cập API.