Kılavuz/Günlük Kullanım/Bölüm 03

MCP Araçları

İçtihat, mevzuat, kurum kararları ve rehber araçlarının referansı.

Bağlantı kurulduktan sonra asistanınız bu araçları otomatik kullanır. Araç adını yazmanız gerekmez; doğal dille sorun. Bu bölüm, "Asistanım neler yapabilir?" sorusunu yanıtlar.

Özet tablo#

AraçNe yapar
ictihat_araYargıtay/Danıştay/İstinaf/KYB/yerel mahkeme kararı arar
semantik_ictihat_araAnlam tabanlı karar arama (kelime eşleşmesi gerektirmez)
aym_ictihat_araAnayasa Mahkemesi kararı arar (norm denetimi, bireysel başvuru, siyasi parti, Yüce Divan)
ictihat_getirBir kararın tam metnini Markdown getirir (Bedesten + AYM)
kurum_karari_ara11 düzenleyici/idari kurumun kararlarında arama
kurum_karari_getirBulunan kurum kararının tam metnini getirir
mevzuat_ara12 mevzuat türünde global arama
mevzuat_icinde_araTek bir kanun/yönetmelik içinde madde araması
mevzuat_getirMevzuat tam metni / tek madde / gerekçe / içindekiler ağacı
sigorta_dergi_icinde_araBir Sigorta Tahkim hakem karar dergisi sayısı içinde arama
reklam_bulten_icinde_araBir Reklam Kurulu bülteni içinde karar arama
legal_research_guideAsistana hukuki araştırma metodolojisi öğreten rehber
agentic_legal_deep_researchÇok adımlı, paralel yürütülen derin araştırma metodolojisi
udf_tiff_pdf_guideUDF/TIFF/PDF okuma-yazma cookbook'u (UDF üretimi dahil)
install_additional_toolsUDE + e-Devlet e-imza kurulum rehberi (macOS Apple Silicon)
issue_cli_login_codeYardımcı CLI'lar (udf-cli, tiff-cli, pdf-cli) için tek kullanımlık giriş kodu
kullanici_profili_getirProfilinizi ve dilekçe tercihlerinizi asistana tanıtır
prepare_workspace_guide (beta)dava-cli ile çalışma alanı hazırlama ve UYAP dosyası çekme rehberi

Karar arama: ictihat_ara#

  • Tek aramada Yargıtay (tüm daireler + kurullar), Danıştay, BAM/İstinaf, KYB ve yerel mahkeme kararları.
  • Tarih aralığı filtresi, mahkeme/daire filtresi.
  • Sıralama: alakaya göre (varsayılan) veya tarihe göre yeni→eski / eski→yeni.
  • Snippet'ler: Sonuç listesinde arama teriminin geçtiği en ilgili pasaj gösterilebilir. Böylece kararı açmadan önce sonuçları eleyebilirsiniz.
  • Arama kutusunda birden çok kelime VEYA gibi çalışır. "Tam ifade"yi tırnak içinde, zorunlu kelimeyi + ile aratabilirsiniz; asistan bunları sizin yerinize uygular.

Örnek prompt'lar:

"İşe iade davalarında performans düşüklüğü gerekçeli fesihlerle ilgili son 2 yılın Yargıtay kararlarını bul, kriterleri karşılaştır."

"Danıştay'da usulsüz tebligatın vergi cezası davalarına etkisini araştır."

Anlam tabanlı arama: semantik_ictihat_ara#

  • Kavramı farklı kelimelerle anlatan kararları da bulur; birebir kelime eşleşmesi gerekmez. Aynı daire/tarih filtreleri burada da geçerlidir.
  • Korpusu yaklaşık bir yıl geriden gelir. Güncel içtihat için ictihat_ara kullanılır; ikisi birlikte kullanıldığında kapsam en geniş hâlini alır.
  • Kavramsal benzerlikle çalıştığı için sonuçlarda konu dışı görünen kararlar da çıkabilir. Bu, yöntemin doğal sonucudur. "Semantik değil, normal aramayla ara" diyerek kelime tabanlı aramaya dönebilirsiniz.

