Hướng dẫn

Tích hợp Claude là tính năng thêm một tiện ích mở rộng vào ứng dụng Claude trên máy tính (Windows, macOS) để bạn điều khiển GeckoFlag từ cuộc trò chuyện với Claude. Bạn có thể tìm, xem, tạo và cập nhật vấn đề, dự án, Wiki và ghi chú, cũng như xuất biểu đồ Gantt ra Excel. Tiện ích mở rộng chạy trên máy tính của người dùng và chỉ giao tiếp trực tiếp với GeckoFlag của bạn. Mọi thao tác đều được thực hiện bằng quyền của người dùng sở hữu token API.

Cài đặt của quản trị viên

1. 1Mở Cài đặt ở thanh bên, rồi nhấp Sửa trên thẻ Tích hợp Claude.
2. 2Đánh dấu Bật tích hợp Claude (mặc định là tắt). Nếu muốn Claude cũng tạo và thay đổi dữ liệu, hãy bật thêm Cho phép ghi rồi lưu. Nếu không cho phép ghi, mọi token đều chỉ có quyền đọc.
3. 3Trong Người dùng, mở Sửa ở người dùng cần cấp, bật Cho phép dùng Tích hợp Claude (API) rồi nhấp Cập nhật. Đây là thiết lập riêng, khác với “Cho phép đăng ký với sự hỗ trợ của AI”. Khi gỡ quyền, mọi token API của người dùng đó sẽ bị xóa.

Tạo token API

1. 1Mở Hồ sơ ở thanh bên, trong phần Token API, chỉ định tên token, thời hạn (30 ngày, 90 ngày, 365 ngày hoặc không giới hạn; mặc định 90 ngày) và quyền (Chỉ đọc hoặc Đọc và ghi), rồi tạo token.
2. 2Sao chép token hiển thị (chuỗi bắt đầu bằng gfk_). Token chỉ hiển thị một lần ngay sau khi tạo. Hãy ghi lại cả “URL nhập vào tiện ích mở rộng” hiển thị trong cùng phần đó.

• Mỗi người có thể tạo tối đa 5 token, và có thể xóa token không dùng nữa bất cứ lúc nào từ hồ sơ.
• Khi tạo token, người dùng sẽ nhận được email thông báo. Khi đổi mật khẩu, mọi token của người đó sẽ bị xóa.

Cấu hình ứng dụng Claude trên máy tính

1. 1Trong ứng dụng Claude trên máy tính, mở Settings (Cài đặt) → Extensions (Tiện ích mở rộng), kéo thả tệp tiện ích mở rộng GeckoFlag (.mcpb) vào rồi nhấp Install. Bạn cũng có thể cài đặt bằng cách nhấp đúp vào tệp hoặc từ Advanced settings. Tệp tiện ích mở rộng có trong gói tải xuống bạn nhận được sau khi mua GeckoFlag.
2. 2Trên màn hình cấu hình, nhập các mục sau rồi nhấp Save.
   • GeckoFlag URL (bắt buộc): URL đã ghi lại. Cần dùng https:// (http:// chỉ được dùng cho localhost, *.test, *.local).
   • API token (bắt buộc): token đã sao chép. Token được lưu dưới dạng che.
   • Export folder (tùy chọn): nơi lưu tệp Excel biểu đồ Gantt. Nếu để trống, tệp được lưu vào thư mục Tải xuống.
   
3. 3Nhờ Claude: “Kiểm tra xem đã kết nối được với GeckoFlag chưa”. Nếu Claude hiển thị chủ sở hữu token, phiên bản GeckoFlag và việc có thể ghi hay không, quá trình thiết lập đã hoàn tất.

Các bước chi tiết kèm ảnh chụp màn hình có trong Tích hợp Claude: hướng dẫn thiết lập. Chúng tôi khuyên bạn đặt các thao tác ghi thành “luôn hỏi” trong cài đặt tiện ích mở rộng của Claude.

Những gì có thể làm

• Vấn đề: tìm kiếm (theo dự án, trạng thái, người thực hiện, người tạo, mức độ ưu tiên, từ khóa, hạn chót, vấn đề cha), xem chi tiết và bình luận, tạo mới (có thể chỉ định vấn đề cha và người nhận thông báo), thay đổi các mục, đăng bình luận, đổi trạng thái.
• Dự án: xem danh sách và chi tiết, tạo mới (trừ khách), thay đổi tên, mô tả, chủ sở hữu, thời gian và chuyển trạng thái hoàn thành/chưa hoàn thành, thêm và gỡ thành viên (chủ sở hữu, quản trị viên).
• Wiki: xem, viết lại tiêu đề và nội dung, bổ sung vào cuối trang (thành viên dự án, quản trị viên).
• Ghi chú: xem danh sách, tìm kiếm, xem, tạo, viết lại và bổ sung ghi chú của chính bạn.
• Dữ liệu chủ: thêm loại vấn đề, trạng thái, mức độ ưu tiên, chức danh (phòng ban) và thay đổi tên, màu (quản trị viên).
• Biểu đồ Gantt: lưu các vấn đề của dự án (tối đa 5.000) thành tệp Excel vào máy tính. Nếu khoảng thời gian dài hơn 120 ngày, mỗi cột sẽ là 1 tuần.
• Tìm người dùng: tìm người dùng theo tên (chỉ trả về ID và vai trò, không trả về địa chỉ email).

Bạn có thể chỉ định vấn đề bằng mã như “WEB-12”. Để ghi dữ liệu, cần có cả token “Đọc và ghi” lẫn thiết lập “Cho phép ghi” của trang.