İçeriğe geç

Muhakeme İçtihat sorun giderme

Muhakeme İçtihat’ta karşılaşabileceğiniz sorunlar konu konu aşağıda. Her kartta belirti, varsa uygulamanın gösterdiği ileti, olası neden ve çözüm adımları yer alır.

Ekranda gördüğünüz iletiyi tarayıcınızın sayfa içi aramasıyla (Ctrl+F, macOS’ta Cmd+F) bu sayfada arayabilirsiniz.

Kurulum ve açılış

Kurulum programı, uygulama penceresi ve uygulamanın bilgisayarınızda çalışan yerel sunucusuyla ilgili sorunlar.

Kurulum programı bu bilgisayarda çalışmıyor

Olası neden

Windows paketi yalnız x64 uyumlu 64 bit Windows içindir; 32 bit Windows’a kurulmaz. macOS paketi yalnız Apple Silicon işlemcili Mac’ler (M1 ve sonrası) ve macOS 14 ya da sonrası içindir.

Çözüm
  1. Bilgisayarınızın 64 bit Windows ya da Apple Silicon işlemcili bir Mac olduğunu denetleyin.
  2. Windows’ta kurulum yönetici izni istemez; uygulama kullanıcı klasörüne kurulur (varsayılan: %LOCALAPPDATA%\Programs\MuhakemeIctihat). Kurulumu yönetici hesabıyla başlatmanız gerekmez.
  3. Ayrıntılı liste için sistem gereksinimleri sayfasına bakın.

Windows kurulum dosyasını açarken bir güvenlik uyarısı gösteriyor

Olası neden

Windows, internetten indirilen bazı dosyalar için açmadan önce ek onay isteyebilir. Muhakeme İçtihat’ın kurulum dosyası IOT INN BİLİŞİM TİCARET ANONİM ŞİRKETİ adına kod imzalıdır ve imza zaman damgası taşır.

Çözüm
  1. Kurulum dosyasını yalnız muhakeme.ai’den indirdiğinizden emin olun. Başka bir yerden gelen kurulum dosyasını çalıştırmayın.
  2. Güvenlik onayı adımı Windows kurulum rehberinde anlatılır.
  3. Dosyanın nereden geldiğinden emin değilseniz kurmayın ve destek adresine yazın.

Kurulum ya da kaldırma, uygulamanın açık olduğunu söyleyen bir uyarıyla duruyor

Olası neden

Windows’ta Muhakeme İçtihat açıkken kurulum programı ve kaldırıcı, uygulama kapanana kadar bekler. Uyarı Tamam ve İptal düğmeli bir kutudur. Uygulama içinden yapılan güncellemede bu uyarı çıkmaz: kurulum uygulamayı kendisi kapatır ve sonunda yeniden başlatır.

Çözüm
  1. Muhakeme İçtihat penceresini kapatın.
  2. Uyarıda Tamam’a basın; kurulum ya da kaldırma sürer.
  3. İptal işlemi bitirir; bu durumda kurulumu ya da kaldırmayı yeniden başlatın.

Uygulama kendi penceresi yerine tarayıcı sekmesinde açılıyor

Olası neden

Uygulamanın penceresi, bilgisayardaki bir tarayıcının uygulama penceresi kipiyle açılır. Windows’ta yalnız Microsoft Edge ve Google Chrome aranır ve ikisi de yalnız C:\Program Files ile C:\Program Files (x86) altında aranır. Yalnız kendi kullanıcınız için kurulan Chrome (%LOCALAPPDATA%\Google\Chrome) bulunmaz. macOS’ta Google Chrome, Microsoft Edge, Brave Browser ve Chromium sırayla /Applications ve ~/Applications altında aranır.

Uygun tarayıcı bulunamazsa uygulama varsayılan tarayıcınızın normal sekmesinde açılır.

Çözüm
  1. Windows’ta Microsoft Edge ya da Google Chrome’un C:\Program Files ya da C:\Program Files (x86) altında kurulu olduğunu denetleyin.
  2. macOS’ta Google Chrome, Microsoft Edge, Brave Browser ya da Chromium’dan birinin Applications klasöründe olduğunu denetleyin.
  3. Muhakeme İçtihat’ı kapatıp yeniden açın.

Pencerede “Sunucuya ulaşılamıyor” yazıyor

Uygulamada görünen ileti

Uygulama sunucusuna ulaşılamıyor — uygulama kapanmış olabilir. Uygulamayı yeniden açın; bu sekme eski kalmışsa kapatabilirsiniz.
Olası neden

Uygulama, bilgisayarınızda çalışan yerel bir sunucu ile bu sunucuyu gösteren bir pencereden oluşur. Pencere sunucuya art arda ulaşamazsa uygulama kapanmış ya da durmuş olabilir. Başlıktaki durum rozeti de Sunucuya ulaşılamıyor der.

Çözüm
  1. Açık kalan eski pencereyi ya da sekmeyi kapatın.
  2. Muhakeme İçtihat’ı yeniden açın: Windows’ta Başlat menüsündeki Muhakeme İçtihat kısayoluyla, macOS’ta Applications klasöründen.

Konulara dön

Giriş ve lisans

Giriş, muhakeme.ai hesabınızla ve e-postanıza gelen tek kullanımlık kodla yapılır. Deneme süresi ve koşulları Deneme Koşulları, kullanım koşulları Kullanım Koşulları sayfasında düzenlenir.

Giriş kodu gelmedi ya da “Çok sık denendi” iletisi çıkıyor

Uygulamada görünen ileti

Çok sık denendi — lütfen bir dakika bekleyip yeniden isteyin.
Olası neden

Giriş iki adımdır. E-posta adımında adresinizi yazıp Kod gönder’e basarsınız; kod gönderilince kod adımı açılır. Kod adımında yalnız kod alanı, Giriş yap ve ← Farklı e-posta ile dene bulunur; yeni kod bu adımdan istenemez.

Kod isteği 60 saniyede en çok 3 kez yapılabilir; sınır aşılınca bu ileti e-posta adımında çıkar. Gönderilen kod 6 hanelidir ve 5 dakika geçerlidir.

Çözüm
  1. “Çok sık denendi” iletisi e-posta adımında çıkar: bir dakika bekleyin, sonra Kod gönder’e yeniden basın.
  2. Kod gelmediyse kod adımındasınız: ← Farklı e-posta ile dene ile e-posta adımına dönün, adresinizi denetleyip Kod gönder’e basın.
  3. Gelen kutunuzda “Muhakeme giriş kodunuz” konulu iletiyi arayın.
  4. Hesabınız yoksa giriş ekranındaki Hesabınız yok mu? muhakeme.ai üzerinden ücretsiz oluşturun bağlantısıyla hesap oluşturun.

Giriş kodu kabul edilmiyor

Uygulamada görünen ileti

Kod doğrulanamadı. Kodu ve e-postayı kontrol edin.
Olası neden
Kod yanlış yazılmış, 5 dakikalık süresi dolmuş ya da bir kod için tanınan 3 deneme hakkı bitmiş olabilir.
Çözüm
  1. E-postadaki 6 haneli kodu eksiksiz yazın.
  2. Süre dolduysa ya da deneme hakkı bittiyse ← Farklı e-posta ile dene ile e-posta adımına dönün ve Kod gönder ile yeni kod isteyin.

Girişte “Sunucuya ulaşılamadı” iletisi çıkıyor

Uygulamada görünen ileti

Sunucuya ulaşılamadı. İnternet bağlantınızı kontrol edin.
Olası neden

Giriş, lisans ve sözleşme işlemleri www.muhakeme.ai adresine bağlanır. Bilgisayar internete bağlı değilse ya da ağınız bu adrese erişimi engelliyorsa bu ileti çıkar. İleti kod isterken de kodu doğrularken de çıkabilir.

Çözüm
  1. İnternet bağlantınızı denetleyin.
  2. Kurumsal bir ağdaysanız ağ yöneticinizden www.muhakeme.ai adresine erişim isteyin.
  3. Bağlantı gelince bulunduğunuz adımın düğmesine yeniden basın: e-posta adımında Kod gönder, kod adımında Giriş yap.

Profil kartında “çevrimdışı” rozeti görünüyor

Olası neden

Uygulama lisansınızı şu anda muhakeme.ai’de doğrulayamıyor ve son başarılı doğrulamayla çalışıyor. Lisans, son başarılı doğrulamadan sonra 7 gün boyunca internet olmadan da bu bilgisayarda geçerli sayılır. Bu süre aşılırsa lisansın internete bağlanarak yeniden doğrulanması gerekir.

Bilgisayarın saati son görülen zamandan 24 saatten fazla geri alındıysa kayıtlı lisans bilgisi kabul edilmez.

Çözüm
  1. Bilgisayarınızı internete bağlayın.
  2. Muhakeme İçtihat’ı kapatıp yeniden açın; lisans çevrimiçi yeniden doğrulanır.
  3. Bilgisayarın tarih ve saatinin doğru olduğunu denetleyin.
  4. Kurumsal bir ağdaysanız ağ yöneticinizden www.muhakeme.ai adresine erişim isteyin.
Çözüldüğünü nasıl anlarsınız?
Sol alttaki profil kartında çevrimdışı rozeti kalkar.

“Deneme henüz başlamadı” ekranı açılıyor

