Dokümantasyon ChatGPT ve Claude için yapay zeka uyumlu hale nasıl getirilir

3 Kasım 2026'da güncellendi

Dokümantasyonu yapay zeka uyumlu hale getirmek için, önemli olduğu kanıtlanmış temellerle başlayın: Yapay zeka tarayıcıları sayfalarınızı düz HTML olarak çekebilmeli, robots.txt dosyanız arama botlarına izin vermeli ve her makale plan, rol ve sınırlamaları belirterek tek bir soruyu net bir şekilde yanıtlamalıdır. Sayfaları güncel tutun, ardından Markdown kopyaları, bir llms.txt ve yapay zeka ajanları için bir MCP sunucusu ekleyin. Bu ekstralar ucuzdur, ancak yapay zeka yanıtları üzerindeki ölçülebilir etkileri şu ana kadar küçüktür.

Bu rehber, müşterileri artık ürününüzü nasıl kullanacaklarını ChatGPT, Perplexity veya Google'ın Yapay Zeka Özetleri'ne soran destek liderleri ve geliştiricileri Claude Code veya Cursor'ı dokümanlarınıza yönlendiren ekipler içindir. Rehber, arkasında kanıt olanları hala bir bahis olanlardan ayırır.

Yapay zeka uyumlu dokümantasyon ne anlama gelir?#

Yapay zeka uyumlu dokümantasyon, yapay zeka sistemlerinin çekebildiği, anlayabildiği ve doğru bir şekilde alıntılayabildiği dokümantasyondur: Cevap motorları için yapay zeka tarafından okunabilir dokümanlar ve bunlar üzerinde işlem yapan yapay zeka ajanları için dokümanlar. İki tür okuyucu önemlidir:

• Cevap motorları (ChatGPT araması, Perplexity, Claude, Google Yapay Zeka Özetleri ve Yapay Zeka Modu) müşterilerinizin sorularını yanıtlar ve kaynak olarak sayfaları gösterir.
• Yapay zeka ajanları (Claude Code, Cursor, Codex, özel asistanlar) Markdown dosyaları veya bir MCP sunucusu aracılığıyla genellikle bir görevi yerine getirmek için dokümanlarınızı okur.

Her ikisi de hızla büyüyor. Stack Overflow'un 2025 anketi, geliştiricilerin %84'ünün yapay zeka araçlarını kullandığını veya kullanmayı planladığını buldu ve Similarweb, Haziran 2025'te yapay zeka platformlarından 1,13 milyar yönlendirme ziyareti olduğunu, bunun bir önceki yıla göre %357 artış gösterdiğini ve ChatGPT'nin bunların %80'inden fazlasını gönderdiğini hesapladı. Google bir yapay zeka özeti gösterdiğinde, insanlar daha az tıklıyor: Pew Research, kullanıcıların yapay zeka özeti olmayan ziyaretlerin %15'ine kıyasla, yapay zeka özeti olan ziyaretlerin %8'inde bir sonuç bağlantısına tıkladığını buldu. Cevap tıklama olmadan gösteriliyorsa, cevabın doğru olması gerekir ve bu da ancak dokümanlarınız kadar doğrudur. Müşterilerin nerede yardım aradığına dair daha fazla sayı, müşteri self-servis istatistiklerimizde mevcuttur.

Yapay zeka tarayıcıları yardım merkezinizi gerçekten okuyabiliyor mu?#

Bunu önce kontrol edin, çünkü cevap hayır ise başka hiçbir şeyin önemi yoktur.

Metin HTML içinde mi? Vercel'in Aralık 2024 tarihli tarayıcı trafiği analizi, başlıca yapay zeka tarayıcılarının hiçbirinin JavaScript oluşturmadığını, Google'ın Gemini tarayıcısı ve Apple'ınki hariç, buldu. Makalelerini istemci tarafı JavaScript ile yükleyen bir yardım merkezi, ChatGPT ve Claude'un tarayıcılarına boş görünebilir. Test edin:

curl -s -A "GPTBot" https://help.example.com/your-article \
  | grep "a sentence from the article"

