Avukatlar İçin MCP Nedir? Yapay Zeka ile Emsal Karar Arama

Kısa cevap: Model Context Protocol (MCP), bir yapay zekâ uygulamasının dış araçları standart biçimde keşfetmesini ve çağırmasını sağlar. SmartHukuk public MCP sunucusunu uyumlu bir istemciye ekleyin, e-posta adresinizle denemeyi etkinleştirin ve search_public_precedents aracıyla beş başarılı emsal aramasını ücretsiz yapın. Beş aramadan sonra ücretsiz hesap açıp e-postanızı doğruladığınızda SmartHukuk platformunda 14 gün geçerli toplam 50 kullanım hakkı kazanırsınız.

MCP denemesindeki 5 emsal araması ile hesaptaki 50 platform kullanımı farklı haklardır. Hesap akışı kayıtta 5, e-posta doğrulamasında 45 hak ekler; sonuç toplam 50'dir.

SmartHukuk MCP ChatGPT'ye nasıl bağlanır?

Önce beklentiyi düzeltelim: SmartHukuk ChatGPT uygulama dizininde yayında değildir. Sohbette veya uygulama listesinde adını arayarak bulamazsınız; bağlantıyı developer mode ile kendiniz oluşturursunuz. Bir kurulum metnini standart ChatGPT sohbetine yapıştırmak da yeni MCP bağlantısı oluşturmaz. Bağlantıyı ChatGPT ayarlarından bir kez kurun; ardından yeni sohbetlerde araç olarak seçin:

1. ChatGPT'de Settings → Security and login bölümünü açın ve Developer mode seçeneğini etkinleştirin. Seçenek görünmüyorsa çalışma alanı yöneticinizin bu özelliğe izin vermesi gerekir.
2. Settings → Plugins bölümüne gidin veya doğrudan ChatGPT Plugins ekranını açın.
3. + düğmesiyle yeni developer-mode uygulama oluşturun.
4. Alanları şöyle doldurun:
   • Name: SmartHukuk
   • Description: Türkiye hukukunda kaynaklı emsal karar araştırması ve SmartHukuk public hukuk araçları.
   • MCP server URL: https://smarthukuk.com/api/mcp
5. Create düğmesine basın. Araç listesinde get_smarthukuk_overview, start_mcp_precedent_trial ve search_public_precedents görünmelidir.
6. Yeni bir ChatGPT sohbeti açın ve araçlar menüsünden bu bağlantıyı seçin. Bağlantının kayıtlı olması sohbette açık olduğu anlamına gelmez; her yeni sohbette tekrar seçmeniz gerekir.
7. Aşağıdaki “bağlantı sonrası arama talimatı”nı gönderin.

Bu akış OpenAI'nin güncel ChatGPT'ye MCP sunucusu bağlama dokümanıyla aynıdır. Bağlantı yapılmadan ChatGPT'nin “bu oturumda MCP ekleyemiyorum” demesi beklenen davranıştır; e-posta aktivasyonu ancak araçlar görünür olduktan sonra başlar.

SmartHukuk MCP Codex'e nasıl bağlanır?

SmartHukuk MCP'yi Codex'e bağlamak için terminalde codex mcp add smarthukuk --url https://smarthukuk.com/api/mcp komutu çalıştırılır; bu tek komut sunucuyu Codex'in MCP istemcisine kaydeder. Bağlantı kurulduktan sonra yeni bir Codex görevi açıp codex mcp list çıktısında smarthukuk sunucusunun etkin göründüğü doğrulanmalı, ardından /mcp komutuyla araç keşfi kontrol edilmelidir.

codex mcp add smarthukuk --url https://smarthukuk.com/api/mcp

codex mcp list çıktısında smarthukuk etkin görünmelidir. Codex içindeki /mcp komutuyla araç keşfini kontrol edebilirsiniz.

Diğer MCP istemcilerinde kurulum

MCP destekleyen istemcinizde “MCP sunucusu ekle”, “bağlantı ekle” veya “remote server” alanını açın:

