Yapay Zekâ ve MCP

Yapay zekâ ile geliştirme

llms.txt, sayfaların .md ikizleri ve "Claude'da aç" düğmesi — modelin dokümanı doğru okuması için üç yol.

Bu doküman, insanlar kadar dil modelleri için de tasarlandı. Üç mekanizma var ve üçü de aynı amaca hizmet ediyor: modelin uydurmasını engellemek.

1. Her sayfanın .md ikizi

Herhangi bir sayfanın adresine .md ekle:

text
https://apidocs.blesyum.com/tr/webhooks       → sayfa
https://apidocs.blesyum.com/tr/webhooks.md    → ham Markdown

Referans sayfaları için de çalışır:

text
https://apidocs.blesyum.com/tr/referans/crm.md            → modülün tamamı
https://apidocs.blesyum.com/tr/referans/crm/contacts.md   → tek kaynak ailesi

Neden önemli: modele HTML verdiğinde menü, üst çubuk ve script gürültüsünü de yutar; bağlam bütçesinin yarısı navigasyona gider. .md ikizi yalnız içeriği taşır.

2. llms.txt

Sitenin makine okunur haritası:

text
https://apidocs.blesyum.com/llms.txt        → dizin (kısa)
https://apidocs.blesyum.com/llms-full.txt   → rehberlerin tam metni + uç özetleri

llms.txt modele neyin nerede olduğunu söyler; model gerekli sayfayı kendi çeker. llms-full.txt ise tek dosyada geniş bir bağlam verir.

llms-full.txt içinde uçlar tek satırlık özet kipindedir. Tam künye (parametreler, kimlik, örnek) 12 MB'ı aşardı ve hiçbir modelin bağlamına sığmazdı — sığmayan dosya ortasından kesilir ve model eksik kısmı "yok" sayar. Tam künye modül başına .md dosyasındadır.

3. "Yapay zekâya ver" düğmesi

Her sayfanın üstündeki düğme dört şey yapar:

  • Claude'da aç — sayfayı okutup soru sormaya hazır bir sohbet başlatır
  • ChatGPT'de aç — aynısı
  • Markdown olarak kopyala — sayfanın ham metnini panoya alır
  • MCP sunucusuna bağlan — kurulum talimatı

Sohbet bağlantıları sayfanın içeriğini değil adresini gönderir. Sebebi pratik: tarayıcıların URL sınırı ~8 KB'tır ve bir referans sayfası bunun kat kat üstündedir. İçeriği gömen bir tasarım uzun sayfalarda sessizce kırpılır — model yarısı eksik bir dokümanı tam sanır ve emin bir dille yanlış cevap verir.

4. En iyisi: MCP

Yukarıdaki üçü tek yönlüdür: sen bir sayfa verirsin, model onu okur. MCP ise modele arama yeteneği verir — hangi sayfaya ihtiyacı olduğuna kendisi karar eder.

Kurulum: MCP sunucusu.

Asistanına ne söylemeli

Deneyimle en iyi çalışan istem:

text
Blesyum API'siyle entegrasyon yazacağız.

Kurallar:
- Uç yolu, kimlik başlığı ya da kapsam adı UYDURMA.
- Önce blesyum MCP'sinde search_docs ile ara, sonra get_endpoint ile doğrula.
- Kod yazmadan önce ilgili rehberi get_guide ile oku.
- Yazma isteklerinde Idempotency-Key kullan.
- 429 aldığında Retry-After kadar bekle.

Son iki satır önemli: modeller hız sınırını ve idempotency'yi kendiliğinden düşünmez, ama söylendiğinde doğru uygular.

Bu sayfa işine yaradı mı?
Hâlâ takıldın mı? Destek al