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_ara | Yargıtay/Danıştay/İstinaf/KYB/yerel mahkeme kararı arar |
semantik_ictihat_ara | Anlam tabanlı karar arama (kelime eşleşmesi gerektirmez) |
aym_ictihat_ara | Anayasa Mahkemesi kararı arar (norm denetimi, bireysel başvuru, siyasi parti, Yüce Divan) |
ictihat_getir | Bir kararın tam metnini Markdown getirir (Bedesten + AYM) |
kurum_karari_ara | 11 düzenleyici/idari kurumun kararlarında arama |
kurum_karari_getir | Bulunan kurum kararının tam metnini getirir |
mevzuat_ara | 12 mevzuat türünde global arama |
mevzuat_icinde_ara | Tek bir kanun/yönetmelik içinde madde araması |
mevzuat_getir | Mevzuat tam metni / tek madde / gerekçe / içindekiler ağacı |
sigorta_dergi_icinde_ara | Bir Sigorta Tahkim hakem karar dergisi sayısı içinde arama |
reklam_bulten_icinde_ara | Bir Reklam Kurulu bülteni içinde karar arama |
legal_research_guide | Asistana 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_guide | UDF/TIFF/PDF okuma-yazma cookbook'u (UDF üretimi dahil) |
install_additional_tools | UDE + e-Devlet e-imza kurulum rehberi (macOS Apple Silicon) |
issue_cli_login_code | Yardımcı CLI'lar (udf-cli, tiff-cli, pdf-cli) için tek kullanımlık giriş kodu |
kullanici_profili_getir | Profilinizi 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_arakullanı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_numberile 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.
| Kurum | Neler var / öne çıkan filtreler |
|---|---|
| GİB | Vergi özelgeleri — özelge no, kanun no, tarih aralığı |
| Rekabet Kurumu | Birleşme-devralma, rekabet ihlali, menfi tespit/muafiyet, özelleştirme |
| Sayıştay | Genel Kurul, Temyiz Kurulu, Daire kararları |
| KİK | Uyuşmazlık, düzenleyici ve mahkeme kararları; başvuran/idare adına göre |
| KDK | Kamu Denetçiliği (Ombudsmanlık) — tavsiye/ret; başvuru no, idare, 20 konu başlığı |
| Uyuşmazlık Mahkemesi | Esas/karar no ile arama (yalnızca ilk sayfa, ~20 sonuç) |
| KVKK | Kişisel veri kurul kararları |
| BDDK | Bankacılık kurul kararları |
| BTK | Kurul kararları (karar/yayım tarihi, ilgili birim) — sonuçlar PDF olduğu için metin taşımaz |
| Sigorta Tahkim | Hakem kararları → dergi içi aramaya zincirlenir |
| Reklam Kurulu | Bası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 der | Asistan 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 istiyorum | Asistana 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_getirveissue_cli_login_codeaylı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.