AYM karar arama: aym_ictihat_ara#

  • Dört karar türü tek araçta: norm denetimi (kanun/KHK/CBK iptal-itiraz), bireysel başvuru (temel hak ihlalleri), siyasi parti (kapatma/mali denetim) ve Yüce Divan; tür seçilmezse hepsi birden taranır.
  • Esas/karar numarasıyla (norm denetimi) veya başvuru numarasıyla (bireysel başvuru) nokta atışı; karar tarihi aralığı tüm türlerde çalışır.
  • Her sonuç hazır bir konu özeti taşır; istenirse arama terimine odaklı snippet de eklenir.

Örnek prompt'lar:

"Mülkiyet hakkı ihlaline yol açan uzun kamulaştırma davalarıyla ilgili güncel AYM bireysel başvuru kararlarını bul."

"7440 sayılı yapılandırma kanununun iptal edilen hükümleri için AYM norm denetimi kararlarına bak."

Karar metni: ictihat_getir#

  • Tek araç, iki kaynak: Bedesten karar ID'leri ve AYM kararları (arama sonucundaki document_id; eski /ND/…, /BB/… atıf biçimleri de çalışır).
  • Karar HTML ise temiz Markdown'a çevrilir; PDF ise otomatik OCR ile metne çevrilir.
  • 40.000 karakteri aşan dev kararlar sayfalanır; asistan page_number ile devamını çeker.
  • Bir kez açılan karar önbelleğe alınır — tekrar açmak kota harcamaz, anında gelir.

Kurum kararları: kurum_karari_ara / kurum_karari_getir#

Mahkeme dışındaki düzenleyici ve idari kurum kararları tek araçta toplanır. Asistan, sorunuzdan hangi kurumda arama yapacağını anlar; isterseniz kurumu doğrudan da belirtebilirsiniz.

KurumNeler var / öne çıkan filtreler
GİBVergi özelgeleri — özelge no, kanun no, tarih aralığı
Rekabet KurumuBirleşme-devralma, rekabet ihlali, menfi tespit/muafiyet, özelleştirme
SayıştayGenel Kurul, Temyiz Kurulu, Daire kararları
KİKUyuşmazlık, düzenleyici ve mahkeme kararları; başvuran/idare adına göre
KDKKamu Denetçiliği (Ombudsmanlık) — tavsiye/ret; başvuru no, idare, 20 konu başlığı
Uyuşmazlık MahkemesiEsas/karar no ile arama (yalnızca ilk sayfa, ~20 sonuç)
KVKKKişisel veri kurul kararları
BDDKBankacılık kurul kararları
BTKKurul kararları (karar/yayım tarihi, ilgili birim) — sonuçlar PDF olduğu için metin taşımaz
Sigorta TahkimHakem kararları → dergi içi aramaya zincirlenir
Reklam KuruluBasın bültenleri → bülten içi aramaya zincirlenir

Bulunan kararın tam metni kurum_karari_getir ile alınır (document_id, örn. gib:12345).

Örnek prompt'lar:

"Açık rıza alınmadan çalışan verisi işlenmesiyle ilgili KVKK kurul kararlarını bul."

"Devir alma işlemlerinde ciro eşiği hakkında Rekabet Kurumu ne diyor?"

Bülten ve dergi içi arama#

  • sigorta_dergi_icinde_ara — Sigorta Tahkim Hakem Karar Dergisi'nin belirli bir sayısını (1–64) açıp içinde anahtar kelime arar.
  • reklam_bulten_icinde_ara — Reklam Kurulu'nun belirli bir bültenini (toplantı no) açıp içinde karar arar.

Genellikle önce kurum_karari_ara ile ilgili dergi veya bülten numarası bulunur, ardından o sayı içinde arama yapılır.

Mevzuat arama: mevzuat_ara#

  • 12 tür: Kanun, KHK, Tüzük, CB Kararnamesi/Yönetmeliği/Kararı/Genelgesi, BK Yönetmeliği, Kurum & Üniversite Yönetmelikleri, Tebliğ, mülga mevzuat.
  • Kanun numarasıyla da arama (örn. "6098").
  • Gelişmiş sözdizimi (asistan yönetir): +zorunlu -hariç "tam ifade" joker*.

