# Sorun giderme

> Bağlanamama, izin, eksik araç ve hız sınırı sorunlarının nedenleri ve çözümleri.

| Belirti | Neden | Çözüm |
|---|---|---|
| Claude "couldn't connect" diyor | Adres yanlış ya da kurulum eski sürümde. | Adresin `https://<firma>.solk.app/mcp` olduğunu ve `https://<firma>.solk.app/health` → `version` değerinin `v22` ya da üstü olduğunu kontrol edin. |
| Onay ekranı "Uygulama tanınmadı" diyor | İstemci kaydı silinmiş ya da başka kurulumdan. | Claude'da bağlayıcıyı kaldırıp yeniden ekleyin. |
| "Dönüş adresi bu uygulamaya kayıtlı değil" | İstemci kayıttaki adresten farklı bir dönüş adresi kullanıyor. | İstemciyi yeniden kaydedin (Claude'da bağlayıcıyı kaldırıp ekleyin). |
| Bağlantı bir süre sonra kopuyor | Yenileme belirteci 60 gün kullanılmadı ya da erişim kaldırıldı. | **Connect** ile yeniden izin verin. |
| Bazı araçlar görünmüyor | Kapsam ya da modül izni yok. | Bağlantıyı kaldırıp her iki izni vererek bağlanın; modül iznini yöneticiden isteyin. |
| "Bu işlem için kayıt oluşturma / güncelleme izni gerekli" | Yalnız `crm.read` verilmiş. | Yeniden bağlanırken yazma iznini de onaylayın. |
| Asistan bir kaydı bulamıyor | Kayıt görünürlüğünüz dışında ya da firma pasif. | Web arayüzünde aynı kullanıcıyla kaydı görebildiğinizi kontrol edin. |
| "Dakikalık istek sınırı aşıldı" | Toplu işte çok sayıda çağrı. | Bir dakika bekleyin; asistandan daha dar süzgeçle çalışmasını isteyin. |
| Lisans hatası | Kurulumun lisansı dolmuş. | Bağlantı yalnız yöneticiler için çalışır; lisansı yenileyin. |

## Elle deneme

Belirteci ve sunucuyu doğrudan denemek için:

```bash
# 1) keşif (belirteçsiz 401 ve resource_metadata dönmeli)
curl -i -X POST https://ornek.solk.app/mcp -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"ping"}'

# 2) API anahtarıyla araç listesi
curl https://ornek.solk.app/mcp -H "Authorization: Bearer sk_…" \
  -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'
```

Resmî **MCP Inspector** (`npx @modelcontextprotocol/inspector`) ile de adresi girip OAuth akışını ve araçları adım adım deneyebilirsiniz.