vellTRDocs
RehberlerMCP Sunucusu ve Yapay Zeka Araçları

MCP Sunucusu ve Yapay Zeka Araçları

Başlangıç5 min

Kvell dokümantasyon MCP sunucusunu Claude, Cursor veya ChatGPT'ye bağlayın ve llms.txt ile geliştirme yapın.

Bu dokümantasyon sitesi aynı zamanda yapay zeka destekli kod asistanınızın doğrudan sorgulayabileceği canlı bir veri kaynağıdır — MCP (Model Context Protocol) üzerinden ya da indeksleme ve RAG için düz metin (markdown) olarak. Uç nokta dokümanlarını bir sohbet penceresine yapıştırmak yerine aracınızı aşağıdaki seçeneklerden birine yönlendirin.

MCP sunucusuna bağlanın

Dokümantasyon sitesi, streamable-HTTP üzerinden bir MCP sunucusu sunar:

Shell
https://docs.kvell.group/api/mcp

Claude Code

Shell
claude mcp add --transport http kvell-docs https://docs.kvell.group/api/mcp

Cursor / VS Code

MCP yapılandırma JSON'unuza ekleyin:

JSON
{
  "mcpServers": {
    "kvell-docs": {
      "url": "https://docs.kvell.group/api/mcp"
    }
  }
}

ChatGPT

Ayarlar → Bağlayıcılar (Connectors) → Bağlayıcı ekle, ardından URL olarak https://docs.kvell.group/api/mcp adresini yapıştırın.

Kullanılabilir araçlar

AraçArgümanlarDöndürdüğü
search_docsqueryRehberler ve API referansı genelinde sıralanmış eşleşmeler
list_endpointscategory?Uç nokta listesi, isteğe bağlı olarak tek bir kategoriye göre filtrelenmiş (payments, payouts, submerchants, …)
get_endpointidMarkdown olarak tam uç nokta dokümanı — yöntem, yol, başlıklar, parametreler, istek/yanıt örnekleri
get_guideslug, locale?Markdown olarak tam bir rehber (bu sayfa gibi)

Tipik bir oturum: asistanınıza "Kvell'de bölünmüş bir ödemeyi nasıl iade ederim" gibi bir şey sorun — asistan search_docs aracını çağırır, get_guide / get_endpoint üzerinden ilgili rehber ve uç nokta dokümanlarını çeker ve eğitim verisi yerine güncel dokümanlara dayanarak yanıt verir.

Geri kalan her şey için düz markdown

Her araç MCP konuşmaz. Aynı içerik düz markdown olarak da mevcuttur:

Yolİçerik
/llms.txtHer rehberin ve uç noktanın markdown bağlantıları biçiminde bir dizini — hafif bir tarama için uygundur
/llms-full.txtTüm dokümantasyon sitesi tek bir dosyada — bir RAG hattına tek seferde aktarım için uygundur
<herhangi bir sayfa>.mdURL'sinin sonuna .md ekleyerek herhangi bir sayfanın ham markdown'ı
Shell
curl https://docs.kvell.group/guides/marketplace-payments.md

Her sayfada, aynı ham markdown'ı panonuza kopyalayan bir Copy page düğmesi de bulunur — tarayıcıdan çıkmadan tek bir rehberi bir sohbete yapıştırmak için kullanışlıdır.

Hangisini ne zaman kullanmalı

  • MCP — asistanınızın anlık olarak bilgiye ihtiyaç duyduğu etkileşimli bir kodlama oturumu için.
  • /llms.txt / /llms-full.txt — dokümanları kendi arama veya RAG sisteminize indekslemek için.
  • .md uzantısı veya Copy page — tek bir sayfayı, tek seferlik almak için.

Sonraki adımlar

RehberNeyi kapsar
BaşlarkenBurada yeniyseniz, ilk imzalı isteğiniz
API referansıTaranabilir ve makine tarafından okunabilir her uç nokta
← Going Live