Claude Entegrasyonu
v1.11.0+Claude Entegrasyonu, Claude masaüstü uygulamasına (Windows, macOS) bir uzantı ekleyerek GeckoFlag’i Claude ile sohbet ederek kullanmanızı sağlayan bir özelliktir. Görevleri, projeleri, wiki sayfalarını ve notları arayabilir, görüntüleyebilir, oluşturabilir ve güncelleyebilir; Gantt şemasını Excel’e aktarabilirsiniz. Uzantı kullanıcının bilgisayarında çalışır ve yalnızca kullanıcının GeckoFlag kurulumuyla doğrudan iletişim kurar. Tüm işlemler, API belirtecinin sahibinin kullanıcı yetkileriyle yapılır.
Yönetici ayarları
- 1Kenar menüsünden Ayarlar sayfasını açın ve Claude Entegrasyonu kartındaki Düzenle düğmesine tıklayın.

- 2Claude Entegrasyonunu etkinleştir seçeneğini açın (varsayılan olarak devre dışıdır). Claude’un oluşturma ve değiştirme de yapmasını istiyorsanız Yazmaya izin ver seçeneğini de açıp kaydedin. Yazmaya izin verilmezse tüm belirteçler salt okunur olur.

- 3Kullanıcılar sayfasında ilgili kullanıcı için Düzenle’yi açın, Claude Entegrasyonu (API) kullanımına izin ver seçeneğini açın ve Güncelle düğmesine tıklayın. Bu, “Yapay zekâ destekli kayda izin ver” ayarından ayrıdır. İzin kaldırıldığında kullanıcının tüm API belirteçleri silinir.

API belirteci oluşturma
- 1Kenar menüsünden Profil sayfasını açın; API Belirteçleri bölümünde belirteç adını, geçerlilik süresini (30 gün, 90 gün, 365 gün veya süresiz; varsayılan 90 gün) ve yetkiyi (Salt okunur veya Okuma ve yazma) belirleyerek bir belirteç oluşturun.

- 2Gösterilen belirteci (gfk_ ile başlayan dize) kopyalayın. Belirteç yalnızca oluşturulduktan hemen sonra bir kez gösterilir. Aynı bölümde gösterilen “Uzantıya girilecek URL”yi de not edin.
- Kişi başına en fazla 5 belirteç oluşturulabilir; artık kullanılmayanlar profil sayfasından istenildiği zaman silinebilir.
- Belirteç oluşturulduğunda sahibine bir bildirim e-postası gönderilir. Parola değiştirildiğinde o kişinin tüm belirteçleri silinir.
Claude masaüstü uygulamasında ayarlama
- 1Claude masaüstü uygulamasında Settings (Ayarlar) → Extensions (Uzantılar) bölümünü açın, GeckoFlag uzantı dosyasını (.mcpb) sürükleyip bırakın ve Install (Yükle) düğmesine tıklayın. Dosyaya çift tıklayarak veya Advanced settings (Gelişmiş ayarlar) üzerinden de yükleyebilirsiniz. Uzantı dosyası, GeckoFlag’i satın aldıktan sonra indirdiğiniz dosyada bulunur.
- 2Ayarlar ekranında aşağıdaki alanları doldurun ve Save (Kaydet) düğmesine tıklayın.
- GeckoFlag URL (zorunlu): Not ettiğiniz URL. https:// gereklidir (http:// yalnızca localhost, *.test ve *.local için kullanılabilir).
- API token (zorunlu): Kopyaladığınız belirteç. Maskelenmiş olarak kaydedilir.
- Export folder (isteğe bağlı): Gantt şeması Excel dosyalarının kaydedileceği klasör. Boş bırakılırsa İndirilenler klasörüne kaydedilir.

