Panduan

Integrasi Claude

Integrasi Claude

v1.11.0+

Integrasi Claude menambahkan ekstensi ke aplikasi desktop Claude (Windows, macOS) sehingga Anda dapat mengoperasikan GeckoFlag melalui percakapan dengan Claude. Anda dapat mencari, melihat, membuat, dan memperbarui isu, proyek, Wiki, dan Catatan, serta mengekspor Gantt Chart ke Excel. Ekstensi berjalan di PC pengguna dan berkomunikasi langsung hanya dengan GeckoFlag milik pengguna. Semua tindakan dijalankan dengan izin pengguna pemilik token API.

Pengaturan oleh Administrator

  1. 1Buka Pengaturan di menu samping, lalu klik Ubah pada kartu Integrasi Claude.Layar pengaturan. Kartu “Claude Integration” ditandai dengan bingkai merah
  2. 2Aktifkan Aktifkan Integrasi Claude (secara bawaan nonaktif). Jika Claude juga boleh membuat dan mengubah data, aktifkan juga Izinkan penulisan, lalu simpan. Jika penulisan tidak diizinkan, semua token menjadi hanya-baca.Layar pengaturan Integrasi Claude. Kotak centang “Enable Claude integration” dan “Allow writing” ditandai dengan bingkai merah, dengan jumlah pengguna yang diberi izin dan jumlah token API ditampilkan di bawahnya
  3. 3Di Pengguna, buka Ubah pada pengguna yang dituju, aktifkan Izinkan penggunaan Integrasi Claude (API), lalu klik Perbarui. Pengaturan ini terpisah dari “Izinkan pendaftaran berbantuan AI”. Jika izin dicabut, semua token API milik pengguna tersebut dihapus.Layar edit pengguna. “Users” di menu samping dan kotak centang “Allow Claude integration (API)” ditandai dengan bingkai merah

Membuat Token API

  1. 1Buka Profil di menu samping, lalu di bagian Token API, tentukan nama token, masa berlaku (30 hari, 90 hari, 365 hari, atau tanpa batas; bawaan 90 hari), dan izin (Hanya baca atau Baca dan tulis), lalu buat token.Bagian “API Tokens (Claude Integration)” di layar profil. Kolom Token name, Expires in, dan Permission ditandai dengan bingkai merah
  2. 2Salin token yang ditampilkan (string yang diawali gfk_). Token hanya ditampilkan sekali, tepat setelah dibuat. Catat juga “URL untuk dimasukkan ke ekstensi” yang ditampilkan di bagian yang sama.
  • Setiap orang dapat membuat hingga 5 token, dan token yang tidak dipakai lagi dapat dihapus kapan saja dari profil.
  • Saat token dibuat, pemiliknya menerima email pemberitahuan. Jika kata sandi diubah, semua token milik orang tersebut dihapus.

Mengatur Aplikasi Desktop Claude

  1. 1Di aplikasi desktop Claude, buka Settings (Pengaturan) → Extensions (Ekstensi), seret dan lepas file ekstensi GeckoFlag (.mcpb), lalu klik Install. Anda juga dapat memasangnya dengan mengklik dua kali file tersebut, atau melalui Advanced settings. File ekstensi disertakan dalam unduhan yang Anda terima setelah membeli GeckoFlag.
  2. 2Di layar pengaturan, isi item berikut lalu klik Save.
    • GeckoFlag URL (wajib): URL yang sudah Anda catat. Harus diawali https:// (http:// hanya untuk localhost, *.test, dan *.local).
    • API token (wajib): token yang Anda salin. Disimpan dalam bentuk tersamar.
    • Export folder (opsional): folder tujuan penyimpanan file Excel Gantt Chart. Jika dikosongkan, file disimpan di folder Unduhan.
    Layar pengaturan ekstensi GeckoFlag. Terdapat kolom GeckoFlag URL, API token, dan Export folder
  3. 3Minta Claude “Periksa apakah sudah terhubung ke GeckoFlag”. Jika pemilik token, versi GeckoFlag, dan apakah penulisan diizinkan ditampilkan, penyiapan selesai.

Langkah lengkap dengan tangkapan layar dapat dilihat di panduan penyiapan Integrasi Claude. Kami menyarankan agar tindakan penulisan diatur ke “selalu minta konfirmasi” di pengaturan ekstensi Claude.

