Entegrasyonlar

MCP bağlantısı

Claude, ChatGPT, Claude Code veya Cursor gibi kendi AI aracınızı çalışma alanınızdaki panolara salt okunur bağlayın.

Genel bakış

MCP, AI araçlarının dış veri kaynağına bağlanmasını sağlayan bir bağlantı biçimidir. Bir MCP bağlantısıyla Claude, ChatGPT, Claude Code ya da Cursor çalışma alanınızdaki panoları, kartları ve son hareketleri okuyabilir.

Bağlantı yalnız okur. Kart açamaz, taşıyamaz, yorum yazamaz ve hiçbir ayarı değiştiremez. Bu kural bağlantının kendisinde tanımlıdır.

Bağlantıyı yalnız yönetici oluşturur ve yönetir. Premium ve Enterprise planlarında kullanılabilir. Diğer planlarda Bağlantılar sayfasında yükseltme kartı görünür.

Bağlantı oluşturma

Ayarlar > Bağlantılar sayfasını açın.
MCP bağlantısı oluştur düğmesine basın.
Ad alanına bağlantıyı tanıyacağınız bir ad yazın, örneğin "Satış ekibi — Claude".
Kapsam ve Geçerlilik seçeneklerini belirleyin.
Bağlantı oluştur düğmesine basın.
Açılan panelde MCP sunucu adresi alanındaki bağlantıyı Linki kopyala ile kopyalayın.

Adres https://<uygulama adresi>/api/mcp/cwm_… biçimindedir. Panel kapandıktan sonra adres bir daha gösterilmez. Adresi kaybederseniz bağlantıyı yenileyin.

Kapsam ve geçerlilik

Kapsam aracın göreceği alanı belirler:

Görebildiğim tüm panolar: oluşturan yöneticinin gördüğü bütün panolar.
Tek şirket: seçtiğiniz şirketin panoları.
Seçili panolar: işaretlediğiniz panolar. En çok 50 pano seçilebilir.

Kapsam yalnız daraltır. Seçtiğiniz alan, yönetici olarak görebildiğiniz alanın dışına çıkamaz.

Geçerlilik bağlantının ne kadar çalışacağını belirler: 30 gün, 90 gün (varsayılan), 365 gün veya Süresiz. Süre dolunca adres çalışmaz. Yenilediğinizde yeni bir adres alırsınız.

Araca ekleme

Araç	Yapılacaklar
Claude (claude.ai)	Ayarlar > Bağlayıcılar > Özel bağlayıcı ekle. Uzak MCP sunucu adresine URL'yi yapıştırın. Kimlik doğrulama gerekmez.
ChatGPT	Ayarlar > Bağlayıcılar > Oluştur. MCP sunucu adresine URL'yi yapıştırın, kimlik doğrulamayı Yok seçin.
Claude Code	Terminalde `claude mcp add --transport http cloyk-works <URL>` komutunu çalıştırın.
Cursor ve diğer istemciler	MCP ayarlarına "Streamable HTTP" türünde sunucu ekleyin, adres olarak URL'yi verin. Başlık isteyen istemcide `Authorization: Bearer <URL'deki cwm_… anahtarı>` kullanın.

Bu adımlar aracın kendi arayüzündeki yollardır. Araç değiştirirse yeni sürümün adımlarını izleyin.

Araçların okuduğu veriler

Araç	Ne yapar
`list_scopes`	Bağlantının görebildiği panoları, şirketleri ve başlıkları (kimlik ve ad) listeler.
`get_overview`	Seçilen dönemin özetini verir: açık, geciken, engelli, yaklaşan, biten ve yeni kart sayıları.
`list_tasks`	Kartları süzerek listeler: açık, geciken, engelli, yakında biten, sorumlusuz, biten ya da tümü.
`recent_activity`	Dönemdeki hareketleri ve yorumları listeler.
`search`	Kart, yorum ve duyurularda metin arar.
`blocking_chains`	Bağımlılık zincirlerini gösterir: hangi işin hangisini engellediği.

Rol modu açıksa kişi adı yerine rol başlığı döner. Araç kapsam dışındaki bir panoyu isterse yanıt alamaz.

Bağlantıyı yönetme

Bağlantı listesinde her bağlantının adı, kapsamı, durumu (Aktif, Süresi doldu ya da İptal edildi), son kullanımı ve oluşturanı görünür.

Yenile: Eski adres hemen geçersiz olur. Yeni adres bir kez gösterilir. Adres sızdıysa önce bunu yapın.
İptal et: Bağlantı kalıcı olarak kapanır. Aynı adresle yeniden bağlanılamaz.

Her iki işlem de satır içinde onay ister. Oluşturma, yenileme ve iptal denetim kaydına Güvenlik kategorisiyle düşer.

Sık sorulanlar

Bağlantı çalışmıyor, ne yapmalıyım?

401 hatası: Adres yanlış, iptal edilmiş ya da süresi dolmuş olabilir. Bağlantıyı oluşturan kişi artık yönetici değilse de bu hata görünür. Yeni bir bağlantı oluşturun.
429 hatası: Dakikadaki istek sınırına ulaşıldı. Bir dakika bekleyip tekrar deneyin.
scope_not_allowed: Araç kapsam dışındaki bir pano istedi. list_scopes ile izin verilen panoların listesini alın.
Plan düşürüldüyse mevcut bağlantılar da çalışmaz.

Adresi bilen herkes verileri okuyabilir mi?

Evet. Adres bir şifre gibidir. Kapsam içindeki verileri adresi bilen herkes okuyabilir. Adresi paylaşmayın, sızdığını düşünürseniz hemen Yenile ya da İptal et işlemini yapın.

Yönetici olmayan bir üye bağlantı oluşturabilir mi?

Hayır. Bağlantılar sekmesi yalnız yönetici ve sahip için görünür.