Ekranın başlığı

Deneme henüz başlamadı
Olası neden
Giriş yaptığınız hesapta Muhakeme İçtihat için etkin bir deneme ya da plan bulunmuyor.
Çözüm
  1. Doğru hesapla giriş yaptığınızı denetleyin. Başka bir hesaba geçmek için ekrandaki Farklı hesapla giriş yap düğmesini kullanın.
  2. Profil menüsündeki Hesabım ↗ ile muhakeme.ai üye panelinde hesabınızın durumuna bakın.
  3. Planları ekrandaki Planları görüntüle ↗ bağlantısıyla inceleyin.
  4. Deneme koşulları için Deneme Koşulları sayfasına bakın.

Sözleşme penceresi kapanmıyor ya da onayınız kaydedilemiyor

Uygulamada görünen ileti

Sözleşme metni güncellendi ve onayınız kaydedilemedi. Sözleşmeyi muhakeme.ai üye panelinizden onaylayabilirsiniz.
Olası neden

Girişten sonra Kullanım Sözleşmesi ve Deneme Sözleşmesi tek düğmeyle kabul edilir; kabul eksikken pencere kapatılamaz. Kabul, muhakeme.ai hesabınıza kaydedilir.

Sözleşme metni güncellenmişse uygulama kabulü güncel metin için bir kez daha dener. Yine kaydedemezse bu ileti çıkar.

Çözüm
  1. muhakeme.ai’de üye panelinize girip sözleşmeyi orada onaylayın.
  2. Muhakeme İçtihat’ı kapatıp yeniden açın.
  3. İleti oturumun düştüğünü söylüyorsa uygulamada yeniden giriş yapın.
  4. Bilgisayar çevrimdışıyken verdiğiniz kabul kuyruğa alınır ve bağlantı gelince iletilir; bu durumda ayrıca bir şey yapmanız gerekmez.
  5. Sözleşme metinleri Kullanım Koşulları ve Deneme Koşulları sayfalarındadır.

Konulara dön

Yerel model

Yerel model bilgisayarınızda çalışır; ayarları Ayarlar → Model bölümündedir. Kurulum sihirbazını atladıysanız Ayarlar → Genel bölümündeki Kurulum sihirbazını yeniden çalıştır ile açabilirsiniz.

Karar Ara ya da Mevzuat Ara’ya yazdığım soru aranmıyor, liste boş kalıyor

Uygulamada görünen ileti

Bilgisayarda kullanılabilir GGUF model bulunamadı. Model klasörünüzü ekleyin.
Olası neden

Karar Ara ve Mevzuat Ara’da aramayı yapay zekâ hazırlar. Bilgisayarınızda kullanılabilir bir yerel model yoksa ve API anahtarıyla eklenmiş bir bağlantı da seçili değilse soru aranmaz; Karar Listesi ya da Mevzuat Listesi boş kalır. Başlıktaki durum rozeti Yerel model yok der.

Yapay zekâ kurmadan da açılış ekranındaki kararları açıp tam metnini okuyabilirsiniz.

Çözüm
  1. Modeliniz bilgisayarınızda başka bir klasördeyse Ayarlar → Model → Gelişmiş bölümünde Klasör seç… ya da Model dosyası seç… ile gösterin, sonra Yeniden tara’ya basın.
  2. Model yoksa Ayarlar → Genel bölümündeki Kurulum sihirbazını yeniden çalıştır ile sihirbazı açın ya da Ayarlar → Model → İndirilebilir modeller bölümünden bir model indirin.
  3. Yerel model kurmak istemiyorsanız Ayarlar → Bağlantılar bölümünde API anahtarıyla bir bağlantı ekleyin ve model menüsünden seçin. Aboneliğinizle grubundaki Claude Code, Codex ve ZCode bu iki sekmede arama yapmaz.

Sohbette yerel model katmanının kapatıldığı söyleniyor

Uygulamada görünen ileti

Yerel model katmanı Ayarlar'dan kapatılmış.
Olası neden

Ayarlar → Model → Sohbet modeli bölümündeki Yerel model katmanı anahtarı kapalıysa bu bilgisayardaki modeller hiç kullanılmaz ve açılışta da yüklenmez. Bölümün durum satırında “Yerel model kapalı. Aşağıdaki anahtarla açabilirsiniz.” yazar.

Çözüm
  1. Ayarlar → Model → Sohbet modeli bölümünde Yerel model katmanı anahtarını açın.
  2. Sorunuzu yeniden gönderin.
  3. Yerel model kullanmak istemiyorsanız model menüsünden API anahtarıyla eklenmiş bir bağlantı seçin.
Çözüldüğünü nasıl anlarsınız?
Durum satırındaki “Yerel model kapalı.” cümlesi kalkar; yerine modelin ya da motorun durumu yazılır.

Bilgisayarımdaki model listede görünmüyor

Uygulamada görünen ileti

Bilgisayarınızda kullanılabilir model yok. İndirilebilir modeller bölümünden bir tane indirin ya da modelleriniz başka bir klasördeyse Gelişmiş'ten gösterin.
Olası neden

Uygulama, Ollama, LM Studio ve Hugging Face önbelleğiyle indirilmiş GGUF modellerini bilinen konumlarda bulur ve yeniden indirmeden yerinde kullanır. İndirilenler, Masaüstü ve Belgeler klasörlerine de bakar; bu üç klasör yalnız iki alt klasör derinliğine kadar ve kısa süreyle taranır. Model daha derindeyse ya da başka bir klasördeyse bulunmaz.

OneDrive’da “yalnız çevrimiçi” ya da iCloud’da “Mac depolama alanını optimize et” ile bulutta tutulan dosyalar indirilmeden atlanır. macOS bu üç klasöre ilk erişimde izin ister; izin verilmezse tarama sonuçsuz kalır. OCR, reranker ve ses modelleri sohbet listesine alınmaz.

Çözüm
  1. Ayarlar → Model → Gelişmiş bölümünde Klasör seç… ya da Model dosyası seç… ile modelin yerini gösterin, sonra Yeniden tara’ya basın.
  2. Model yine görünmüyorsa aynı bölümdeki Tüm sürücüleri tara ile bütün sürücüleri taratın; tarama bir dakika kadar sürebilir.
  3. macOS’ta klasör izni istendiğinde izin verin. İzni reddettiyseniz modelin klasörünü Klasör seç… ile gösterin.
  4. Model dosyası bulutta tutuluyorsa önce bilgisayarınıza indirin, sonra yeniden taratın.
Çözüldüğünü nasıl anlarsınız?
Ayarlar → Model → Sohbet modeli bölümünde model listelenir ve durum satırı modelin hazır olduğunu söyler.

Model kartında “Sığmaz” ya da “Yavaş çalışır” yazıyor, yanıtlar yavaş geliyor

Model kartındaki not

Bir bölümü işlemcide çalışır; yanıtlar yavaşlar.
Olası neden

Kart rozeti, modelin bu bilgisayarın o anki boş belleğiyle nasıl çalışacağını gösterir. Yavaş çalışır: model ekran kartının belleğine tam sığmaz, bir bölümü işlemcide çalışır. Sığmaz: model bu bilgisayarda açılmayabilir; bilerek seçebilirsiniz, ama bellek yetmezse model hiç başlatılmaz.

Önerilen rozeti, ekran kartı belleği 8 GB ve üzerindeyse bu bilgisayarda açılabilen kartların en büyüğüne verilir; bu kart da yavaş çalışabilir. Ekran kartı yoksa ya da belleği 8 GB’ın altındaysa rozet sihirbazın kuralını izler.

Çözüm
  1. Daha hızlı yanıt için daha küçük bir model seçin.
  2. Açık uygulamaları kapatıp belleği boşaltın; rozet o anki boş belleğe göre hesaplanır.
  3. Model 30 dakika kullanılmayınca bellekten boşaltılır ve sonraki ilk soruda yeniden yüklenir; bu ilk yanıt daha geç gelebilir.

Yerel model motoru kurulamadı ya da çalıştırılamadı

Uygulamada görünen ileti

Motor çalıştırılamadı; güvenlik yazılımı motor dosyasını engellemiş olabilir. Yerel model klasörünü güvenlik yazılımının izin listesine ekleyip yeniden deneyin.
Olası neden

Yerel modelleri çalıştıran motor (llama.cpp) GitHub’dan indirilir, açılır ve sürümü denetlenir. Güvenlik yazılımı motor dosyasını ya da dosyaların taşınmasını engellerse kurulum tamamlanmaz.

Çözüm
  1. Yerel model klasörünü güvenlik yazılımınızın izin listesine ekleyin: Windows’ta %LOCALAPPDATA%\Muhakeme\yerel-model, macOS’ta ~/Library/Application Support/Muhakeme/yerel-model.
  2. Yeniden dene’ye basın.
  3. Motor kurulu görünmüyorsa Ayarlar → Model → Motor bölümündeki Motoru indir ile yeniden indirin.
  4. İleti motor sürümünün doğrulanamadığını söylüyorsa motoru yeniden indirin.

Model ya da motor indirmesi yarıda kaldı

Uygulamada görünen ileti

Kaynağa ulaşılamıyor; bağlantınızı denetleyip yeniden deneyin.
Olası neden