- 3Claude’a “GeckoFlag’e bağlanabildiğini kontrol et” deyin. Belirteç sahibi, GeckoFlag sürümü ve yazma izni olup olmadığı gösterilirse kurulum tamamlanmıştır.
Ekran görüntüleriyle ayrıntılı adımlar için Claude Entegrasyonu kurulum kılavuzuna bakın. Yazma işlemlerini Claude’un uzantı ayarlarında “her seferinde sor” olarak ayarlamanızı öneririz.
Yapılabilenler
- Görevler: Arama (proje, durum, atanan kişi, oluşturan, öncelik, anahtar kelime, bitiş tarihi, üst görev), ayrıntıları ve yorumları görüntüleme, oluşturma (üst görev ve bildirim alacak kişiler de belirtilebilir), alanları değiştirme, yorum ekleme, durumu değiştirme.
- Projeler: Listeyi ve ayrıntıları görüntüleme, oluşturma (misafirler hariç), ad, açıklama, sahip ve tarih aralığını değiştirme ve tamamlandı/tamamlanmadı olarak işaretleme, üye ekleme ve çıkarma (sahip ve yöneticiler).
- Wiki: Görüntüleme, başlığı ve içeriği yeniden yazma, sonuna ekleme (proje üyeleri ve yöneticiler).
- Notlar: Kendi notlarınızı listeleme, arama, görüntüleme, oluşturma, yeniden yazma ve sonlarına ekleme.
- Ana veriler: Görev türü, durum, öncelik ve unvan (departman) ekleme; adlarını ve renklerini değiştirme (yöneticiler).
- Gantt şeması: Projenin görevlerini (en fazla 5.000) bir Excel dosyası olarak bilgisayara kaydetme. Tarih aralığı 120 günü aşarsa 1 sütun = 1 hafta olur.
- Kullanıcı arama: Kullanıcıları ada göre bulma (yalnızca kimlik ve rol; e-posta adresleri döndürülmez).
Görevler “WEB-12” gibi anahtarlarla belirtilebilir. Yazma için hem “Okuma ve yazma” belirteci hem de sitenin “Yazmaya izin ver” ayarı gerekir.
Yapılamayanlar ve sınırlar
- Silme (proje, görev, yorum, ana veri, wiki, not), yorum düzenleme, görsel/dosya ekleme ve görüntüleme, proje anahtarını değiştirme ve ana verileri yeniden sıralama yapılamaz.
- Kullanıcı ekleme ve düzenleme, site ayarlarını değiştirme, Kanban, yer imi ve bildirim ayarlarıyla ilgili işlemler ve diğer kullanıcıların notlarını görüntüleme (yöneticiler dahil) yapılamaz.
- Her seferinde tek bir yazma işlemi yapılır. Birden fazla işlemi Claude sırayla tek tek uygular. Yanıt için 30 saniye beklenir; çift kayıt oluşmaması için yazma işlemleri otomatik olarak yeniden denenmez.
- Görev başlıkları en fazla 50 karakter, ana veri adları en fazla 20 karakterdir (her biri için en fazla 10 kayıt; renkler 8 renk arasından seçilir). Wiki içeriği toplam 65.535 bayt, not içeriği 1.000.000 bayt ile sınırlıdır.
- Claude’un okuduğu içerik; açıklama, wiki ve notlarda 8.000 karakteri, yorumlarda 2.000 karakteri aşarsa kısaltılır. Kısaltılmış içerik geri yazılmaz; bunun yerine sonuna ekleme önerilir.
- Arama ve listeler sayfa başına en fazla 50 sonuç döndürür. İstek sınırı belirteç başına dakikada 60’tır.
- Yalnızca Claude masaüstü uygulaması bilgisayarda açıkken kullanılabilir.
Geçmiş ve bildirim e-postaları
- Görev alanlarının değiştirilmesi, ekrandan düzenlemede olduğu gibi geçmiş yorumu oluşturmaz ve e-posta göndermez. Geçmiş kaydı istiyorsanız “bunu yorum olarak değiştir” deyin.
- Yorumla durum vb. değiştirildiğinde, ekranda olduğu gibi geçmiş kaydı eklenir ve tüm yorumlar için bildirim alan üyelere e-posta gönderilir.
- Görev oluşturulduğunda yalnızca bildirim alacak kişi olarak belirtilen üyelere e-posta gönderilir. Proje oluşturulduğunda üyelere davet e-postası gönderilir (sonradan eklenen üyelere gönderilmez).
- İşlemler belirteç sahibinin işlemleri olarak kaydedilir; “Claude üzerinden” gibi bir gösterge yoktur.
Güvenlik ve verilerin işlenmesi
Claude Entegrasyonu devre dışıyken API, var olmayan bir URL gibi davranır (404). Yetkiniz olmayan projeler ve görevler de “yok” olarak değerlendirilir. Sunucuda belirteçlerin yalnızca karma değerleri saklanır ve GeckoFlag’in IP adresine göre erişim kısıtlaması API için de geçerlidir. Claude’un okuduğu görev, wiki ve not içerikleri sohbetin bir parçası olarak Anthropic’e gönderilir. Şirket politikalarınızın veya müşterilerinizle yaptığınız sözleşmelerin dış hizmetlere veri gönderilmesini kısıtlayıp kısıtlamadığını kullanmaya başlamadan önce kontrol edin. Bağlantı sorunları için Sorun yaşarsanız bölümüne bakın.