Ana içeriğe atla

MCP nedir?

Model Context Protocol (MCP), yapay zeka asistanlarının (Claude Code, Cursor, Windsurf vb.) harici araçları ve verileri kullanmasını sağlayan açık bir standarttır. @leaderos/headless-mcp paketi, asistanınıza sizin sitenizin Headless API’sini tanıtan bir MCP sunucusudur. MCP olmadan asistan API’yi tahmin eder ve hatalı endpoint/alan adı üretebilir. MCP ile ise:
  • Endpoint’leri arar ve gerçek parametre/yanıt şemalarını okur,
  • Sitenizin gerçek yapılandırmasına bakar (hangi modüller açık, hangi captcha sayfaları var),
  • Canlı sitenizden örnek yanıt alıp ona göre arayüz yazar.

Kurulum

Gereksinim: Node.js 18.18+. Paket npx ile çalıştırılır, ayrıca kurmanız gerekmez.
Şablondaki .mcp.json değerleri ${LEADEROS_URL} ve ${LEADEROS_PUBLIC_KEY} ortam değişkenlerinden okur. Değerler .env.local içinde de bulunur; gerekirse doğrudan değer yazabilirsiniz.

Ortam değişkenleri

LEADEROS_ALLOW_WRITE=1 ayarını yalnızca test sitesinde açın. Yapay zeka gerçek siparişler, kredi transferleri veya forum gönderileri oluşturabilir.

Araçlar

Ayrıca bir kaynak (resource) sunar: leaderos://llms-full.txt (tüm API referansı).

Örnek kullanım

Asistanınıza şunu yazabilirsiniz:
“Mağazadaki ürünleri kategoriye göre listeleyen bir sayfa yap. Önce hangi modüllerin açık olduğuna bak.”
Asistan şu sırayı izler:
  1. get_site_config → store modülünün aktif olduğunu görür.
  2. search_endpoints("store products") → GET /store/... endpoint’lerini bulur.
  3. get_endpoint ve get_schema("StoreProduct") → alan adlarını öğrenir.
  4. call_endpoint → gerçek ürün verisini görür.
  5. scaffold_page ile iskeleti alır ve tasarımınıza uyarlar.

Güvenlik

  • Varsayılan mod salt okunurdur.
  • MCP sunucusu yalnızca sizin makinenizde çalışır; site anahtarınız üçüncü taraflara gönderilmez.
  • Public key hassas değildir ancak yine de depoya commit etmeyin; .env.local .gitignore’dadır.

Sorun giderme