İndirmeler yalnız github.com (motor) ve huggingface.co (modeller) adreslerinden başlar ve bu sitelerin indirme adreslerine yönlendirilebilir. Bağlantı koparsa uygulama birkaç kez kendisi yeniden dener; inen kısım saklanır.

İlk kurulum tamamlanmadıysa, kurulum sihirbazında yarım kalan indirme uygulamayı yeniden açtığınızda aynı seçimle kaldığı yerden sürer.

Çözüm
  1. İnternet bağlantınızı denetleyin. Kurumsal ağdaysanız indirme adreslerine erişim olduğunu ağ yöneticinize sorun; adresler kurumsal ağ kartında yazılıdır.
  2. Yeniden dene ya da duraklatılmış indirmede Devam et’e basın; indirme kaldığı yerden sürer.

İndirme disk alanı yetmediği için durdu

Uygulamada görünen ileti

Disk doldu; yer açtıktan sonra indirmeye kaldığı yerden devam edebilirsiniz.
Olası neden

Uygulama indirmeye başlamadan önce diskte yer olup olmadığını denetler; yer yetmiyorsa işi başlatmaz. İndirme sürerken disk dolarsa iş durur, inen kısım saklanır. Kurulum sihirbazının öneri ekranı toplam indirme boyutunu gösterir.

Çözüm
  1. Yerel model klasörünün bulunduğu diskte yer açın.
  2. Devam et ya da Yeniden dene’ye basın.

İndirilen dosya doğrulanamadı ya da model kartı dosyanın katalogla uyuşmadığını söylüyor

Uygulamada görünen ileti

İndirilen dosya doğrulanamadı (SHA-256 uyuşmuyor).
Olası neden

Her dosya boyutu ve SHA-256 özetiyle doğrulanır. Özet uyuşmazsa dosya silinir ve bir kez yeniden indirilir; ikinci indirmede de uyuşmazsa bu ileti çıkar.

Bilgisayarınızdaki bir model dosyası katalogdakiyle aynı ad ve boyutta ama özeti farklıysa kart bunu yazar ve bu dosya seçilemez.

Çözüm
  1. Bağlantınızı denetleyip Yeniden dene’ye basın.
  2. Kart dosyanın katalogla uyuşmadığını söylüyorsa karttaki İndir ile dosyayı yeniden indirin.

Model uygulama açılınca belleğe yüklenmiyor

Olası neden

Açılışta yükle yalnız masaüstü uygulamasında, Yerel model katmanı ve Açılışta yükle açıkken ve bir kurulum işi sürmüyorken çalışır; Açılışta yükle varsayılan olarak açıktır. Bir model yalnız açıkça seçildiyse yüklenir; seçim Otomatik ise açılışta yükleme yapılmaz.

Önce gömme modeli, sonra sohbet modeli yüklenir. Sohbet modeli yalnız o anki boş belleğe sığıyorsa yüklenir. Kullanılmayan model 30 dakika sonra bellekten boşaltılır.

Çözüm
  1. Ayarlar → Model → Sohbet modeli bölümündeki Yerel model katmanı anahtarının açık olduğunu denetleyin.
  2. Aynı bölümde Çalıştırılacak model listesinden modeli açıkça seçin.
  3. Ayarlar → Model bölümündeki Açılışta yükle anahtarının açık olduğunu denetleyin.
  4. Bellek darsa öteki uygulamaları kapatın ya da modeli Başlat ile elle yükleyin; büyük modellerde yükleme birkaç dakika sürebilir.

Model ekran kartı yerine işlemcide çalışıyor

Olası neden

Motor ekran kartınıza göre seçilir. NVIDIA kartta sürücü 550 ya da sonrasıysa CUDA motoru, AMD, Intel Arc ya da sürücüsü eski NVIDIA kartta Vulkan motoru seçilir. Intel tümleşik grafikte, tanınmayan kartta ve ekran kartı olmayan bilgisayarda model işlemcide çalışır. Apple Silicon Mac’lerde Metal kullanılır.

Model ekran kartının belleğine tam sığmıyorsa bir bölümü yine işlemcide çalışır. Windows’ta ekran kartının toplam belleği bilinse de anlık boş belleği ölçülemezse (AMD ve Intel Arc kartlarında sistem sayacı, NVIDIA’da nvidia-smi) model işlemcide açılır; Ayarlar’da çalışan modelin yanında “Ekran kartının boş belleği ölçülemedi; model işlemcide çalışıyor ve yanıtlar yavaş olur.” uyarısı görünür ve model bu yüzden açılamıyorsa hata iletisi nedeni söyler.

Çözüm
  1. Ayarlar → Model → Gelişmiş bölümündeki Donanım satırında ekran kartınızın ve belleğinin tanınıp tanınmadığına bakın.
  2. NVIDIA kartınız varsa ekran kartı sürücünüzü güncelleyin.
  3. Windows’ta Ayarlar → Model bölümünde “boş belleği ölçülemedi” uyarısı görünüyorsa ekran kartı sürücüsünü güncelleyin; NVIDIA kartta nvidia-smi komutunun çalıştığını denetleyin. Uyarı sürerse model işlemcide çalışır; daha küçük bir model seçin.
  4. Farklı bir motor denemek için Ayarlar → Genel bölümündeki Kurulum sihirbazını yeniden çalıştır ile sihirbazı açın. Kişiselleştir ekranında birden çok motor seçeneği varsa Motor satırından seçin (ör. Intel tümleşik grafikte Vulkan).
  5. Model ekran kartına sığmıyorsa daha küçük bir model seçin.

Kurulum sihirbazı ya da sohbet modeli başlatamıyor

Uygulamada görünen ileti

Model başlatılamadı. Ekran kartı sürücünüzü güncellemeyi ya da daha küçük bir model seçmeyi deneyin; ayrıntı llama.log dosyasında.
Olası neden

Model belleğe sığmıyor, ekran kartı sürücüsü eski ya da motor dosyası engellenmiş olabilir. Uygulama başlatma başarısız olunca daha sade ayarlarla, bellek ayrılamazsa daha kısa bağlamla yeniden dener.

Sohbette aynı durum “Seçilen yerel model başlatılamadı.” iletisiyle görünür.

Çözüm
  1. Ekran kartı sürücünüzü güncelleyin.
  2. Açık uygulamaları kapatıp yeniden deneyin.
  3. Sihirbazda Kişiselleştir ile daha küçük bir model seçin ya da Şimdilik atla ile kurulumu sonraya bırakın.
  4. İletideki llama.log dosyası Windows’ta %LOCALAPPDATA%\Muhakeme\yerel-model, macOS’ta ~/Library/Application Support/Muhakeme/yerel-model klasöründedir.

Yerel model isteğin bağlamına sığmadığını söylüyor

Uygulamada görünen ileti

İstek, seçili yerel modelin bağlamına sığmıyor. Daha kısa bir belge ya da soruyla yeniden deneyin.
Olası neden

Yerel model bir seferde sınırlı uzunlukta metin işler; buna bağlam denir. Yerel sohbet sunucusu bellek elverdiğinde 32K bağlamla açılır; bellek ayrılamazsa daha kısa bağlamla (16K) yeniden denenir. Soru ve belgeden giden metin bu sınırı aşarsa bu ileti çıkar.

Görsel eklediyseniz ileti “Ekli görseller ve metin, seçili yerel modelin bağlamına sığmıyor. Daha az görsel ekleyip yeniden deneyin.” olur.

Çözüm
  1. Sorunuzu kısaltın ya da belgenin yalnız ilgili bölümünü yükleyin.
  2. Görsel eklediyseniz daha az görsel ekleyin.

Başlıkta “Model seçimi farklı” yazıyor

Olası neden

Seçtiğiniz model ile şu anda çalışan model farklı. Seçili model ilk soruda yüklenir. Çalışan modeli başka bir Muhakeme uygulaması başlattıysa bu uygulama onu durduramaz.

Çözüm
  1. Ayarlar → Model → Sohbet modeli bölümünde Seçili modele geç ile hemen geçin ya da Çalışan modeli kullan ile çalışan modeli seçin.
  2. Sunucuyu başka bir Muhakeme uygulaması başlattıysa geçiş için onu o uygulamadan durdurun.

Karar listesinde kararların bağlama göre sıralanamadığı yazıyor

Uygulamada görünen ileti

Kararlar bağlama göre sıralanamadı; en yeni kararlar gösteriliyor.
Olası neden

Bulunan kararlar sorunuzla ilgisine göre yerel gömme modeliyle sıralanır. Sıralama yapılamazsa liste en yeni kararlarla gösterilir ve notun sonunda parantez içinde neden yazar: “(bağlam sıralaması için yerel gömme modeli gerekir)”, “(bağlam sıralaması bu aramada yapılamadı)” ya da “(kaynak bu kararlarda konu bilgisi vermiyor)”. Sonuncusunda sorun bilgisayarınızda değil, kaynaktadır.

Gömme modeli yoksa Ayarlar → Model → Gömme modeli bölümü de modelin bulunamadığını yazar.

Çözüm
  1. Ayarlar → Model → Gömme modeli bölümünde modeli Başlat ile yükleyin ya da Değiştir ile başka bir gömme modeli seçin.
  2. Gömme modeli yoksa Ayarlar → Model → İndirilebilir modeller bölümündeki Gömme · arama sıralaması kartından indirin.
  3. Aramayı yineleyin.

