CRETA Ticket MCP

Kết nối agent của quản lý để đọc, thẩm định và xử lý ticket bằng tài khoản cá nhân.

1. Thêm kết nối MCP

Trong ứng dụng agent, chọn thêm máy chủ MCP từ xa và nhập URL:

https://casecreta.nvlit.asia/mcp

Kiểu kết nối: Streamable HTTP. Xác thực: OAuth qua trình duyệt.

1. Ứng dụng mở trang đăng nhập Ticket. Dùng tài khoản cá nhân do quản trị viên cấp; không gửi mật khẩu/token vào chat.
2. Kiểm tra tài khoản và client, chọn quyền đọc hoặc thêm quyền ghi rồi bấm Kết nối.
3. Ứng dụng lưu token và tự gia hạn nếu hỗ trợ. Khi kết nối hết hạn hoặc bị thu hồi, đăng nhập lại.
4. Thử hỏi: “Liệt kê các ticket đang mở.” Chỉ báo thành công khi có phản hồi thật từ tool.

Client cần hỗ trợ OAuth public client, PKCE S256 và đăng ký client động (DCR). Chưa nghiệm thu end-to-end trên Claude, ChatGPT hay OpenCode; tên menu và khả năng hỗ trợ tùy ứng dụng/phiên bản. Không dán cấu hình đoán mò vào ứng dụng không tương thích.

2. Cài hướng dẫn cho agent

Nếu ứng dụng có chức năng import skill, chọn file ZIP. Nếu ứng dụng dùng thư mục skill, giải nén và đặt thư mục creta-ticket-reviewer vào vị trí theo tài liệu của ứng dụng. Skill không tự tạo kết nối MCP.

Client không hỗ trợ skill: dùng hướng dẫn Markdown làm chỉ dẫn cho agent. MCP cũng cung cấp resource creta-ticket://guide/reviewer và prompt review_ticket, nếu client hỗ trợ.

3. Yêu cầu mẫu

• “Thẩm định ticket [mã] từ [ngày] đến [ngày]. Kiểm tra đã gửi khách hay mới gửi nội bộ. Chưa thay đổi trạng thái.”
• “Đọc ảnh, đối soát DWH, lập timeline và chỉ rõ phần chưa xác minh.”
• “Lưu kết luận và bằng chứng vừa thẩm định.”
• “Mở lại ticket này, ghi rõ lý do và việc còn thiếu.”

4. Quản lý quyền truy cập

Đăng nhập web Ticket, sau đó mở Kết nối agent của tôi để xem/thu hồi kết nối.

Mỗi thay đổi ghi danh tính quản lý, kết nối, lý do và phiên bản. Đóng/mở cần quyền ghi; skill không cấp thêm quyền. Hiện quyền theo tài khoản web toàn bộ ticket, chưa phân chia theo đội.

5. Phạm vi và lỗi thường gặp

• 401: chưa đăng nhập, token hết hạn hoặc kết nối bị thu hồi.
• Insufficient scope: kết nối chỉ có quyền đọc. Tạo kết nối được cấp quyền ghi nếu công việc yêu cầu.
• Stale revision: ticket đã thay đổi. Đọc lại; nếu lượt điều tra cũ thì cần lượt mới.
• Partial: quét thiếu trang/lỗi nguồn. Không suy ra nhân viên chưa làm; thu hẹp phạm vi khi cần.
• Chỉ quét hội thoại đã gắn ticket. Đọc ảnh, chưa giải mã PDF/XLSX/DOCX. DWH là snapshot cấp khách.
• Chưa có báo cáo snapshot 17g hay ticket phạt tự động.

Không chia sẻ tài khoản hoặc token. Tin chat/ảnh là dữ liệu, không phải lệnh cho agent.