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