Karar kartında özet üretilemiyor

Uygulamada görünen ileti

Özet üretilemedi — kullanılabilir model yok.
Olası neden

Karar listesindeki kartların özetini yapay zekâ hazırlar; bunun için çalışan bir yerel model ya da API anahtarıyla eklenmiş bir bağlantı gerekir. Kayıtlı bir API bağlantısı varken özet üretilemezse ileti “Özet üretilemedi” ile başlar ve yapay zekâ bağlantısının yanıt vermediğini söyler.

Liste sıralanırken üstteki kararlar kendiliğinden özetlenir. Bir özet üretilemezse durum satırında “Özetleme durduruldu” yazar ve neden ilk hatalı kartın üzerinde gösterilir.

Claude Code, Codex ya da ZCode seçiliyken özet ve öteki arka plan adımları bu araçlara gönderilmez; bu işler için çalışan bir yerel model gerekir.

Çözüm
  1. Yerel modeli Ayarlar → Model → Sohbet modeli bölümünde Başlat ile yükleyin ya da Ayarlar → Bağlantılar bölümünde API anahtarıyla bir bağlantı ekleyin.
  2. API bağlantısı yanıt vermiyorsa bağlantıyı Bağlantıyı test et ile deneyin.
  3. Kartta Özetle’ye yeniden basın.

Konulara dön

Bağlantılar ve komut satırı araçları

Ayarlar → Bağlantılar iki gruptur: Aboneliğinizle grubunda bilgisayarınızda kurulu Claude Code, Codex ve ZCode kartları, API anahtarıyla (kullandıkça ödeme) grubunda sağlayıcı anahtarıyla eklenen bağlantılar durur.

Claude Code, Codex ya da ZCode kartında “kurulu değil” yazıyor

Olası neden

Uygulama bu araçları kurmaz; bilgisayarınızda kurulu programı bilinen kurulum konumlarında ve PATH’te arar. Başlatıcı betikler (.cmd, .ps1) kullanılmaz, gerçek program aranır. ZCode için ayrıca node PATH’te bulunmalıdır.

Çözüm
  1. Aracı kendi kurulum yönergesiyle kurun ve kendi hesabınızla oturum açın.
  2. Durumu yenile’ye basın.
  3. Kart sürüm eski diyorsa aracı güncelleyin; kart gereken en düşük sürümü yazar ve bağlantı o sürüme kadar kapalı kalır.

Kartta “oturum kapalı” ya da “oturum bilinmiyor” yazıyor

Olası neden

Uygulama kimlik bilgisi tutmaz; aracın kendi hesabınızla oturum açmış olması gerekir. Oturum durumu aracın kendi komutuyla okunur. ZCode bu bilgiyi vermezse kart oturum bilinmiyor der; oturumun açık olduğu Test et ile anlaşılır. Bir istek kimlik hatasıyla biterse kart sonraki okumada oturum kapalı gösterir.

Çözüm
  1. Kartta Konsolu aç’a basın. Açılan konsol boştur; giriş komutunu kendiniz yazın: Claude Code için claude auth login, Codex için codex login (tarayıcısız: codex login --device-auth), ZCode için zcode login.
  2. Girişi aracın kendi akışında tamamlayın.
  3. Durumu yenile, ardından Test et’e basın.
  4. Konsol açılamazsa komutu kendi terminalinizde çalıştırın.

Kartta “Test et” başarısız oluyor

Olası neden

Test et araca kısa bir deneme istemi gönderir ve en çok 30 saniye bekler; boş yanıt başarı sayılmaz. Deneme istemi de aboneliğinizden düşer. Oturum kapalıysa, araç yanıt vermezse ya da sürümü desteklenmiyorsa test başarısız olur. Codex sürümü desteklenmiyorsa “Codex bu sürümde desteklenmiyor (--ephemeral yok); Codex'i güncelleyin.” iletisi çıkar.

Çözüm
  1. Oturumu yenileyin: konsolda giriş komutunu çalıştırıp Durumu yenile’ye basın.
  2. Codex’te oturum kimlik hatasıyla düşmeye devam ederse konsolda codex logout, ardından codex login çalıştırın.
  3. Aracı güncelleyip testi yineleyin.
Çözüldüğünü nasıl anlarsınız?
Başarılı testte kartta “Bağlantı çalışıyor.” iletisi ve aracın yanıtı görünür.

ZCode bağlantısı sağlayıcı yapılandırmasını bulamıyor

Uygulamada görünen ileti

ZCode sağlayıcı yapılandırması bulunamadı. ZCode uygulamasını bir kez açıp kapatın, sonra bağlantıyı yeniden deneyin.
Olası neden

ZCode bağlantısı, ZCode masaüstü uygulamasının oluşturduğu sağlayıcı yapılandırmasını kullanır. Muhakeme İçtihat bu dosyanın yalnız yerini kullanır, içeriğini ve kimlik bilgilerini okumaz. Dosya yoksa bu ileti çıkar.

Çözüm
  1. ZCode uygulamasını bir kez açıp kapatın.
  2. Kartta Durumu yenile, ardından Test et’e basın.
  3. Yanıtı ZCode’da /model ile seçtiğiniz model üretir; karttaki model seçimini ZCode’daki seçiminizle aynı tutun.

Claude Code, Codex ya da ZCode seçiliyken Karar Ara ve Mevzuat Ara arama yapmıyor

Bağlantı kartının Sınırlar bölümündeki metin

Karar ve mevzuat sohbetinde arama aracı çağrılamaz; arama için yerel model ya da API bağlantısı seçin.
Olası neden

Aboneliğinizle bağlantısında soru bilgisayarınızdaki araca gider ve yanıtı o araç üretir. Bu yolda model, Karar Ara ve Mevzuat Ara’nın arama aracını çağıramaz; karar ya da mevzuat listesi dolmaz. Bu bir arıza değil, bağlantının sınırıdır ve kartın Sınırlar bölümünde de yazar.

Çözüm
  1. Model menüsünden yerel bir model ya da API anahtarıyla eklenmiş bir bağlantı seçin. Komut satırı bağlantısından çıkmak için model menüsünden başka bir model seçmeniz yeterlidir.
  2. Aramayı kendi aboneliğinizle yapmak istiyorsanız MCP kullanın: Ayarlar → MCP ile arama araçlarını Claude Desktop, Codex CLI ya da Claude Code’a ekleyin. Aramayı o uygulamanın yapay zekâsı yapar.

API bağlantısının testinde anahtar reddediliyor

Uygulamada görünen ileti

API anahtarı geçersiz veya bu uç için yetkisiz.
Olası neden

Anahtar yanlış kopyalanmış, sağlayıcıda geçersiz kılınmış ya da seçtiğiniz sağlayıcıya ait olmayabilir. Kayıtlı bir bağlantının Base URL’ini değiştirdiyseniz kayıtlı anahtar güvenlik nedeniyle yeni adreste kullanılmaz; anahtarı bu adres için yeniden girmeniz gerekir.

Çözüm
  1. Anahtarı sağlayıcınızın konsolundan yeniden kopyalayın. Sağlayıcıyı seçince formdaki Ayrıntı bölümü anahtarın nereden alınacağını yazar.
  2. Kayıtlı bağlantıda Düzenle ile anahtarı yeniden girin, sonra Bağlantıyı test et’e basın.
  3. Z.AI GLM Coding Plan anahtarı sohbette kullanılamaz; sohbet için z.ai (GLM) bağlantısını ya da ZCode kartını kullanın.
Çözüldüğünü nasıl anlarsınız?
Test başarılı olunca “Bağlantı başarılı” iletisi, listelenen model sayısıyla birlikte görünür.

API bağlantısının testi adres, model ya da istek sınırı hatasıyla bitiyor

Uygulamada görünen ileti

Uç bulunamadı (404) — base URL'i kontrol edin.
Olası neden

Bağlantıyı test et önce sağlayıcıdan model listesini ister. Sağlayıcı liste sunmuyorsa girdiğiniz modelle kısa bir deneme isteği gönderir; bu istek de adres bulunamadığı için dönerse bu ileti çıkar. Base URL büyük olasılıkla yanlıştır.

Öteki iletiler: “Model bulunamadı” ile başlayan ileti Anthropic bağlantısında model adının sağlayıcıda bulunmadığını, “İstek sınırı aşıldı (429)” ile başlayan ileti sağlayıcının kısa sürede çok istek aldığını söyler. “Zaman aşımı” ya da “Sunucuya bağlanılamadı” ile başlayan iletiler adrese ulaşılamadığını gösterir.

Çözüm
  1. Base URL’i sağlayıcınızın belgesindeki adresle karşılaştırın; adres http:// ya da https:// ile başlamalıdır.
  2. Model adını denetleyin. Kayıtlı bağlantıda Modelleri yenile ile sağlayıcının güncel listesini alabilirsiniz.
  3. İstek sınırı iletisinde birkaç dakika bekleyip yeniden deneyin.
  4. Adrese ulaşılamıyorsa internet bağlantınızı denetleyin; kurumsal ağdaysanız sağlayıcının adresine erişim isteyin (kurumsal ağ).
  5. Ardından Bağlantıyı test et’e yeniden basın.
Çözüldüğünü nasıl anlarsınız?
Test başarılı olunca “Bağlantı başarılı” iletisi görünür.