Cümle yanıtta yoksa, tarayıcı da onu görmüyor demektir. Sunucu tarafında oluşturulan veya önceden oluşturulan sayfalar bunu düzeltir.

URL'leriniz çözümleniyor mu? Aynı Vercel verilerinde, ChatGPT ve Claude'un tarayıcı getirmelerinin yaklaşık %35'i 404 sayfalarına ulaşıyor. Makaleleri taşıdığınızda veya yeniden adlandırdığınızda yönlendirmeleri koruyun ve site haritasını güncel tutun. Platform değiştiriyorsanız, bir yardım merkezi taşıma kontrol listesini takip edin.

Sayfa herkese açık mı? Cevap motorları giriş arkasındaki sayfaları okuyamaz. Müşteriler için özel dokümanlarınız varsa, yapay zeka yanıtlarının bunun yerine herkese açık sayfalarınızdan, forumlardan ve üçüncü taraf sitelerden geleceğini kabul edin.

robots.txt dosyanız hangi yapay zeka botlarına izin vermeli?#

Her yapay zeka şirketi eğitim ve arama için ayrı botlar çalıştırır. "Tüm yapay zeka botlarını" engellemek, sizi yapay zeka yanıtlarından da çıkarır.

Ayrıntılar her şirketin kendi dokümantasyonundan gelir: OpenAI, Anthropic ve Perplexity. Alıntılanmak isteyen ancak eğitim için kullanılmak istemeyen bir yardım merkezi şunu söyleyebilir:

User-agent: GPTBot
Disallow: /

User-agent: ClaudeBot
Disallow: /

User-agent: Google-Extended
Disallow: /

User-agent: *
Allow: /

Sitemap: https://help.example.com/sitemap.xml

Kendi grubu olan bir bot * kurallarını görmezden gelir, bu yüzden her adlandırılmış grupta Disallow satırlarını (örneğin /admin) tekrarlayın. Google-Extended'ı engellemek ayrıca Gemini Uygulamalarının yanıtları sayfalarınızda temellendirmesini durdurur; Google Arama ve Yapay Zeka Özetleri etkilenmez.

Ayrıca CDN'nizi veya güvenlik duvarınızı kontrol edin. Oradaki bir "yapay zeka botlarını engelle" düğmesi, izin veren bir robots.txt'yi geçersiz kılabilir.

Yapay zekanın doğru yanıt vermesi için yardım makalelerini nasıl yazmalısınız?#

Cevap motorları tüm sitenizi değil, bir pasajı çeker. Her pasaj kendi başına ayakta durabilmelidir.

• Makale başına bir görev, müşterilerin sorduğu şekilde adlandırılmış. "Aboneliğinizi iptal edin veya duraklatın", "Abonelik yönetimi" değil.
• Önce cevap verin. Her başlığın altındaki ilk iki cümle o başlığı yanıtlamalıdır. Yardım merkezi makale şablonumuz bu şekilde oluşturulmuştur.
• Koşulları belirtin. Hangi plan, hangi rol, hangi platform. "Sadece yöneticiler bir çalışma alanını silebilir" alıntılanabilir; "bir çalışma alanını silebilirsiniz" diğer herkes için yanlış yanıtlar üretir.
• Ürünün ne yapamadığını söyleyin. Asistanlara genellikle "yapabilir miyim...?" diye sorulur. Dokümanlarınız sadece var olanı tanımlıyorsa, model tahmin yürütür.
• Her şey için bir isim kullanın ve bir kez tanımlayın. "Çalışma alanı", "hesap" ve "organizasyon" aynı anlama geliyorsa, birini seçin ve ürününüzün terimlerini tanımlayan kısa bir sözlük sayfası tutun.
• Her sayfaya temiz meta veriler verin. Belirli bir başlık, tek satırlık bir açıklama, son güncellenme tarihi ve geçerli olduğu durumlarda plan veya ürün alanı. Cevap motorları ve kendi aramanız, bir soruyu hangi sayfanın yanıtladığına karar vermek için bunları kullanır.
• Adımları resimlerde veya videolarda gizlemeyin. Her ekran görüntüsüne gerçek bir alt metin verin ve videonun gösterdiği her adımın metin olarak da var olduğundan emin olun.
• Uç durumlar öncesinde temelleri ele alın. Yardım merkezini hala oluşturuyorsanız, yapay zeka ile bilgi tabanı oluşturma ile başlayın.
• Güncel tutun. Güncel olmayan bir makale artık güvenle tekrarlanan güncel olmayan bir yanıttır. Dokümantasyonu güncel tutma rehberimiz sürüm sürüm bir rutini kapsar ve her sürümde dokümantasyonu otomatik güncelleme, bunu doğrudan sürümün kendisinden nasıl başlatacağınızı gösterir.