Kanun içinde arama: mevzuat_icinde_ara#

  • Tek bir mevzuatın maddeleri içinde arama: "TBK'da kira artışıyla ilgili maddeleri bul".
  • Doğrudan madde numarası kestirmesi: "İş Kanunu m.25'i getir".
  • Eşleşen pasajlar vurgulu snippet olarak döner.

Mevzuat metni: mevzuat_getir#

Dört mod: tam metin · tek madde · madde gerekçesi · içindekiler (madde ağacı). Madde gerekçesine erişim, araştırmayı daha sağlam kurmanıza yardımcı olur.

Rehber ve yardımcı araçlar#

AraçKullanıcı ne derAsistan ne kazanır
legal_research_guide(genelde otomatik çağrılır)Doğru araç seçimi + Türk hukuku araştırma metodolojisi
agentic_legal_deep_research"Derinlemesine araştır"Soruyu parçalara ayırıp mevzuat/Yargıtay/Danıştay kollarını paralel yürüten, atıflı rapor üreten akış
udf_tiff_pdf_guide"Şu UDF'i oku / dilekçeyi UDF yap"UDF↔Markdown/HTML dönüşüm kuralları, çok sayfalı TIFF okuma
install_additional_tools"İmza araçlarını kur"UDE ve e-Devlet e-imza adım adım kurulum (macOS Apple Silicon)
issue_cli_login_code"CLI'a giriş yapmam lazım"udf-cli / tiff-cli / pdf-cli için tek kullanımlık, kısa ömürlü giriş kodu
kullanici_profili_getir(her sohbetin başında otomatik)Adınız, mesleğiniz, baro/sicil bilginiz ve dilekçe tercihleriniz

prepare_workspace_guide beta bir araçtır. dava-cli ile yerel çalışma alanı kurmayı ve UYAP Avukat dosyalarını çekmeyi anlatır. Beta rolündeki hesaplara açıktır.

Örnek istek kütüphanesi (özellik keşfi)#

Ne yapmak istiyorumAsistana ne derim
Somut olaya emsal"Şu olayı anlatıyorum: … Bu olaya benzer Yargıtay kararlarını bul, künyeleriyle listele"
Künye teyidi"2023/1234 E. 2024/567 K. sayılı kararın tam metnini getir" (uydurma karar bu adımda ortaya çıkar — bkz. Doğruluk ve Model Seçimi)
Madde + gerekçe"TBK m.350'yi gerekçesiyle getir"
Kanun içinde tarama"İş Kanunu'nda fesih bildirimine ilişkin maddeleri bul"
İçtihat karşılaştırma"Bu iki dairenin yaklaşım farkını son 3 yılın kararlarıyla karşılaştır"
Anayasal boyut"Bu düzenlemenin AYM'de iptal edilip edilmediğine bak"
Kurum kararı"Bu veri ihlali senaryosunda KVKK'nın yaklaşımını ve idari para cezası pratiğini araştır"
Kendi metnimi denetleme"Ekteki dilekçedeki içtihat atıflarını tek tek araçla teyit et, bulamadıklarını işaretle"
Sözleşme inceleme"Bu sözleşmedeki riskli maddeleri bul; her biri için ilgili TBK hükmünü ve emsal kararı getir"
Derin araştırma"Bu hukuki soruyu derinlemesine araştır: önce mevzuat, sonra gerekçe, sonra içtihat"

Kotalar ve adil kullanım (kullanıcının göreceği davranışlar)#

  • Her aramanın saatlik/günlük kota karşılığı vardır; kota panelde görünür.
  • Rehber araçlar kota harcamaz: legal_research_guide, agentic_legal_deep_research, udf_tiff_pdf_guide, install_additional_tools, kullanici_profili_getir ve issue_cli_login_code aylık kullanım havuzuna işlemez.
  • Önbellek ücretsizdir: daha önce açılmış karar/mevzuat metni kota harcamaz.
  • Yoğunlukta asistan "biraz sonra tekrar dene" benzeri bir mesaj verebilir. Sistem, kaynak servisi korumak için kısa süre bekletir; sorun çoğu zaman birkaç saniye içinde çözülür.
  • Kota dolduğunda araçlar saatlik veya günlük yenilenme zamanına kadar kullanılamaz. Planı yükseltmek kotayı artırır.