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+. Paketnpx ile çalıştırılır, ayrıca kurmanız gerekmez.
- Claude Code
- .mcp.json (Cursor vb.)
Ş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
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:
get_site_config→storemodülünün aktif olduğunu görür.search_endpoints("store products")→GET /store/...endpoint’lerini bulur.get_endpointveget_schema("StoreProduct")→ alan adlarını öğrenir.call_endpoint→ gerçek ürün verisini görür.scaffold_pageile 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.