Yang Dapat Dilakukan

  • Isu: mencari (berdasarkan proyek, status, penerima tugas, pembuat, prioritas, kata kunci, tanggal jatuh tempo, atau isu induk), melihat detail dan komentar, membuat (termasuk menentukan isu induk dan penerima notifikasi), mengubah kolom, mengirim komentar, dan mengubah status.
  • Proyek: melihat daftar dan detail, membuat (selain tamu), mengubah nama, deskripsi, pemilik, dan periode, menandai selesai/belum selesai, serta menambah dan menghapus anggota (pemilik dan administrator).
  • Wiki: melihat, menulis ulang judul dan isi, serta menambahkan teks di bagian akhir (anggota proyek dan administrator).
  • Catatan: melihat daftar, mencari, membaca, membuat, menulis ulang, dan menambahkan teks ke Catatan Anda sendiri.
  • Data master: menambah jenis isu, status, prioritas, dan jabatan (departemen), serta mengubah nama dan warnanya (administrator).
  • Gantt Chart: menyimpan isu proyek (maksimal 5.000) ke PC sebagai file Excel. Jika periode melebihi 120 hari, 1 kolom = 1 minggu.
  • Pencarian pengguna: mencari pengguna berdasarkan nama (hanya ID dan peran; alamat email tidak dikembalikan).

Isu dapat ditunjuk dengan kunci seperti “WEB-12”. Penulisan memerlukan token “Baca dan tulis” sekaligus “Izinkan penulisan” di tingkat situs.

Batasan dan Batas Maksimum

  • Tidak dapat menghapus (proyek, isu, komentar, data master, Wiki, Catatan), mengedit komentar, melampirkan atau melihat gambar dan file, mengubah kunci proyek, atau mengurutkan ulang data master.
  • Tidak dapat menambah atau mengedit pengguna, mengubah pengaturan situs, mengoperasikan Kanban, bookmark, atau pengaturan notifikasi, maupun melihat Catatan pengguna lain (termasuk administrator).
  • Penulisan dilakukan satu per satu. Untuk beberapa item, Claude menjalankannya satu per satu. Batas waktu respons adalah 30 detik, dan penulisan tidak dicoba ulang otomatis untuk mencegah data ganda.
  • Judul isu maksimal 50 karakter, dan nama data master maksimal 20 karakter (masing-masing hingga 10 item, dengan warna dari 8 pilihan). Isi Wiki maksimal 65.535 byte secara keseluruhan, dan isi Catatan maksimal 1.000.000 byte.
  • Teks yang dibaca Claude dipotong jika deskripsi, Wiki, atau Catatan melebihi 8.000 karakter, atau komentar melebihi 2.000 karakter. Teks yang terpotong tidak ditulis kembali; Claude akan menyarankan untuk menambahkan teks di akhir.
  • Pencarian dan daftar maksimal 50 item per halaman. Batas permintaan adalah 60 kali per menit per token.
  • Hanya dapat digunakan saat aplikasi desktop Claude sedang berjalan di PC.

Riwayat dan Email Notifikasi

  • Mengubah kolom isu, sama seperti mengedit di layar, tidak meninggalkan komentar riwayat dan tidak mengirim email. Jika ingin meninggalkan riwayat, minta “ubah melalui komentar”.
  • Mengubah status atau kolom lain melalui komentar akan menambahkan riwayat, sama seperti di layar, dan email dikirim ke anggota yang menerima notifikasi untuk semua komentar.
  • Saat isu dibuat, email hanya dikirim ke anggota yang ditentukan sebagai penerima notifikasi. Saat proyek dibuat, anggota menerima email undangan (tidak dikirim untuk anggota yang ditambahkan kemudian).
  • Tindakan dicatat sebagai tindakan pemilik token, tanpa tanda “melalui Claude”.

Keamanan dan Penanganan Data

Saat Integrasi Claude nonaktif, API diperlakukan sama seperti URL yang tidak ada (404). Proyek dan isu tanpa izin akses juga diperlakukan seolah “tidak ada”. Server hanya menyimpan hash token, dan pembatasan akses berdasarkan alamat IP di GeckoFlag juga berlaku untuk API. Isi isu, Wiki, dan Catatan yang dibaca Claude dikirim ke Anthropic sebagai bagian dari percakapan. Sebelum mulai menggunakan, pastikan aturan internal dan kontrak dengan klien tidak membatasi pengiriman informasi ke layanan eksternal. Jika koneksi gagal, lihat Jika ada kendala.