← Sanko Agent

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.

Địa chỉ MCP

https://mcp.sanko.com.vn/mcp

Thông tin kết nối

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ị

  1. 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.
  2. Tài khoản Claude: đăng ký tại claude.ai bằng email của bạn.
  3. Ứ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 ClaudeKết nối SankoCài skillGhi chú
Free (miễn phí)Được, nhưng gói Free chỉ thêm được một custom connectorCách B: tải file .zip lên bằng tayKhô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í)ĐượcCá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épCách A hoặc BChủ 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:

  1. 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.
  2. 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.
  3. 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

  1. 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.
  2. Trong Claude, vào Settings (hoặc Customize) → Connectors → Add custom connector.
  3. Đặt tên Sanko Agent, nhập URL https://mcp.sanko.com.vn/mcp.
  4. 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.
  5. 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.
  6. Thấy Sanko Agent trong 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)

  1. Mở Claude Desktop, chuyển sang Cowork.
  2. Trên trang /access, bấm Sao chép ở ô Skill Claude, dán vào Cowork và gửi.
  3. 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)

  1. Mở một cuộc chat mới (chat thường), dán đoạn Cài skill từ trang /access và gửi.
  2. 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 .zip và liệt kê skill cũ cần gỡ. Tải hết các file .zip về máy.
  3. Vào Customize (hoặc Settings → Capabilities) → Skills. Gỡ các skill Sanko cũ mà Claude đã liệt kê.
  4. Bấm + → Create skill → Upload a skill, chọn từng file .zip. Không giải nén file.
  5. 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

  1. Mở cuộc chat mới cho mỗi việc mới.
  2. 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.
  3. Khi Claude hỏi quyền dùng tool của Sanko, chọn Always allow để không bị hỏi lại.
  4. 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 đồ).
  5. 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ụ:

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

File kết quả

Giới hạn

Xử lý lỗi thường gặp