• Sunucu adı: smarthukuk
• Bağlantı türü: Streamable HTTP
• Sunucu adresi: https://smarthukuk.com/api/mcp

Yapılandırma dosyası kullanan istemcilerde yaygın biçim şöyledir. İstemcinizin kullandığı alan adı farklıysa ürünün kendi MCP dokümanını izleyin.

{
  "mcpServers": {
    "smarthukuk": {
      "type": "http",
      "url": "https://smarthukuk.com/api/mcp"
    }
  }
}

İstemciyi veya MCP bağlantısını yeniden başlatın ve araç listesini yenileyin. Şu iki araç görünüyorsa arama akışı hazırdır:

1. start_mcp_precedent_trial
2. search_public_precedents

MCP'nin resmî mimari dokümanı, istemcinin önce sunucu yeteneklerini ve araçları keşfettiğini, ardından şemaya uygun araç çağrısı yaptığını açıklar.

Bağlantı sonrası ilk arama nasıl çalıştırılır?

Araçlar göründükten sonra yapay zekâ istemcinize aşağıdaki tam talimatı verin: önce araçların göründüğü doğrulanır, kullanıcıdan e-posta istenip start_mcp_precedent_trial çağrılır, dönen gizli trialToken kullanıcıya gösterilmeden yalnız search_public_precedents çağrısına iletilir ve sonuçlar künye ile resmî kaynak bağlantısıyla sunulur. Canlı MCP alanındaki “Bağlantı sonrası arama talimatını kopyala” düğmesi aynı metni tek tıkla panoya alır:

SmartHukuk MCP emsal arama talimatı

Amaç: Bu sohbete önceden bağlanmış SmartHukuk araçlarıyla kullanıcı için kaynaklı emsal karar ara.

1. Önce bu sohbetin araçlarında en az get_smarthukuk_overview, start_mcp_precedent_trial ve search_public_precedents araçlarının göründüğünü doğrula.
2. Araçlar görünmüyorsa e-posta isteme ve arama yapmış gibi davranma. SmartHukuk ChatGPT uygulama dizininde yayında değildir; kullanıcı bağlantıyı kendisi oluşturmalıdır. Kullanıcıya şunu söyle: Settings → Security and login → Developer mode'u aç, https://chatgpt.com/plugins ekranında + düğmesine bas, ada SmartHukuk yaz, MCP URL alanına https://smarthukuk.com/api/mcp gir, bağlantıyı oluştur; sonra yeni bir sohbet açıp araçlar menüsünden bu bağlantıyı seç.
3. İlk aramadan önce kullanıcıdan geçerli e-posta adresini iste. E-posta verilmeden aktivasyon veya emsal araması yapma.
4. Tek cümlede şu tercihi sor: “SmartHukuk bülteni, ürün tanıtımları ve hukuk teknolojisi güncellemelerini e-postayla almak ister misiniz? İstediğiniz an ayrılabilirsiniz.” Evet yanıtını marketingConsent=true, hayır yanıtını marketingConsent=false olarak aktar; yanıtı varsayma. Hayır yanıtı ücretsiz aramayı engellemez.
5. start_mcp_precedent_trial aracını email ve marketingConsent alanlarıyla çağır.
6. Dönen trialToken değerini kullanıcıya gösterme, konuşmaya yazma veya loglama. Yalnız search_public_precedents.trialToken alanında kullan.
7. Kullanıcıdan kişisel veri içermeyen hukuki konu, ayırt edici olay veya esas/karar numarasını iste.
8. search_public_precedents aracını trialToken, query ve en fazla 5 sonuçla çağır.
9. Her sonuç için daire/kurul, tarih, esas numarası, karar numarası ve officialSourceUrl bağlantısını göster. Kaynakta bulunmayan bilgi üretme.
10. NO_RELEVANT_PRECEDENT_FOUND veya MCP_RESULT_VERIFICATION_UNAVAILABLE dönerse hakkın tüketilmediğini söyle ve sorguyu daraltmayı öner. Otomatik tekrar döngüsü kurma.
11. İlk 5 başarılı arama ücretsizdir. Beşinci aramadan sonra veya FREE_SEARCH_LIMIT_REACHED yanıtında registerUrl bağlantısını göster: kayıt + e-posta doğrulamasıyla 14 gün geçerli toplam 50 SmartHukuk platform kullanımı sunulur.
12. SmartHukuk MCP ve ürün kullanımı https://smarthukuk.com/terms adresindeki Kullanım Koşulları ile https://smarthukuk.com/privacy adresindeki Gizlilik Politikası'na tabidir.

