Hướng dẫn sử dụng Sanko Agent
Sanko Agent đọc dữ liệu công ty trên server Sanko theo quyền của từng tài khoản, tính toán và trả kết quả dưới dạng file. Việc không cần dữ liệu công ty (viết nội dung, tìm trên web, lên lịch) do Claude của bạn tự làm.
Làm lần lượt từ bước 1 đến bước 4, chỉ cần làm một lần. Sau đó mỗi lần dùng xem phần Dùng hằng ngày.
https://mcp.sanko.com.vn/mcp
https://mcp.sanko.com.vn/access
Phiên kết nối có hiệu lực 24 giờ. Không gửi mật khẩu hoặc dữ liệu đăng nhập vào nội dung chat.
Bước 1. Chuẩn bị
- Tài khoản Sanko: tên đăng nhập và mật khẩu do quản trị viên cấp. Chưa có thì hỏi quản trị viên, không tự tạo được.
- Tài khoản Claude: đăng ký tại claude.ai bằng email của bạn.
- Ứng dụng Claude Desktop (khuyên dùng): tải tại claude.com/download, cài và đăng nhập bằng tài khoản Claude ở trên. Bản web claude.ai cũng dùng được, trừ Cowork.
Gói Claude bạn đang dùng quyết định cách cài skill ở bước 4:
| Gói Claude | Kết nối Sanko | Cài skill | Ghi chú |
|---|---|---|---|
| Free (miễn phí) | Được, nhưng gói Free chỉ thêm được một custom connector | Cách B: tải file .zip lên bằng tay | Không có Cowork. Giới hạn số tin nhắn thấp, task dài có thể bị ngắt giữa chừng. |
| Pro, Max (trả phí) | Được | Cách A: Cowork tự cài (hoặc cách B) | Có Cowork trong Claude Desktop. |
| Team, Enterprise (gói công ty) | Được nếu chủ tổ chức cho phép | Cách A hoặc B | Chủ tổ chức phải bật Skills, code execution và custom connector trong Organization settings; nếu không thấy các mục ở bước 2, hỏi người quản lý gói Claude của công ty. |
Giao diện Claude là tiếng Anh và thỉnh thoảng đổi tên mục. Hướng dẫn ghi tên mục như trên màn hình; nếu không thấy đúng tên, tìm mục gần giống (ví dụ Settings có thể nằm trong Customize).
Bước 2. Bật tính năng trong Claude
Bấm vào tên/ảnh đại diện của bạn ở góc dưới bên trái → Settings → Capabilities, rồi bật:
- Code execution and file creation (giao diện mới gọi là Create and edit files). Thiếu mục này thì skill không chạy và Claude không gửi file cho Sanko được.
- Allow network egress (cho Claude kết nối mạng khi chạy code). Cần để Claude tải skill từ GitHub và gửi file của bạn lên Sanko.
- Skills: nếu có công tắc riêng cho Skills thì bật luôn.
Bước 3. Kết nối Sanko
- Mở trang /access, đăng nhập bằng tài khoản Sanko. Giữ trang này mở để sao chép OAuth Client ID và Client Secret.
- Trong Claude, vào Settings (hoặc Customize) → Connectors → Add custom connector.
- Đặt tên
Sanko Agent, nhập URLhttps://mcp.sanko.com.vn/mcp. - Mở Advanced settings (hoặc chọn Use your own OAuth client nếu Claude hỏi cách đăng nhập), dán OAuth Client ID và Client Secret từ trang
/access, bấm Add. - Bấm Connect; một trang đăng nhập Sanko hiện ra, đăng nhập bằng tài khoản Sanko và bấm cho phép.
- Thấy
Sanko Agenttrong danh sách Connectors, trạng thái đã kết nối, là xong.
Gói Free chỉ có một custom connector: nếu đã thêm connector khác thì phải gỡ nó ra mới thêm được Sanko.
Bước 4. Cài skill
Skill dạy Claude khi nào gọi Sanko và cách đọc kết quả. Không cài skill thì Claude vẫn thấy Sanko nhưng hay tự đoán số thay vì hỏi Sanko. Mỗi vai trò có bộ skill riêng; đoạn Cài skill trên trang /access đã ghi đúng vai trò của bạn.
Cách A: Cowork (gói Pro, Max, Team, Enterprise)
- Mở Claude Desktop, chuyển sang Cowork.
- Trên trang
/access, bấm Sao chép ở ô Skill Claude, dán vào Cowork và gửi. - Claude tự đọc hướng dẫn, gỡ skill Sanko cũ, cài bộ mới rồi báo lại. Nếu Claude hỏi quyền chạy lệnh hoặc ghi file, bấm cho phép.
Cách B: tải skill lên bằng tay (gói Free, hoặc khi cách A không được)
- Mở một cuộc chat mới (chat thường), dán đoạn Cài skill từ trang
/accessvà gửi. - Claude không tự cài được trong chat thường, nên sẽ đóng gói mỗi skill thành một file
.zipvà liệt kê skill cũ cần gỡ. Tải hết các file.zipvề máy. - Vào Customize (hoặc Settings → Capabilities) → Skills. Gỡ các skill Sanko cũ mà Claude đã liệt kê.
- Bấm + → Create skill → Upload a skill, chọn từng file
.zip. Không giải nén file. - Kiểm tra các skill vừa tải lên đều đang bật.
Khi quản trị viên báo có bản skill mới, làm lại bước 4 (cách nào cũng được). Xong bước 4 thì mở cuộc chat mới và gõ thử: Sanko giúp được mình những việc gì?
Dùng hằng ngày
- Mở cuộc chat mới cho mỗi việc mới.
- Kiểm tra Sanko đang bật trong chat: bấm nút + (hoặc biểu tượng công cụ) ở ô nhập chat → Connectors → bật
Sanko Agent. - Khi Claude hỏi quyền dùng tool của Sanko, chọn Always allow để không bị hỏi lại.
- Hỏi bằng tiếng Việt như nói với đồng nghiệp, nói rõ khoảng thời gian và kết quả muốn nhận (bảng, Excel, biểu đồ).
- Nếu quá 24 giờ chưa dùng, Claude có thể yêu cầu đăng nhập lại Sanko: bấm theo và đăng nhập.
Bắt đầu
Sanko giúp được mình những việc gì? Mình đang xem được dữ liệu nào?
Mỗi vai trò có danh mục việc riêng, ví dụ:
- Kế toán: “Lập báo cáo doanh thu – chi phí quý 3 theo mẫu, xuất Excel.”
- Marketing: “Kênh quảng cáo nào hiệu quả nhất tháng 8?”
- Kinh doanh: “Doanh số tháng này của mình, còn bao nhiêu để đạt chỉ tiêu?”
Việc ngoài danh mục của vai trò thì Sanko trả lời là không phục vụ. Sanko chỉ dùng dữ liệu mà tài khoản của bạn được xem và không tự tạo số: thiếu dữ liệu thì báo thiếu gì. Cần thêm dữ liệu thì hỏi quản trị viên.
Gửi file cho Sanko
- Đính kèm file vào chat như bình thường (Excel, CSV, PDF…) và nói cần làm gì với file đó. Claude sẽ tự gửi file lên Sanko qua một link riêng; nếu Claude hỏi quyền chạy lệnh, bấm cho phép.
- Không dán nội dung file vào chat; Sanko chỉ nhận file qua đường gửi file.
- Mỗi file tối đa 50 MB.
File kết quả
- File nằm trên server Sanko và được trả bằng link tải trực tiếp, hiệu lực 15 phút. Hết hạn thì nhờ Claude lấy link mới.
- Sanko báo thời gian dự kiến xong; Claude chờ đúng lúc rồi mới hỏi lại. Bạn không cần ngồi canh, quay lại cuộc chat sau cũng được.
Giới hạn
- Server chạy một task mỗi lúc, giữ tối đa 10 task đang mở; mỗi task tối đa 30 phút.
- Sanko không đăng bài, gửi email hay thay đổi tài khoản bên ngoài.
Xử lý lỗi thường gặp
- Không thấy nút Add custom connector: gói Free đã có một custom connector khác, hoặc gói công ty chưa cho phép; xem bước 1 và bước 3.
- Đăng nhập connector báo sai thông tin: sao chép lại Client ID và Client Secret từ trang
/access, không thừa dấu cách. - Claude trả lời mà không gọi Sanko, hoặc tự bịa số: kiểm tra Sanko đang bật trong chat và skill đã cài (bước 4), rồi mở cuộc chat mới.
- Claude báo không chạy được code hoặc không gửi được file: bật lại hai mục ở bước 2, mở cuộc chat mới. Vẫn lỗi thì báo quản trị viên kèm ảnh chụp màn hình.
- 401 hoặc yêu cầu đăng nhập lại: phiên 24 giờ đã hết; kết nối lại.
- Không thấy tool mới: kết nối lại connector Sanko và mở cuộc chat mới.
- Task chờ thông tin: trả lời câu hỏi để Sanko làm tiếp.
- Link file hết hạn: nhờ Claude lấy lại danh sách file.
- Quên mật khẩu Sanko: hỏi quản trị viên đặt lại; đổi mật khẩu trên trang
/access.