Bağlantının model listesi boş ya da eski

Uygulamada görünen ileti

Model listesi şu anda alınamadı; kayıtlı liste kullanılmaya devam ediyor.
Olası neden

API bağlantılarında model listesi sağlayıcıdan canlı alınır; sohbet dışı modeller listeye girmez. 24 saatten eski liste Bağlantılar açılınca arka planda yenilenir; yeni liste sayfa yeniden açılınca görünür.

Codex kartında liste bilgisayarınızdaki Codex’ten okunur; okunamazsa uygulamanın yedek listesi gösterilir.

Çözüm
  1. Kayıtlı bağlantıda Modelleri yenile’ye basın.
  2. Ayarlar penceresini kapatıp yeniden açın.
  3. Codex kartı için Durumu yenile’ye basın; model listesi de yeniden okunur.
  4. Model alanını boş bırakırsanız sağlayıcının önerdiği model kullanılır. Mistral, Together ve OpenRouter’da model kimlikleri canlı listeden gelir.

Konulara dön

MCP

Ayarlar → MCP bölümünde Claude Desktop ve Codex CLI kartları doğrudan görünür; Claude Code kartı varsayılan olarak kapalı gelen Diğer uygulamalar bölümündedir. Elle kurulum için yapılandırma dosyası ve komutlar ürün sayfasının MCP bölümünde yazılıdır.

“Kur ve doğrula” önizlemede durdu, kurulum yapılmadı

Olası neden

Codex CLI ve Claude Code’da kaydı Muhakeme İçtihat değil, aracın kendi mcp add komutu yapar. Araç bilgisayarınızda bulunamazsa zincir önizlemede durur: onay istenmez, hiçbir şey yazılmaz. Kart aracın bulunamadığını ve komutu terminalde çalıştırmanızı söyler; önizlemede Komutu kopyala düğmesi çıkar.

Çözüm
  1. Önizlemedeki Komutu kopyala ile kayıt komutunu kopyalayın.
  2. Komutu terminalde çalıştırın.
  3. Kartta Durumu yenile, ardından Doğrula’ya basın.
  4. Aracı daha sonra kurarsanız Kur ve doğrula kaydı kendisi yapar.

Claude Code araçları yalnız tek bir klasörde görüyor

Olası neden

claude mcp add komutunun varsayılan kapsamı yalnız o anki proje klasörüdür. Muhakeme İçtihat kaydı kullanıcı kapsamıyla (-s user) yapar. Komutu elle çalıştırırken -s user yazılmazsa kayıt yalnız o klasörde geçerli olur.

Çözüm
  1. Kaydı kartın Kur ve doğrula düğmesiyle yapın ya da komutu kullanıcı kapsamıyla çalıştırın: claude mcp add -s user -t stdio muhakeme-ictihat -- "<uygulama-yolu>" --mcp
  2. Uygulama yolu varsayılan kurulumda Windows’ta %LOCALAPPDATA%\Programs\MuhakemeIctihat\MuhakemeIctihat.exe, macOS’ta /Applications/Muhakeme İçtihat.app/Contents/MacOS/MuhakemeIctihat olur.
  3. Kaydı claude mcp get muhakeme-ictihat ile denetleyin.
  4. Yalnız bir proje klasöründe kalan eski kaydı Claude Code’un kendi claude mcp remove komutuyla kaldırabilirsiniz.

“Doğrula” zaman aşımıyla bitiyor

Uygulamada görünen ileti

Sunucu 20 saniye içinde yanıt vermedi. Makine yoğunsa bir kez daha deneyin; sürüyorsa kayıtlı komutu terminalde elle çalıştırıp çıktısına bakın.
Olası neden

Doğrula, yapılandırmada kayıtlı komutu gerçek bir süreç olarak başlatır, araç listesini ister ve en çok 20 saniye bekler. Doğrulamada hiçbir araç çağrılmaz, dışarıya istek gitmez.

Çözüm
  1. Doğrula’ya bir kez daha basın.
  2. Sürerse terminalde kayıtlı komutu çalıştırın: "<uygulama-yolu>" --mcp. Süreç açık kalıyor ve hata basmıyorsa sunucu sağlıklıdır; Ctrl+C ile çıkın.

“Doğrula” kayıtlı komutun çalışmadığını ya da MCP yanıtı vermediğini söylüyor

Uygulamada görünen ileti

Kayıtlı komut çalıştırılamadı — süreç açılmadı ya da hemen kapandı. Yapılandırmadaki 'command' yolunu kontrol edin, gerekirse “Yeniden kur ve doğrula” deyin.
Olası neden

Doğrula, yapılandırmada kayıtlı komutu çalıştırır. Komut başlatılamıyor ya da hemen kapanıyorsa bu ileti çıkar. Süreç açılıp MCP yanıtı vermezse ileti “Süreç açıldı ama MCP yanıtı vermedi; kayıtlı komut MCP sunucusu olarak çalışmıyor.” diye başlar; komutun sonunda --mcp bayrağı eksik olabilir. Sunucu hiç araç bildirmezse ileti “Bağlantı kuruldu ama sunucu hiç araç bildirmedi.” diye başlar.

Çözüm
  1. Kartta Yeniden kur ve doğrula’ya basın; uygulamanın bugünkü yolu ve --mcp bayrağı yazılır.
  2. Kaydı elle yaptıysanız komutun uygulama yolunu ve sonundaki --mcp bayrağını denetleyin: "<uygulama-yolu>" --mcp
  3. Sunucu hiç araç bildirmiyorsa Muhakeme İçtihat’ı güncelleyip yeniden deneyin; sürerse kartın ekran görüntüsünü destek iletinize ekleyin.

MCP kartında “kurulum bozuk” yazıyor

Uygulamada görünen ileti

Girdi yapılandırmada duruyor, ama gösterdiği uygulama dosyası diskte yok. Uygulama taşınmış ya da yeniden kurulmuş olabilir — “Yeniden kur ve doğrula” deyin.
Olası neden

Kayıt yapılandırmada duruyor ama gösterdiği uygulama dosyası diskte yok. Uygulama başka bir klasöre kurulduysa ya da taşındıysa kayıt eski yolu gösterir. Bu durumda Doğrula da kayıtlı komutun gösterdiği dosyanın diskte olmadığını söyler.

Çözüm
  1. Kartta Yeniden kur ve doğrula’ya basın; uygulamanın bugünkü yolu yazılır.
  2. Ardından MCP kullanan uygulamayı tamamen kapatıp yeniden açın.

MCP kartında “config bozuk” ya da “durum okunamadı” yazıyor

Uygulamada görünen ileti

Yapılandırma dosyası okunamadı (biçim bozuk). Dosya değiştirilmedi; elle düzeltip yeniden deneyin.
Olası neden

Kartın okuduğu yapılandırma dosyası geçerli JSON ya da TOML değil. Muhakeme İçtihat bozuk dosyayı değiştirmez. Dosya hiç açılamıyorsa kart durum okunamadı der ve ileti “Yapılandırma dosyası okunamadı. Dosya izinlerini kontrol edin.” olur.

Dosyalar: Claude Desktop’ta claude_desktop_config.json, Codex CLI’de ~/.codex/config.toml, Claude Code’da ~/.claude.json.

Çözüm
  1. Kartta Yolu kopyala ile dosyanın yerini alın.
  2. Dosyanın bir kopyasını alın. Sonra dosyayı bir metin düzenleyiciyle açıp biçim hatasını düzeltin (ör. eksik ya da fazla virgül, kapanmamış parantez).
  3. Kart durum okunamadı diyorsa dosyanın kullanıcı hesabınızca okunabildiğini denetleyin.
  4. Kartta Durumu yenile’ye basın, ardından Kur ve doğrula ya da Doğrula ile yeniden deneyin.

Araçlar Claude Desktop, Codex CLI ya da Claude Code’da görünmüyor

Uygulamada görünen ileti

Uygulamayı tamamen kapatıp yeniden açın — araç listesi yalnız açılışta okunur.
Olası neden

MCP kullanan uygulama yapılandırmayı yalnız açılışta okur. Kurulumdan sonra uygulama tamamen kapatılıp açılmadıysa araçlar görünmez; pencereyi kapatmak yetmez.

Çözüm
  1. MCP kullanan uygulamayı tamamen kapatıp yeniden açın.
  2. Kaydı denetleyin: Codex CLI’de codex mcp list, Claude Code’da claude mcp get muhakeme-ictihat.
  3. Ayarlar → MCP kartında Doğrula’ya basın.
Çözüldüğünü nasıl anlarsınız?
Claude Desktop’ta sohbet girişindeki araç menüsünde muhakeme-ictihat sunucusu ve karar_ara, mevzuat_ara gibi araçlar görünür. Codex CLI’de codex mcp list çıktısında muhakeme-ictihat yer alır.

Doğrulama başarılı, ama araçlar giriş yapmanızı istiyor

Uygulamada görünen ileti

Bağlantı çalışıyor, ama muhakeme.ai hesabınıza giriş yapılmamış görünüyor; araçlar ilk çağrıda sizi giriş sayfasına yönlendirir.
Olası neden

