# 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.

> [!NOTE]
> Bağlantı, onu oluşturan yöneticinin görebildiği panolardan fazlasını göremez. Yönetici çalışma alanından ayrılır ya da yöneticilikten çıkarılırsa bağlantı kapanır.

## Bağlantı oluşturma

1. **Ayarlar > Bağlantılar** sayfasını açın.
2. **MCP bağlantısı oluştur** düğmesine basın.
3. **Ad** alanına bağlantıyı tanıyacağınız bir ad yazın, örneğin "Satış ekibi — Claude".
4. **Kapsam** ve **Geçerlilik** seçeneklerini belirleyin.
5. **Bağlantı oluştur** düğmesine basın.
6. 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.