Core/Dash MCP Sunucusu

AI ajanını gerçek zamanlı veriyle besle 

Sorun şu: Geliştiriciler Claude veya Cursor'ı açıp bir Core Web Vitals sorununu tarif ediyor ve yardım istiyor. AI, genellemelere dayalı, son derece makul bir cevap veriyor. Tahmin yürütüyor. Genel tavsiyeler sunuyor. LCP elemanının gerçekte ne olduğunu bilmeden sana "LCP elemanını kontrol etmeni" öneriyor.

CoreDash MCP sunucusu, MCP uyumlu herhangi bir AI ajanına gerçek zamanlı, Real User Monitoring verilerine doğrudan erişim sağlar. Tüm kırılım aşamalarıyla birlikte 5 Core Web Vitals'ın tamamı ve 25 filtre boyutu (kontrol panelini besleyen verilerin aynısı).

Tahmin yürütmek yerine, AI sana mobildeki LCP değerinin 3.102 ms olduğunu, çünkü div.hero-image > img görselinin fetchpriority="high" olmayan 2,4 MB'lık optimize edilmemiş bir JPEG olduğunu söyleyebilir. Geçen perşembe günkü deploy'un, sadece button.add-to-cart ile sınırlı %18'lik bir INP regresyonuna sebep olduğunu belirtebilir. Frankfurt'taki CDN edge noktasına ulaşamadığın için Almanya'daki TTFB değerinin 1.400 ms olduğunu gösterebilir.

Nasıl çalışıyor

MCP (Model Context Protocol) kendi kendini tanımlar. AI'ın bağlandığında sunucu ona hangi metriklerin var olduğunu, nasıl filtreleneceğini ve her parametrenin ne işe yaradığını söyler. Sen bağlanırsın, gerisini ajan kendi çözer.

Arka planda: durumsuz (stateless) HTTPS POST, JSON-RPC 2.0, Bearer token kimlik doğrulaması. Her istek bağımsızdır. Oturum yok, WebSocket yok. İstek/yanıt örnekleriyle birlikte tüm API referansı için CoreDash API dokümantasyonu'na bak.

Başlarken

Planına dahil. MCP erişimi her CoreDash hesabıyla birlikte gelir. Ek paket veya ek satış yok. Bir projen varsa hemen şimdi bir API anahtarı oluşturabilirsin.

Adım 1: API anahtarı oluştur

CoreDash'e giriş yap, projeni aç, AI Insights ve ardından Connect Your AI adımlarını takip et. Anahtara bir isim ver ("Claude Desktop", "Cursor", "CI Pipeline") ve Generate'e tıkla. Anahtarı hemen kopyala. Sadece bir kez gösterilir. Onu SHA-256 ile hash'liyor ve yalnızca bu hash'i saklıyoruz.

Her anahtar tek bir projeye özeldir. İhtiyacın kadar anahtar oluşturabilir ve dilediğini anında iptal edebilirsin. Anahtarları yalnızca proje sahipleri yönetebilir.

Adım 2: MCP istemcini yapılandır

claude mcp add --transport http coredash https://app.coredash.app/api/mcp

claude mcp add --transport http coredash https://app.coredash.app/api/mcp --header "Authorization: Bearer cdk_YOUR_API_KEY"

{
  "mcpServers": {
    "coredash": {
      "url": "https://app.coredash.app/api/mcp",
      "headers": {
        "Authorization": "Bearer cdk_YOUR_API_KEY"
      }
    }
  }
}

Adım 3: Doğrula

Bağlantının çalıştığını doğrulamak için AI'ına basit bir soru sor:

"Mobilde /product için güncel Core Web Vitals değerleri nelerdir?"

Eğer get_metrics aracını çağırıp gerçek sayılar döndürüyorsa, bağlantı aktif demektir.

Üç araç

MCP sunucusunda üç araç bulunur.

get_metrics anlık durum (snapshot) aracıdır. "Mobildeki güncel LCP nedir?" Mevcut durumla ilgili her türlü soru için bunu kullan. Cihaz, ülke, sayfa veya tarayıcıya göre filtrele. Segmentleri karşılaştırmak için dilediğin boyuta göre grupla.

get_timeseries trend aracıdır. "Perşembe gününden beri INP kötüleşti mi?" Zaman içindeki veri noktalarını döndürür ve trendi otomatik olarak iyileşen, sabit veya gerileyen şeklinde sınıflandırır. Grafiği göz kararı incelemek zorunda kalmaman için trendi senin yerine AI yorumlar.

get_histogram dağılım aracıdır. "Mobilde LCP dağılımı nasıl görünüyor?" Verilerinin genel dağılım şeklini gösteren yaklaşık 40 bölme (bucket) döndürür. 2.400 ms seviyesindeki bir p75 değeri, çoğu kullanıcının 2.400 ms civarında olduğu anlamına gelebilir; ya da kullanıcıların %60'ının hızlı olduğunu ve yavaş mobil trafiğin bir kısmının kuyruğu uzattığını gösterebilir. Histogram sana durumun hangisi olduğunu söyler.

Tüm parametre referansları, örnek istekler ve yanıt biçimleri için API dokümantasyonu'na bak.

Gerçek örnek: performansa duyarlı refactoring

Cursor'a MCP bağlıyken yavaş INP etkileşimlerini bulmasını ve bunları gerçek kod sorunlarıyla eşleştirmesini istediğinde olanlar şunlardır:

Ajan gerçek INP atıf (attribution) verilerini kontrol etti, hangi etkileşimlerin kötü olduğunu buldu, sorumlu script'leri bulmak için LOAF verilerine baktı ve sorunları düzeltmeden önce doğru şekilde teşhis etti. Genel best-practice tavsiyeleri ile gerçekte neyin yavaş olduğunu temel alan bir düzeltme arasındaki fark tam olarak budur.

İstek limitleri

MCP istekleri, günlük limitlerini CoreDash AI özellikleri ile paylaşır. Limitler gece yarısı (UTC) sıfırlanır.

Güvenlik

• Ham anahtarlar bir kez gösterilir. Yalnızca SHA-256 hash değerini saklarız.
• Her anahtar tek bir projeye özeldir. Yatay geçiş (lateral movement) yapılamaz.
• Anahtarlar kontrol panelinden anında iptal edilebilir.
• Her anahtar last_used bilgisini takip eder. Eskimiş (stale) anahtarları tespit etmek kolaydır.
• MCP sunucusu salt okunurdur (read-only). API üzerinde hiçbir yazma yolu yoktur.
• Süresi dolan projeler tüm API anahtarlarını otomatik olarak reddeder.