API công khai

Kết nối trợ lý AI (MCP)

Tạo một khóa API chỉ với những phạm vi trợ lý cần, rồi đưa cho client địa chỉ https://api.mosaqo.app/v1/mcp cùng khóa đó làm token bearer. Trợ lý làm được đúng những gì khóa cho phép, không hơn, và bạn có thể ngắt kết nối bất cứ lúc nào trong Bulk & API.

Đã rà soát 20 tháng 8, 2026

Các bước

1. Mở Bulk & API → API keys và tạo một khóa. Trước hết chỉ cấp phạm vi đọc; khóa thứ hai có quyền ghi hãy cấp khi bạn đã thấy trợ lý làm gì.
2. Sao chép địa chỉ từ khung AI assistants (MCP) trên cùng màn hình.
3. Trong trợ lý, thêm một máy chủ với địa chỉ đó và gửi khóa ở header Authorization: Bearer. Phần lớn client nhận một khối JSON có url và headers.
4. Một số đầu nối yêu cầu bạn đăng nhập Mosaqo thay vì dán khóa. Lối đó cho thấy ai đang xin, không gian nào bị ảnh hưởng và nó sẽ làm được gì, trước khi cấp bất cứ thứ gì — chỉ chủ sở hữu hoặc quản trị viên mới phê duyệt được.
5. Hãy hỏi trợ lý nó làm được gì. Nó sẽ liệt kê các công cụ mà khóa của bạn cho phép — cách xác nhận nhanh nhất rằng kết nối hẹp đúng như bạn muốn.

Cách kiểm chứng kết quả

Hỏi điều chỉ không gian này biết: bạn có bao nhiêu mã, hay một khảo sát đang ra sao. Câu trả lời với tên và con số thật của bạn nghĩa là kết nối chạy; một lời từ chối nêu tên phạm vi nghĩa là khóa hẹp hơn câu hỏi.

Chỗ thường sai

• Cấp quyền ghi ngay ở khóa đầu tiên. Bắt đầu chỉ đọc rồi mở rộng khi đã biết nó làm gì.
• Mong nó đọc được những gì mọi người viết trong khảo sát. Các câu trả lời đó không giao cho khóa hay trợ lý — điểm số và số lượng thì có, còn câu chữ ở lại hộp thư.
• Mong nó xóa một mã. Nó không thể: phá bỏ chuyển hướng phía sau một mã đã in là không hoàn tác được, nên nó được cấp tùy chọn lưu trữ, và việc đó đảo ngược được.
• Quên một kết nối. Trợ lý kết nối qua đăng nhập vẫn giữ quyền cho tới khi bị ngắt trong Bulk & API, y như một khóa còn hiệu lực cho tới khi bị thu hồi.