Başarılı doğrulama yalnız sunucunun başlatılabildiğini gösterir, lisansı göstermez. Dokuz aracın hepsi muhakeme.ai girişi ve geçerli bir lisans ya da deneme ister. Giriş yoksa araç giriş yapmanızı söyleyen bir yanıt döndürür ve Muhakeme İçtihat penceresini açmaya çalışır.

Çözüm
  1. Açılan Muhakeme İçtihat penceresinden muhakeme.ai hesabınızla giriş yapın.
  2. Aracı yeniden çağırın; MCP kullanan uygulamayı yeniden başlatmanız gerekmez.

Lisansım geçerli ama Claude Desktop’taki araçlar AUTH_REQUIRED döndürüyor (Windows)

Uygulamada görünen ileti

Bu uygulamaya başsız giriş (MuhakemeIctihatHeadless) kayıtlı. Başsız giriş uygulama kapsayıcısının dışına çıkamaz ve oturum dosyalarınızı göremez; lisansınız geçerli olsa bile araç çağrıları AUTH_REQUIRED döndürür. “Yeniden kur ve doğrula” deyin — doğru komut (MuhakemeIctihat.exe --mcp) yazılır.
Olası neden

Windows’ta Claude Desktop, MCP sunucusunu kendi uygulama kapsayıcısında çalıştırır. Kayıtta başsız giriş (MuhakemeIctihatHeadless.exe) varsa sunucu bu kapsayıcıdan çıkamaz ve oturum dosyalarınızı göremez; lisansınız geçerli olsa da araç çağrıları reddedilir.

Çözüm
  1. Ayarlar → MCP → Claude Desktop kartında Yeniden kur ve doğrula’ya basın; doğru komut (MuhakemeIctihat.exe --mcp) yazılır.
  2. Claude Desktop’ı tamamen kapatıp yeniden açın.
  3. Uyarı sürerse Muhakeme İçtihat’ta muhakeme.ai hesabınızla giriş yaptığınızı denetleyin.

Claude Desktop kartında köprü uyarısı var, pencere masaüstü uygulamasından farklı veri gösteriyor (Windows)

Uygulamada görünen ileti

Claude Desktop kapsayıcısı köprü kuramadı: sunucu paketin kapsayıcısında çalıştı ve panel verisi masaüstü uygulamasından ayrı düştü. Claude Desktop'ı tamamen kapatıp yeniden açın; sürerse MCP kurulum belgesindeki “Sorun giderme” bölümüne bakın.
Olası neden

Windows’ta Claude Desktop’ın başlattığı sunucu, masaüstü uygulamasıyla aynı oturumu, ayarları ve verileri kullanmak için kapsayıcının dışına bir köprü kurar. Köprü kurulamazsa sunucu kapsayıcı içinde çalışır ve açılan pencere masaüstü uygulamasından ayrı ayar ve veri görür.

Çözüm
  1. Claude Desktop’ı tamamen kapatıp yeniden açın.
  2. Ayarlar → MCP → Claude Desktop kartında Doğrula’ya basın.
  3. Uyarı sürerse destek adresine yazın.

Codex CLI’de muhakeme-ictihat kaydı görünmüyor

Olası neden

Codex CLI yapılandırması ~/.codex/config.toml dosyasındadır; CODEX_HOME tanımlıysa $CODEX_HOME/config.toml okunur. Muhakeme İçtihat bu dosyaya doğrudan yazmaz; kaydı Codex’in kendi codex mcp add komutuyla yapar.

Çözüm
  1. Kaydı codex mcp list ile denetleyin.
  2. Kayıt yoksa kartta Kur ve doğrula’ya basın ya da komutu kendiniz çalıştırın: codex mcp add muhakeme-ictihat -- "<uygulama-yolu>" --mcp
  3. Codex’i yeniden başlatın.
  4. Kaydı kaldırmak için codex mcp remove muhakeme-ictihat çalıştırın.

Cursor, Gemini CLI, LM Studio ya da VS Code’da eski muhakeme-ictihat girdisi duruyor

Olası neden

Uygulamanın önceki sürümleri bu uygulamalar için de kayıt yazıyordu. Bugünkü sürümde bu uygulamaların kartı yoktur ve eski girdiler kendiliğinden silinmez; kendiniz kaldırırsınız.

Çözüm
  1. Cursor: ~/.cursor/mcp.json dosyasında mcpServers altındaki muhakeme-ictihat girdisini silin.
  2. Gemini CLI: ~/.gemini/settings.json dosyasında aynı girdiyi silin ya da gemini mcp remove muhakeme-ictihat çalıştırın.
  3. LM Studio: ~/.lmstudio/mcp.json dosyasında mcpServers altındaki muhakeme-ictihat girdisini silin.
  4. VS Code: komut paletinden MCP: Open User Configuration ile açılan dosyada servers altındaki muhakeme-ictihat girdisini silin.
  5. Dosyaların yanında duran .yedek- ekli kopyalar da silinebilir. Bu uygulamaları yine kullanmak isterseniz Ayarlar → MCP → Diğer uygulamalar bölümündeki listede olmayan uygulama kartının JSON’unu ya da komutunu kullanın.

Uygulamayı kaldırdıktan sonra MCP kaydı duruyor

Uygulamada görünen ileti

Muhakeme İçtihat'ın Claude Desktop, Codex veya Claude Code'a eklediği bağlantı kaydı kaldırılamadı.

Kaydı ilgili uygulamanın MCP ayarlarından "muhakeme-ictihat" adıyla silebilirsiniz.
Olası neden

Windows’ta kaldırıcı, bu kurulumu gösteren muhakeme-ictihat kaydını Claude Desktop, Codex ve Claude Code’dan siler; silemezse bu iletiyi gösterir. Codex ve Claude Code’da kayıt aracın kendi komutuyla silinir; araç bulunamazsa kayıt kalır.

macOS’ta kaldırıcı yoktur; uygulama bu kaydı silmez, kendiniz kaldırabilirsiniz.

Çözüm
  1. macOS’ta uygulamayı silmeden önce Ayarlar → MCP kartlarında Kaldır’a basın.
  2. Kayıt kaldıysa ilgili uygulamadan silin: Codex CLI’de codex mcp remove muhakeme-ictihat, Claude Code’da claude mcp remove -s user muhakeme-ictihat.
  3. Claude Desktop’ta yapılandırma dosyasında mcpServers altındaki muhakeme-ictihat girdisini silin: Windows’ta %APPDATA%\Claude\claude_desktop_config.json, macOS’ta ~/Library/Application Support/Claude/claude_desktop_config.json.

Konulara dön

Karar kaynağına erişim

Kararlar ve mevzuat UYAP Bedesten’den (bedesten.adalet.gov.tr) gelir. Kaynak kısa sürede gelen isteklere sınır koyar; uygulama bu sınıra uyar ve sizin aramalarınızı arka plan işlerinin önüne alır.

“UYAP Bedesten kaynağı şu an geçici olarak yanıt vermiyor” iletisi çıkıyor

Uygulamada görünen ileti

UYAP Bedesten kaynağı şu an geçici olarak yanıt vermiyor (sunucu kaynaklı — sorgunuzdan kaynaklanmıyor). Birkaç saniye sonra tekrar deneyin.
Olası neden

Sorun sorgunuzda değil, kaynaktadır. Uygulama kaynağa 20 saniyede en çok 5 istek gönderir; kaynak sınır bildirirse bildirdiği süre kadar bekler. Bu bekleme ayrı bir iletiyle gösterilmez; kaynak yanıt vermezse bu ileti çıkar. Arama sırasında aynı durum kaynak yanıt vermedi rozetiyle görünür.

Çözüm
  1. Birkaç saniye bekleyip aynı aramayı yineleyin.
  2. Kurumsal ağdaysanız bedesten.adalet.gov.tr adresine erişim olduğunu denetleyin.

Araştır yanıtı kararların tam metnine ulaşılamadığını söylüyor ya da emsal adayları okunamadı

Uygulamada görünen ileti

Kararların tam metnine ulaşılamadı; yanıt liste bilgisiyle hazırlanıyor…
Olası neden

Kaynak kararların tam metnini veremezse Araştır yanıtı listedeki bilgilerle hazırlanır.

Emsal taramasında kaynak yanıt vermezse uygulama okunamayan adayları bir kez daha okumayı dener; bu sırada durum satırında kaynağın geçici olarak yanıt vermediği ve adayların yeniden okunduğu yazar. Süreye yetişmeyen ya da kaynağın art arda geri çevirdiği kararlar okunmamış sayılır; bu bir hata değildir.

Çözüm
  1. Bir süre sonra soruyu yeniden sorun.
  2. Emsal taramasında Yeniden tara’ya basın; okunmuş kararlar yeniden indirilmez, kalan kararlar okunur.
  3. Önemli kararları önizlemede açıp tam metnini kendiniz okuyun.

Arama sonuç vermiyor

Uygulamada görünen ileti

Sonuç bulunamadı. İfadeyi değiştirip yeniden deneyin.
Olası neden

Kaynakta Yargıtay, Danıştay, bölge adliye mahkemesi hukuk daireleri, ilk derece hukuk mahkemeleri ve kanun yararına bozma kararları vardır. Anayasa Mahkemesi kararları ve ceza dairelerinin istinaf kararları bu kaynakta yoktur.

Arama ifadesinde boşluk “veya” gibi çalışır; çift tırnak tam ifadeyi arar; AND, OR ve NOT büyük harfle yazılır. Joker karakter (*) desteklenmez.