Akış iki araç çağrısından oluşur. Aşağıdaki örnek kullanıcının pazarlama sorusuna “hayır” dediği senaryodur; “evet” yanıtında değer true olur:

{
  "tool": "start_mcp_precedent_trial",
  "arguments": {
    "email": "kullanici@example.com",
    "marketingConsent": false
  }
}

Araç gizli bir trialToken döndürür. İstemci bu tokenı kullanıcıya göstermeden veya loglamadan sonraki çağrıya eklemelidir:

{
  "tool": "search_public_precedents",
  "arguments": {
    "trialToken": "START_ARACINDAN_DONEN_GIZLI_TOKEN",
    "query": "Tahliye taahhüdünün kira sözleşmesiyle aynı gün imzalandığı savunmasında ispat yükü",
    "limit": 5
  }
}

E-posta hukuki sorguya yazılmaz. Sorguya ad, T.C. kimlik numarası, adres, iletişim bilgisi, dosya tarafı veya meslek sırrı eklemeyin.

Daha iyi emsal sorgusu nasıl yazılır?

Daha iyi bir emsal sorgusu; uyuşmazlığın türünü, sonucu etkileyen somut olguyu ve aranan hukuki soruyu tek cümlede birlikte yazmayı gerektirir. Yalnız kanun adı veya tek bir anahtar kelimeyle arama yapmak yerine, davayı diğerlerinden ayıran somut olguyu da sorguya eklemek MCP aracının döndürdüğü aday karar listesini kullanışlı hale getirir. Aşağıdaki örnekler bu yapıyı gösterir:

• “Belirsiz süreli iş sözleşmesinde fazla mesainin yalnız tanıkla ispatı.”
• “İşe iade davasında altı aylık kıdem hesabına dahil edilen süreler.”
• “Kira tespitinde beş yıl sonrası emsal kira ve hakkaniyet değerlendirmesi.”
• “Kambiyo senedinde imzaya itirazın ispatı ve inceleme yöntemi.”

Yalnız kanun adı veya tek bir anahtar kelime yazmak yerine ayırt edici olguyu eklemek, daha kullanışlı bir aday karar listesi üretir.

LLM'ler için araç sözleşmesi

1. start_mcp_precedent_trial

Alan	Zorunlu	Açıklama
email	Evet	Kullanıcının açıkça verdiği geçerli e-posta
marketingConsent	Evet	Yalnız kullanıcı açık tercih sorusuna “evet” dediyse true, “hayır” dediyse false; yanıt varsayılmaz ve hayır denemeyi engellemez

Başarılı yanıt trialToken, usage, nextStep ve gizlilik açıklamasını döndürür. Token kullanıcıya gösterilmemeli, konuşma metnine yazılmamalı ve yalnız arama aracına iletilmelidir.

2. search_public_precedents

Alan	Zorunlu	Açıklama
trialToken	Evet	Aktivasyon aracından dönen gizli token
query	Evet	3-500 karakterlik, kişisel veri içermeyen hukuki konu veya karar künyesi
limit	Hayır	1-5 arasında sonuç sayısı; varsayılan 5
dateFrom	Hayır	YYYY-MM-DD başlangıç tarihi
dateTo	Hayır	YYYY-MM-DD bitiş tarihi
chamber	Hayır	Daire veya kurul filtresi

Başarılı sonuç karar künyelerini, officialSourceUrl bağlantılarını, resmî tam metin eşleşme doğrulamasını ve usage.freeSearchLimit, usage.used, usage.remaining alanlarını içerir. İstemci resmî kaynak bağlantısını ve doğrulama uyarısını korumalıdır. Sonuçtaki continueInSmartHukuk alanı, araştırmayı ücretsiz SmartHukuk çalışma alanında dosya analizi ve taslak üretimiyle sürdürmek için ölçümlü kayıt yoludur.