Google aynı şeyi daha sade kelimelerle söylüyor: yapay zeka özellikleri için, normal SEO'nun ötesinde "ek bir gereksinim yoktur" ve özel bir optimizasyona gerek yoktur. Rehberi ayrıca yapay zeka için içeriğinizi küçük parçalara bölme gereksinimi olmadığını belirtir, bu yüzden bir modele uyması için makaleleri parçalara ayırmayın.

Dokümantasyon için llms.txt eklemeli misiniz?#

Satıcıların önerdiğinden daha az yardımcı olur. llms.txt, sitenizin kök dizininde bulunan ve en yararlı sayfalarınızı kısa açıklamalarla listeleyen bir Markdown dosyasıdır. Jeremy Howard bunu Eylül 2024'te dil modelleri için bir harita olarak önerdi.

Şu ana kadarki kanıtlar:

• Google bunu görmezden gelir. Google'ın kılavuzu, Google Arama'da görünmek için yeni makine tarafından okunabilir dosyalara, yapay zeka metin dosyalarına, biçimlendirmeye veya Markdown'a ihtiyacınız olmadığını ve llms.txt dosyalarının ne yardımcı olacağını ne de zarar vereceğini, çünkü Arama'nın bunları görmezden geldiğini belirtir. 2025'te Google'dan John Mueller, llms.txt'yi anahtar kelime meta etiketiyle karşılaştırmıştı.
• Çok az bot bunu ister. Ahrefs, 137.210 alan adını inceledi ve llms.txt dosyalarının %97'sinin Mayıs 2026'da sıfır istek aldığını buldu. Yapay zeka getirme botları gelen isteklerin sadece %1,1'ini oluşturuyordu (yapay zeka asistanları ise %2,5'ini); Claude Code gibi kodlama aracıları en çok adı geçen okuyucular arasındaydı.

Özetle: Dokümantasyon platformunuz ücretsiz sunuyorsa bir llms.txt ekleyin, özellikle geliştiriciler dokümanlarınızı kodlama aracılarıyla kullanıyorsa; ancak ChatGPT'nin hakkınızda söylediklerini değiştirmesini beklemeyin. llms-full.txt (tüm sayfalar tek bir dosyada) önerinin bir parçası değil, yaygın bir gelenektir.

Dokümanlarınız Markdown olarak sunulmalı mı?#

Hiçbir maliyeti yoksa evet. Bir sayfayı getiren aracılar, navigasyon ve betiklerle dolu HTML yerine temiz Markdown ile daha iyi çalışır ve llms.txt önerisi, her sayfanın .md eklenmiş şekilde aynı URL'de sunulmasını önerir. Üç detay:

• Markdown kopyalarını noindex olarak işaretleyin (bir X-Robots-Tag başlığı iş görür), böylece arama motorları bunları HTML sayfalarının kopyası olarak görmez.
• HTML ile aynı kaynaktan üretilmelerini sağlayın, böylece asla sapma olmaz.
• Aracılar onları bulabilsin: öneri, her HTML sayfasında bir <link rel="alternate" type="text/markdown"> etiketi kullanılmasını önerir.

Yapay zeka aracıları dokümantasyonu MCP üzerinden nasıl kullanır?#