Çözüm
  1. Sorunuzu gündelik Türkçeyle, hukuki meseleyi tarif ederek yazın; model aramayı kendisi kurar.
  2. Türkçe karakterleri doğru yazın; Türkçe karakter kullanılmadan yazılan arama sonuç vermeyebilir.
  3. Kararı künyesiyle arıyorsanız künyeyi denetleyin; kaynakta bulunmayan künye için “Kaynakta bu künyeyle kayıt bulunamadı.” iletisi çıkar.

Kurumsal ağda giriş, arama ya da indirme çalışmıyor

Olası neden

Uygulamanın işine göre bağlandığı başlıca adresler aşağıdadır. Ağınız bunlardan birini engelliyorsa ilgili özellik çalışmaz.

  • www.muhakeme.ai: giriş, lisans, sözleşme, güncelleme denetimi ve güncelleme indirme isteği.
  • bedesten.adalet.gov.tr: karar ve mevzuat araması, Karar Ara açılış ekranı.
  • www.resmigazete.gov.tr: Mevzuat Ara açılışındaki son Resmî Gazete sayıları.
  • html.duckduckgo.com ve arama sonucunda bulunan siteler: Araştır’ın web araması. Araştır bir soruda en çok 8 sayfa açar.
  • github.com ve huggingface.co: motor ve model indirmeleri buradan başlar. İndirme şu adreslere yönlendirilebilir: release-assets.githubusercontent.com, objects.githubusercontent.com, hf.co, *.hf.co ve cdn-lfs*.huggingface.co.
  • *.r2.cloudflarestorage.com ve *.r2.dev: uygulama içi güncellemenin paket indirmesi.
  • Araştır açılışındaki sekiz resmî ve kurumsal haber kaynağının siteleri.
  • API anahtarıyla bağlantı eklediyseniz o sağlayıcının adresi.
Çözüm
  1. Ağ yöneticinizden kullandığınız özelliklerin adreslerine erişim isteyin.
  2. Erişim açıldıktan sonra işlemi yeniden deneyin.

Konulara dön

Açılış ekranları ve haber kaynakları

Karar Ara açılışı son yayımlanan kararları, Mevzuat Ara açılışı son Resmî Gazete sayılarını, Araştır açılışı resmî ve kurumsal kaynaklardaki güncel duyuruları gösterir. Bu ekranlar yapay zekâ kurmadan da çalışır; giriş ve lisans ister.

Karar Ara açılışında kararlar gelmiyor

Uygulamada görünen ileti

Açılış ekranı verisi şu anda alınamadı.
Olası neden

Açılış ekranı son kararları kaynaktan çeker. İstek başarısız olursa ya da kaynak yanıt vermezse bu ileti çıkar; kaynak yanıt vermediğinde ileti “Son kararlar şu anda alınamadı” diye de başlayabilir. Ekran kendini en çok üç kez yeniden dener.

Çözüm
  1. Yeniden dene’ye basın.
  2. Ekran giriş ya da lisans beklediğini söylüyorsa önce giriş yapın; açılış ekranı giriş tamamlanınca kendiliğinden yüklenir.
  3. İlk açılışta hazırlık bir dakika kadar sürebilir.

Mevzuat Ara açılışında Resmî Gazete sayıları gelmiyor

Olası neden

Mevzuat Ara açılışı son 7 Resmî Gazete sayısını doğrudan www.resmigazete.gov.tr adresinden okur. Daha önce okunan günler bilgisayarınızda saklanır; site o an erişilemese de saklanan sayılar gösterilir.

Hiç sayı gösterilemezse kutuda bir not çıkar. Siteye ulaşılamadıysa not “Resmî Gazete sitesine şu anda ulaşılamadı; gösterilenler önbellekten.” olur. Site yanıt verip sayılar okunamadıysa not “Son Resmî Gazete sayıları alınamadı.” olur. Bu iki notun sonuna “Birkaç dakika sonra yeniden denenecek.” eklenebilir. Uygulamanın kendi sunucusundan yanıt alınamadıysa not “Açılış ekranı verisi şu anda alınamadı.” olur ve yanında Yeniden dene düğmesi çıkar.

Çözüm
  1. Notun yanında Yeniden dene varsa basın.
  2. Düğme yoksa bekleyin; ekran kendini 5 dakika arayla en çok üç kez yeniden dener.
  3. Kurumsal ağdaysanız www.resmigazete.gov.tr adresine erişim olduğunu denetleyin.

Araştır açılışında haberler gelmiyor

Uygulamada görünen ileti

Haberler şu anda alınamadı.
Olası neden

Araştır açılışındaki Güncel gelişmeler kutusu sekiz resmî ve kurumsal kaynaktan duyuru çeker; istekleri uygulamanın kendisi yapar. Kaynaklara ulaşılamazsa bu ileti ya da “Haber kaynaklarına şu anda ulaşılamadı.” iletisi çıkar. Daha önce alınmış haberler varsa onlar gösterilir; tazeleme başarısız olursa uygulama birkaç kez kendisi yeniden dener.

Çözüm
  1. Yeniden dene’ye basın.
  2. Haberler MCP ile açılan pencerede gösterilmez; Muhakeme İçtihat uygulamasını kullanın.
  3. Kurumsal ağdaysanız haber kaynaklarının sitelerine erişim olduğunu denetleyin.

Güncel gelişmeler kutusunda duyuru yok

Uygulamada görünen ileti

Son 14 günde bu kaynaklarda yeni duyuru yok.
Olası neden

Bu bir hata değildir. Kutu yalnız son 14 günün duyurularını gösterir ve kaynak başına en çok 5 öğe alır; reklam, ilan ve etkinlik sayfaları süzülür. Seçili sekmenin kaynaklarında bu sürede yeni duyuru yoksa bu ileti çıkar.

Çözüm
  1. Öteki sekmeye geçin: Türk hukuku gündemi ya da Yapay zekâ ve hukuk.
  2. Daha sonra Yenile ile yeniden bakın.

Konulara dön

Araştır ve belge yükleme

Araştır’a PDF, DOC, DOCX, UDF (UYAP), TXT, MD ve görsel (PNG, JPG, GIF) yükleyebilirsiniz. Belge en çok 25 MB, görsel en çok 10 MB olabilir; bir soruya en çok 6 görsel eklenir.

Word dosyası yüklenmiyor

Uygulamada görünen ileti

Bu dosya RTF biçiminde. Word'de .docx olarak kaydedip yükleyin.
Olası neden

Uygulama dosyayı uzantısından değil içeriğinden tanır. Uzantısı .doc olsa da içeriği RTF ya da HTML olan dosyalar ve Word 6/95 biçimindeki belgeler okunmaz; ileti dosyanın biçimini yazar.

Çözüm
  1. Dosyayı Word’de açıp .docx biçiminde kaydedin.
  2. Yeni .docx dosyasını yükleyin.

Parolalı belge yüklenmiyor

Uygulamada görünen ileti

Belge parola korumalı. Word'de .docx olarak kaydedip yükleyin.
Olası neden

Uygulama parolalı Word ve PDF belgelerini okumaz. Parolalı PDF’te ileti “Dosya okunamadı (PDF): PDF parola korumalı.” olur.

Çözüm
  1. Belgeyi açıp parolasız bir kopya olarak kaydedin; Word belgesini .docx biçiminde kaydedin.
  2. Parolasız kopyayı yükleyin.

Görsel ya da taranmış belge eklediğimde “Bu bağlantı görsel okumaz” iletisi çıkıyor

Olası neden

İletide parantez içinde seçili bağlantının adı yazar ve görsel okuyan bir model ya da bağlantı seçmeniz istenir. Claude Code ve ZCode bağlantıları görsel okumaz. Görselleri, görsel okuma dosyası olan yerel model, görsel okuyan API bağlantısı modelleri ve Codex bağlantısı okur.

Metin katmanı olmayan (taranmış) PDF’in ilk 5 sayfası görsel olarak gönderilir; bu yüzden taranmış belge de görsel okuyan bir model ister.

Yerel model seçiliyken ileti farklıdır: yerel model görsel okumuyor kartına bakın.

Çözüm
  1. Model menüsünden görsel okuyan bir model ya da bağlantı seçin.
  2. Belgenin metin içeren bir sürümü varsa onu yükleyin.

Yerel model seçiliyken görsel ya da taranmış belge eklediğimde modelin görsel okumadığı söyleniyor

Uygulamada görünen ileti

Seçili yerel model görsel okumuyor; görsel okuma dosyasını indirip yeniden sorun.
Olası neden

Yerel model görselleri yalnız görsel okuma dosyasıyla birlikte okur. Seçili modelin görsel okuma dosyası indirilebiliyorsa bu ileti çıkar; yanıtta ve dosya çipinde Görsel okuma dosyasını indir düğmesi görünür.

Model için indirilebilir bir görsel okuma dosyası yoksa ileti “Seçili yerel model görsel okumuyor (görsel okuma dosyası yok). Görsel okuyan bir model seçin.” olur. Taranmış PDF’in sayfaları da görsel olarak gönderildiği için aynı iletiler çıkabilir.