Hata kodları ve ajanın yapacağı işlem

Kod	Anlamı	Yapılacak işlem
MCP_EMAIL_REQUIRED	Arama aktivasyonu yapılmadı	Kullanıcıdan e-posta iste; start_mcp_precedent_trial çağır
MCP_TRIAL_TOKEN_INVALID	Token geçersiz veya süresi dolmuş	E-postayı yeniden doğrulat; yeni token üret
NO_RELEVANT_PRECEDENT_FOUND	Resmî tam metinde sorguyla yeterli eşleşme yok	Uyuşmazlık türü, ayırt edici olgu ve hukuki soruyla sorguyu daralt; hak tüketilmez
MCP_RESULT_VERIFICATION_UNAVAILABLE	Resmî tam metin geçici olarak doğrulanamadı	Daha sonra yeniden dene; doğrulanmamış sonuç gösterilmez ve hak tüketilmez
FREE_SEARCH_LIMIT_REACHED	5 başarılı MCP araması tamamlandı	Otomatik tekrar yapma; nextStep.registerUrl ile 50 kullanımlık hesap teklifini göster
MCP_QUOTA_TEMPORARILY_UNAVAILABLE	Kota servisi geçici olarak kullanılamıyor	Daha sonra yeniden dene; aynı isteği döngüye alma

MCP araç standardına göre iş kuralından kaynaklanan uygulanabilir hatalar araç sonucu içinde isError: true ile bildirilebilir.

Beş ücretsiz aramadan sonra ne olur?

Her başarılı search_public_precedents çağrısı bir MCP hakkı kullanır. Resmî kaynakların geçici olarak yanıt vermediği, tam metnin doğrulanamadığı veya sorguyla yeterli eşleşme bulunamadığı çağrı hakkı geri verir. Böylece kullanıcının kotası alakasız bir künye için azalmaz. Beşinci başarılı aramada yanıt completionOffer döndürür. Sonraki çağrıda FREE_SEARCH_LIMIT_REACHED ve aynı kayıt teklifi gelir.

Ücretsiz SmartHukuk hesabını açın, e-postanızı doğrulayın ve 14 gün geçerli toplam 50 platform kullanımını etkinleştirin. Kayıtta 5, doğrulamada 45 hak verilir. Daha yüksek kullanım için avukat paketlerini inceleyin.

E-posta ve pazarlama tercihi

E-posta adresi deneme kotasını bağlamak, kötüye kullanımı önlemek ve tek aktivasyon/hizmet e-postasını göndermek için kullanılır. Aktivasyondan önce ajan, bülten ve ürün e-postaları için tek ve açık bir evet/hayır sorusu sorar. marketingConsent yalnız “evet” yanıtında true, “hayır” yanıtında false olur; hayır yanıtı beş ücretsiz aramayı engellemez. Tercih kaynağı, aydınlatma sürümü ve zaman damgasıyla saklanır; her pazarlama e-postasından ücretsiz ayrılabilirsiniz. Ayrıntılar Gizlilik Politikası ve KVKK Aydınlatma Metni içindedir.

SmartHukuk MCP neye erişmez?

SmartHukuk MCP; kullanıcı hesabını veya özel dosyaları açmaz, belge yüklemez ya da değiştirmez, ödeme işlemi başlatmaz ve hukuki danışmanlık ya da kesin sonuç garantisi üretmez. Bağlantı yalnız halka açık emsal karar arama ve genel ürün bilgisi araçlarını sunar; SmartHukuk'un özel sıralama, indeksleme, model, altyapı veya güvenlik yöntemlerini açıklamaz. Aşağıdaki liste kapsam dışı kalan işlemleri özetler:

Public MCP bağlantısı:

• kullanıcı hesabını veya özel dosyaları açmaz,
• belge yüklemez ya da değiştirmez,
• ödeme işlemi başlatmaz,
• hukuki danışmanlık veya kesin sonuç garantisi üretmez,
• SmartHukuk'un özel sıralama, indeksleme, model, altyapı veya güvenlik yöntemlerini açıklamaz.

Public sözleşme yalnız araç adlarını, girdi/çıktı alanlarını, kaynak gösterme davranışını ve kullanım sınırını tanımlar. İç araştırma, sıralama ve güvenlik yöntemi ticari sır olarak tutulur.

Her MCP sonucunda yedi kontrol

1. Karar gerçekten mevcut mu?
2. Daire ile esas ve karar numarası tutarlı mı?
3. Karar tarihi ve uygulanan mevzuat güncel mi?
4. Kullanılacak cümle tam metindeki bağlamı koruyor mu?
5. Somut olay yeterince benzer mi?
6. Aksi yönde daha güncel karar var mı?
7. Dilekçedeki atıf doğrulanan kısmı aşıyor mu?

SmartHukuk emsal karar arama sayfasında bağlantı özetini görebilir; ürün kapsamını Kanıt Merkezi ölçütleriyle değerlendirebilirsiniz.

Sık sorulan sorular

MCP kullanmak için yazılımcı olmak gerekir mi?

Hayır. ChatGPT'de Developer mode'u açıp Plugins ekranında adı ve MCP adresini bir kez kendiniz girmeniz yeterlidir; SmartHukuk dizinde yayında olmadığı için arayarak bulunmaz. Sonraki yeni sohbetlerde bu bağlantıyı araçlar menüsünden seçersiniz. Codex'te tek codex mcp add komutu kullanılır. Yapılandırma dosyası kullanan diğer istemcilerde alan adları ürün dokümanına göre değişebilir.

ChatGPT neden “bu oturumda MCP ekleyemiyorum” diyor?

Çünkü standart sohbet metni ChatGPT'nin bağlantı listesini değiştiremez ve SmartHukuk hazır bir uygulama olarak dizinde durmuyor. Önce Settings → Security and login bölümünde Developer mode'u açın; sonra Settings → Plugins ekranındaki + düğmesiyle SmartHukuk endpoint'ini kendiniz girin. Yeni sohbette araçlar menüsünden bu bağlantıyı seçtiğinizde araçlar kullanılabilir olur.

Aktivasyon e-postası neden istenir?

Beş ücretsiz hakkı aynı kullanıcıya bağlamak, kötüye kullanımı sınırlamak ve kurulum bağlantısını tek hizmet e-postasıyla iletmek için istenir. Bu işlem pazarlama listesine kayıt değildir; ajan aktivasyondan önce ayrıca bülten ve ürün e-postaları için açık bir evet/hayır sorusu sormalı, kullanıcının yanıtını marketingConsent alanına aktarmalı ve hayır yanıtı ücretsiz aramayı engellememelidir.

MCP sonucu resmî karar sayılır mı?

Hayır. MCP sonucu araştırma için aday karar listesidir; resmî karar niteliği taşımaz. Kararın künyesi, erişilebilen tam metni, güncelliği ve somut olaya uygunluğu resmî kaynakta ayrıca doğrulanmalıdır. "Her MCP sonucunda yedi kontrol" listesindeki adımlar, aday bir kararı dilekçeye taşımadan önce izlenmesi gereken doğrulama sırasını gösterir.

Ücretsiz hak bitince ajan ne yapmalı?

Ücretsiz hak bittiğinde ajan otomatik olarak yeni bir arama denememelidir; beşinci başarılı search_public_precedents çağrısından sonra gelen FREE_SEARCH_LIMIT_REACHED yanıtı hakkın tükendiğini gösterir. Bu durumda ajan kullanıcıya kayıt olup e-postasını doğrulaması hâlinde 14 gün geçerli toplam 50 platform kullanımı kazanacağını açıklamalı ve yanıttaki nextStep.registerUrl bağlantısını göstermelidir.

---

Gerçek dosya verisini herhangi bir MCP sunucusuna göndermeden önce veri işleme şartlarını, meslek sırrını ve kurum politikanızı değerlendirin.