Model Context Protocol, bir yapay zeka uygulamasının araçları çağırmasına ve diğer sistemlerden veri okumasına olanak tanıyan açık bir standarttır. Bir doküman MCP sunucusu, bir aracının eğitim sırasında öğrendiklerine güvenmek yerine dokümanlarınızda talep üzerine arama yapmasına ve doğru izinlerle sayfaları taslak haline getirmesine veya güncellemesine olanak tanır. Mevcut sunucuların karşılaştırması için dokümantasyon için MCP sunucuları bölümüne bakın.

Kendi asistanınızı dokümanlarınız üzerinde oluşturursanız (RAG - retrieval-augmented generation) aynı kurallar geçerlidir: sadece getirdiği pasajlar kadar doğru olabilir. İki uyarı: bir kişi yazılanları incelemedikçe müşteriyle yüz yüze olan hiçbir şeye salt okunur erişim vermeyin ve MCP'nin kullanıcılarınızın kendilerinin bağladığı aracılara yardımcı olduğunu unutmayın. Halka açık cevap motorlarının söylediklerini değiştirmez.

Yapay zeka asistanlarının ürününüz hakkında ne söylediğini nasıl test edersiniz?#

Kimse modellerin içine bakamaz, bu yüzden çıktıyı test edin. Ayda bir kez:

1. Destek taleplerinden ve başarısız yardım merkezi aramalarından 20 gerçek müşteri sorusu yazın.
2. Her birini ChatGPT, Perplexity, Claude ve Google'da (Yapay Zeka Modu veya Yapay Zeka Özetleri) sorun.
3. Cevabın doğru olup olmadığını ve hangi sayfayı kaynak gösterdiğini kaydedin.

4. Her yanlış cevabın gelmesi gereken makaleyi düzeltin, ardından gelecek ay tekrar sorun.

Trafik tarafını görmek için ziyaretleri yönlendirene göre (chatgpt.com, perplexity.ai, claude.ai) segmentlere ayırın ve sunucu günlüklerinizi yukarıdaki tablodaki bot isimleri için kontrol edin (kendi kullanıcı aracısı olmayan Google-Extended hariç). Google, Arama Konsolu'nun Performans raporundaki yapay zeka özelliklerinden gelen tıklamaları Web arama türü altında sayar.

Dokümantasyon yapay zeka için nasıl hazır hale getirilir: kontrol listesi#

Clevera yardım merkezleri yapay zeka okuyucuları için nasıl oluşturulur#

Clevera, bir ekran kaydını anlatımlı bir nasıl yapılır videosuna, adım adım bir yardım makalesine ve barındırılan yardım merkezinizdeki bir sayfaya 74 dilde dönüştüren bir yapay zeka platformudur. Barındırılan yardım merkezleri, Ücretsiz dahil her planda kontrol listesinin teknik yarısının çoğunu halleder:

• Önceden oluşturulmuş sayfalar ve bir site haritası, böylece makale metni tarayıcıların getirdiği HTML'dedir.
• Her sayfanın llms.txt, llms-full.txt ve .md kopyası, varsayılan olarak açık olan llms.txt ve Markdown kopyaları ("Yapay zeka araçlarının dokümanlarınızı okumasını sağlar") ayarı altında. Kendi yardım merkezimizde Markdown kopyaları noindex ile sunulur. Özel yardım merkezleri (Pro ve üzeri) tüm bunları girişin arkasında tutar.
• Okuyucularınız için Yapay Zekaya Sor (Ayarlar → Yapay zeka asistanı kısmından Asistanı göster'i açın; Ücretsiz planda ayda 300 cevap). Yerleşik asistan sadece yayınlanmış sayfalarınızdan cevap verir, kaynaklarını bağlar, dokümanlar bir soruyu kapsamadığında bunu belirtir ve bu soruları Cevaplanmamış sorular altında listeler, böylece bir sonraki adımda ne yazacağınızı bilirsiniz (yardım merkezi içerik boşlukları rehberimiz bunların nasıl çözüleceğini gösterir).
• Yapay zeka aracıları ve MCP (Pro ve üzeri). Claude Code, Codex, Cursor, Claude veya ChatGPT, Clevera'nın MCP sunucusu ve API'si aracılığıyla yardım merkezinizi arayabilir, taslak oluşturabilir ve yayınlama haklarıyla güncelleyebilir. Bir Destek asistanı belirteci yalnızca yayınlanmış, herkese açık sayfaları arayabilir.

Bu, kendi yardım merkezimizin yayınladığı llms.txt'in üst kısmıdır (kısaltılmıştır):

# Clevera Help Center

> Clevera turns screen recordings into polished videos: record your screen
> or let the AI record a website, edit with zooms, captions and AI
> voice-overs, then share or embed the result. ...

Every page is also available as Markdown: append `.md` to its URL.
The full text of all pages is at https://help.clevera.ai/llms-full.txt.

### Getting started

- [Understand what Clevera makes](https://help.clevera.ai/docs/getting-started/what-clevera-makes.md): ...

Yazma kısmı hala size ait ve Clevera orada da yardımcı olur: bir ekran kaydından oluşturulan makaleler, ekrandakilerin ekran görüntülerini içeren numaralandırılmış adımlar olarak çıkar ve bir videonun arkasındaki kayıt da yazılı makalesini üretebilir, böylece adımlar sadece bir videoda yaşamaz. Hiçbir platform ChatGPT'nin sizi kaynak göstereceğine söz veremez, biz de vermiyoruz.

Ücretsiz başlayın barındırılan bir yardım merkezi ile veya mevcut olanı Zendesk, Intercom, GitBook ve diğer platformlardan içe aktarın. Ayarlar Doküman sitesini kimlerin okuyabileceğini kontrol et, Doküman sitesi asistanını kur ve Yapay zeka aracılarını doküman sitelerinize bağlayın bölümlerindedir. Ürün genel bakışı yardım merkezi yazılımı sayfasında ve doküman siteleri lansman gönderimizde mevcuttur.

SSS#

llms.txt bir yardım merkezine eklemeye değer mi?#

Platformunuz ücretsiz oluşturuyorsa ekleyin. Hiçbir maliyeti yoktur ve kodlama aracıları onu okur, ancak Google onu kullanmaz ve çalışmalar yapay zeka arama botlarından neredeyse hiç istek gelmediğini gösterir. Taranabilir HTML ve net, güncel makaleler çok daha önemlidir.

ChatGPT'nin ürünüm hakkındaki soruları doğru cevaplamasını nasıl sağlarım?#

OAI-SearchBot'un herkese açık yardım merkezinizi tarayabildiğinden, makale metninin HTML'de olduğundan ve her makalenin belirtilen koşullarla bir soruyu cevapladığından emin olun. Ardından gerçek müşteri sorularını aylık olarak test edin ve yanlış cevapların arkasındaki sayfaları düzeltin. Bu şansı artırır; kimse ChatGPT'nin sizi kaynak göstermesini sağlayamaz.

GPTBot ve ClaudeBot'u engellemeli miyim?#

Bu bir görünürlük kararı değil, bir eğitim kararıdır. GPTBot ve ClaudeBot'u engellemek dokümanlarınızı model eğitiminin dışında tutar; sizi OAI-SearchBot ve Claude-SearchBot kullanan ChatGPT veya Claude aramasından kaldırmaz. Kaynak gösterilmek istiyorsanız bunları engellemeyin.

Yapılandırılmış veri Yapay Zeka Özetlerine yardımcı olur mu?#

Google, yapay zeka özellikleri için özel bir şemaya gerek olmadığını söylüyor. Yapılandırılmış veriyi, normal arama için yaptığınız gibi, görünür içeriği tanımladığı yerlerde kullanın.

Yapay zeka için hazır dokümanlar ile yardım merkezimdeki bir yapay zeka sohbet botu arasındaki fark nedir?#

Yapay zeka uyumlu dokümanlar, dış asistanların sayfalarınızdan yanıt vermesine yardımcı olur. Clevera'nın Ask AI'ı gibi bir yardım merkezi sohbet botu, okuyucularınızı kendi sitenizde aynı sayfalardan yanıtlar. Her ikisi de net ve güncel makalelere bağlıdır.