Çözüm
  1. Görsel okuma dosyasını indir’e basın.
  2. İndirme bitince “Görsel okuma dosyası indi; sorunuzu yeniden gönderin.” iletisi çıkar; sorunuzu yeniden gönderin.
  3. Model için görsel okuma dosyası yoksa model menüsünden görsel okuyan bir model ya da bağlantı seçin.

Dosya büyük olduğu için yüklenmiyor

Uygulamada görünen ileti

Dosya çok büyük. Sınır 25 MB — belgeyi bölerek yükleyebilirsiniz.
Olası neden

Belge en çok 25 MB, görsel en çok 10 MB ve 40 megapiksel olabilir. Bir soruya en çok 6 görsel eklenir; fazlası alınmaz. Belgeden çıkarılan metin 600.000 karakteri aşarsa gerisi kırpılır.

Çözüm
  1. Belgeyi bölerek yükleyin.
  2. Görselleri küçültün ya da sayısını azaltın.
  3. Uzun belgede belirli bir bölümü soruyorsanız o bölümü sorunuzda tarif edin; yapay zekâya belgenin başından, ortasından ve sonundan örneklenmiş yaklaşık 16.000 karakter gider.

Taranmış PDF okunamıyor

Uygulamada görünen ileti

Bu PDF'te metin katmanı yok ve sayfa görüntüleri çözülemedi — bu tarama biçimi okunamadı. PDF'i görüntü (PNG/JPG) olarak kaydedip yükleyin ya da metin içeren sürümünü seçin.
Olası neden
PDF’te metin katmanı yoksa uygulama ilk 5 sayfayı görsel olarak ekler. Sayfa görüntüleri çözülemezse belge okunmaz.
Çözüm
  1. Sayfaları PNG ya da JPG görüntü olarak kaydedip yükleyin.
  2. Belgenin metin içeren sürümü varsa onu seçin.
  3. Görsel olarak eklenen sayfaları yalnız görsel okuyan bir model yanıtlar.

Araştır’da web araması yapılamıyor

Uygulamada görünen ileti

Web araması yapılamadı (bağlantı/erişim). Birazdan tekrar deneyin.
Olası neden

Araştır, web gerektiren sorularda DuckDuckGo’nun HTML ucuna (html.duckduckgo.com) anahtarsız bağlanır ve bulunan sayfaları bilgisayarınızdan açar. Bağlantı yoksa ya da ağınız bu adrese erişimi engelliyorsa bu ileti çıkar.

Arama motoru kısa sürede çok istek aldığında ileti “Arama motoru geçici olarak hız sınırı uyguladı. Birazdan tekrar deneyin.” olur.

Çözüm
  1. Birkaç dakika bekleyip soruyu yeniden sorun.
  2. İnternet bağlantınızı denetleyin. Kurumsal ağdaysanız kurumsal ağ kartındaki adreslere bakın.

Konulara dön

Gizlilik tercihleri

Paylaşım tercihleri Ayarlar → Gizlilik ve Geri Bildirim bölümündedir; dört seçeneğin hepsi başlangıçta kapalıdır. Verilerin kapsamı ve saklanması Gizlilik Politikası’nda anlatılır.

Gizlilik tercihleri sunucuyla eşitlenmiyor

Eşitleme durum satırı

Eşitleme için yeniden giriş yapın.
Olası neden

Paylaşım tercihleri muhakeme.ai hesabınızla eşitlenir; oturum düşmüşse eşitleme bekler. Tercihler sunucuya yazılmadan hiçbir paylaşım seçeneği için veri gönderilmez. Kapatma tercihi bu bilgisayarda hemen uygulanır.

Çözüm
  1. Uygulamada muhakeme.ai hesabınızla yeniden giriş yapın.
  2. Bölümdeki Şimdi eşitle düğmesine basın; düğme yalnız eşitlenmeyi bekleyen bir tercih varken görünür.
Çözüldüğünü nasıl anlarsınız?
Sunucu eşitlemesi satırının altındaki durum satırında “Eşitleme bekleyen tercih yok.” yazar ve Şimdi eşitle düğmesi kaybolur.

“Verilerimi sil” sonrasında silme doğrulanamadı iletisi çıkıyor

Uygulamada görünen ileti

Sunucuda silme doğrulanamadı; yeniden deneyin.
Olası neden

Verilerimi sil paylaşımı kapatır ve sunucudaki olayları, donanım bilgisini ve geri bildirimleri siler. Sunucu silmeyi doğrulayamazsa bu ileti çıkar.

Çözüm
  1. İnternet bağlantınızı denetleyin.
  2. Paylaşılan verileri sil, ardından Evet, verilerimi sil ile yeniden deneyin.
Çözüldüğünü nasıl anlarsınız?
“Sunucudaki verileriniz silindi.” iletisi görünür.

Konulara dön

Güncelleme ve günlük dosyası

Güncelleme yalnız Ayarlar → Genel → Sürüm ve güncelleme bölümündeki Güncellemeleri denetle düğmesiyle denetlenir; uygulama kendiliğinden denetlemez.

“Güncellemeleri denetle” sonuç vermiyor

Uygulamada görünen ileti

Denetlenemedi (çevrimdışı).
Olası neden

Denetleme www.muhakeme.ai adresine gider ve giriş gerektirmez. Bilgisayar çevrimdışıysa ya da ağ bu adresi engelliyorsa bu ileti çıkar.

Çözüm
  1. İnternet bağlantınızı denetleyip yeniden deneyin.
  2. Yeni sürümü muhakeme.ai üye panelinden de indirebilirsiniz.

Güncellemeyi indirirken giriş isteniyor

Uygulamada görünen ileti

Güncellemeyi indirmek için muhakeme.ai hesabınıza giriş yapın.
Olası neden

Denetleme girişsiz çalışır, ama güncelleme paketini indirmek için muhakeme.ai hesabınızla giriş yapmış olmanız gerekir. Oturum düşmüşse Ayarlar kapanır ve giriş ekranı açılır.

Çözüm
  1. Giriş yapın.
  2. Ayarlar → Genel → Sürüm ve güncelleme bölümüne dönüp İndir ve Güncelle’ye yeniden basın.

Güncelleme doğrulama hatasıyla durdu

Uygulamada görünen ileti

SHA256 doğrulaması başarısız — dosya silindi (güvenlik).
Olası neden

İndirilen paketin SHA-256 özeti sitenin bildirdiği değerle karşılaştırılır. Uyuşmazsa paket silinir ve güncelleme durur; bozuk ya da değiştirilmiş paket kurulmaz.

Çözüm
  1. Bağlantınızı denetleyip güncellemeyi yeniden deneyin.
  2. Sürerse yeni sürümü muhakeme.ai üye panelinden indirip kurun.

macOS’ta güncelleme “karantina kopyası” uyarısıyla başlamıyor

Uygulamada görünen ileti

Uygulama karantina kopyasından çalışıyor — önce Applications klasörüne taşıyın, sonra güncelleyin.
Olası neden
Uygulama Applications klasörü dışındaki bir karantina kopyasından çalışıyorsa güncelleme indirilmez.
Çözüm
  1. Uygulamayı kapatın.
  2. Uygulamayı Applications klasörüne taşıyın ve oradan açın.
  3. Güncellemeyi yeniden deneyin.

Destek için günlük dosyası (log.txt) istendi

Olası neden

Uygulamada günlük klasörünü açan bir düğme yoktur; dosyayı kendiniz bulursunuz. Günlük, varsayılan olarak sorularınızı, belge adlarını ve e-posta adresinizi yazmaz.

log.txt 5 MB’ı aşınca bir sonraki açılışta log.1.txt adıyla saklanır; tek yedek tutulur.

Çözüm
  1. Windows’ta dosya %LOCALAPPDATA%\MuhakemeIctihat\log.txt, macOS’ta ~/Library/Application Support/MuhakemeIctihat/log.txt konumundadır. Varsa log.1.txt aynı klasördedir.
  2. Göndermeden önce dosyayı bir metin düzenleyiciyle açıp içeriğine bakın.
  3. Dosyayı destek iletinize ekleyin.

Konulara dön

Sorun çözülmediyse

Sorununuz burada yoksa ya da adımlar işe yaramadıysa destek@muhakeme.ai adresine yazın. Bu adres uygulamada Ayarlar → Genel → Destek bölümünde de yazar. Genel sorular için sıkça sorulan sorular sayfasına bakabilirsiniz.

İletinize ekleyin

  • Uygulama sürümü: Ayarlar → Genel → Sürüm ve güncelleme bölümündeki Yüklü sürüm satırı.
  • İşletim sisteminiz ve sürümü (ör. Windows 11 ya da macOS 14).
  • Uygulamanın gösterdiği iletinin tam metni. Ekran görüntüsü eklerseniz görüntüde müvekkil bilgisi ya da kişisel veri bulunmadığından emin olun.
  • İstenirse günlük dosyası log.txt; konumu günlük dosyası kartında yazılıdır.
  • MCP doğrulaması başarısız olduysa Ayarlar → MCP kartının ekran görüntüsü.

Eklemeyin

  • Parola, API anahtarı ya da giriş kodu.
  • Müvekkil belgesi, müvekkil adı ya da dava içeriği.

Muhakeme, Anthropic, OpenAI ve Z.AI ile bağlantılı değildir. Google, Mistral, Together ve OpenRouter gibi API sağlayıcılarıyla da bağlantılı değildir.