Kết nối tác nhân AI
Tác nhân AI có thể liệt kê, tải lên và sắp xếp nội dung thay bạn. Hướng dẫn này cho biết cách cấp quyền truy cập, bằng một mã hoặc bằng cách để ứng dụng tự đăng nhập, nên cho nó làm đến đâu và cách lấy lại quyền đó.
Dành cho mọi người có tài khoản, ở mọi gói.
Hình ảnh là màn hình điện thoại. Trên máy tính các trang trông giống vậy, chỉ rộng hơn.
Trên trang này
Nó làm được gì
- Các ứng dụng như Claude Code, Codex, Cursor và Gemini CLI có thể kết nối với tài khoản của bạn qua MCP, một cách tiêu chuẩn để tác nhân AI dùng các dịch vụ khác.
- Sau khi kết nối, bạn có thể nhờ tác nhân bằng lời thông thường, ví dụ chuyển ảnh kỳ nghỉ vào một thư mục mới hoặc thêm tiêu đề và mô tả cho các tệp.
- Tác nhân vào bằng một mã: một chuỗi bí mật dài do bạn tạo. Ai có mã này đều có thể làm mọi việc trong tài khoản của bạn mà mức truy cập của mã cho phép, nên hãy giữ kín như mật khẩu.
Tạo mã
- Chạm vào nút hình robot ở đầu trang (Tác nhân đã kết nối).
- Chạm vào Mã mới.
- Ở mục Nhãn, nhập một tên mà sau này bạn nhận ra, ví dụ tên ứng dụng.
- Chọn một mục trong Mức truy cập (xem thêm bên dưới), rồi chạm vào Tạo mã.

Đưa cho tác nhân
- Bây giờ bạn thấy Đã tạo mã. Chạm vào Sao chép tin nhắn thiết lập.
- Dán tin nhắn vào cuộc trò chuyện với tác nhân rồi gửi. Tác nhân chạy được lệnh, như Claude Code hoặc Codex, sẽ đọc trang thiết lập của chúng tôi và tự thêm kết nối. Một số cần khởi động lại mới dùng được.
- Chạm vào Xong khi tác nhân đã kết nối.
Thiết lập ứng dụng thủ công? Chạm vào Điểm cuối MCP để sao chép địa chỉ, và đưa mã cho ứng dụng bằng Sao chép mã. Cài đặt cho Claude Code, Codex, Cursor, Gemini CLI và các ứng dụng khác có tại account.nostr.build/agent-setup.md (bằng tiếng Anh).

Hoặc để ứng dụng tự đăng nhập
Những ứng dụng biết tự đăng nhập, như Claude Code, Claude Desktop, Cursor và VS Code, không cần mã. Thêm nostr.build vào ứng dụng (cách cài đặt có trên account.nostr.build/agent-setup.md) và ứng dụng sẽ mở trang này trong trình duyệt của bạn.
- Đăng nhập nếu được yêu cầu. Bạn đến cùng trang như khi dùng mã, với mã đã điền sẵn. Chạm vào Tiếp tục.
- Kiểm tra tên ứng dụng và nơi trang cho biết mã sẽ được gửi trả về. Với nhiều ứng dụng, trang còn cho biết nơi ứng dụng được công bố, ví dụ claude.ai với Claude Code. Chúng tôi kiểm tra rằng thông tin của ứng dụng thật sự đến từ địa chỉ đó; riêng cái tên chỉ là điều ứng dụng tự nói về mình. Sau đó chọn một Mức truy cập. Ở đây bạn có thể cấp nhiều hơn mức ứng dụng yêu cầu: hầu hết ứng dụng yêu cầu Chỉ đọc.
- Chạm vào Phê duyệt. Trình duyệt quay lại ứng dụng, và ứng dụng đã được kết nối. Nó xuất hiện trong Tác nhân đã kết nối.

Hoặc phê duyệt mã kết nối
Những tác nhân không tự đăng nhập được sẽ xin bằng mã. Tác nhân hiện cho bạn một mã ngắn (như ABCD-2345) và một liên kết.
- Đăng nhập trước, rồi mở liên kết: mã đã được điền sẵn. Hoặc trong Tác nhân đã kết nối, chạm vào Phê duyệt và nhập mã vào Mã kết nối. Sau đó chạm vào Tiếp tục.
- Kiểm tra tên tác nhân và quyền truy cập nó yêu cầu. Bạn có thể cấp ít hơn, không bao giờ nhiều hơn.
- Chạm vào Phê duyệt. Tác nhân tự nhận mã; bạn không bao giờ thấy mã đó. Sau đó tác nhân xuất hiện trong Tác nhân đã kết nối.

Chọn đúng mức truy cập
- Chỉ đọc: tác nhân có thể xem thư mục, tệp, tài khoản và thông báo của bạn, và không thay đổi gì.
- Đọc và ghi: tác nhân còn có thể tải lên, tạo thư mục, di chuyển tệp, sửa tiêu đề và mô tả, và đặt ảnh bìa cho video. Với các gói có AI Studio, tác nhân còn có thể tạo ảnh AI, và các mô hình trả phí sẽ dùng Tín dụng AI của bạn.
- Toàn quyền, bao gồm cả xóa: tác nhân còn có thể xóa tệp và thư mục. Xóa một thư mục sẽ chuyển các tệp bên trong về Trang chủ, nhưng tác nhân cũng có thể xóa một thư mục cùng mọi thứ bên trong. Tệp đã xóa không khôi phục được.
Xem và thu hồi mã
- Mở Tác nhân đã kết nối. Mỗi mã hiện tên, mức truy cập, thời điểm tạo và thời điểm dùng gần nhất, kèm địa chỉ IP và ứng dụng đã dùng (Chưa từng dùng nếu chưa dùng). Thông tin này được cập nhật tối đa mỗi giờ một lần.
- Chạm vào Thu hồi cạnh một mã, rồi chạm Thu hồi lần nữa để xác nhận. Mọi tác nhân đang dùng mã đó sẽ mất quyền truy cập ngay lập tức. Việc xóa thư mục mà nó đã bắt đầu vẫn sẽ chạy đến hết.
Mã không tự hết hạn, nên hãy thu hồi những mã bạn không còn dùng. Không thể đổi tên và mức truy cập của mã: hãy tạo mã mới và thu hồi mã cũ.

Hướng dẫn liên quan
Thư viện của bạn
Tải lên từ điện thoại hoặc máy tính, xếp tệp vào thư mục, sao chép liên kết để chia sẻ, di chuyển và xóa tệp.
Đăng nhập và các tài khoản của bạn
Đăng nhập bằng mật khẩu, khóa Nostr hoặc mã, đặt lại mật khẩu và chuyển đổi giữa các tài khoản.
Khi có sự cố
Ý nghĩa các thông báo lỗi và cách xử lý: tải lên, dung lượng lưu trữ, trình chỉnh sửa, đăng nhập, thanh toán và trang không tải được.
Vẫn chưa được? Hướng dẫn Khi có sự cố giải thích các thông báo lỗi thường gặp, và hướng dẫn Nhận trợ giúp chỉ cách liên hệ với đội ngũ.