Model Context Protocol (MCP) Entegrasyonu

Model Context Protocol (MCP), Anthropic tarafından geliştirilen ve Büyük Dil Modelleri (LLM’ler), AI destekli IDE’ler (Cursor, Windsurf) ve otonom kodlama ajanlarının dış veri kaynakları, operasyonel araçlar ve API’ler ile güvenli biçimde konuşmasını sağlayan açık bir protokoldür.

HashEntry, geliştiricilerin ve uyumluluk yöneticilerinin çerez taramalarını otomatikleştirmesini, rıza afişlerini yapılandırmasını, yasal politikaları düzenlemesini ve KVKK/GDPR uyumluluk istatistiklerini doğrudan IDE veya yapay zeka istemcilerinden doğal dille sorgulamasını sağlayan resmi Streamable-HTTP MCP sunucuları sunar.

Mimari ve Erişim Seviyeleri

HashEntry, farklı güvenlik ve yetki gereksinimlerine göre özelleştirilmiş üç ayrı MCP uç noktası sağlar:

Uç Nokta (Endpoint)	Yetki Türü	Kimlik Doğrulama	Yetenekler ve Kapsam
`https://system.hashentry.com/mcp/public`	Genel (Public)	Gerekmez (Anonim)	Web sitelerinde anlık CMP analizi, genel çerez kütüphanesi araması, paket fiyatları ve bilgi tabanı sorgulama.
`https://system.hashentry.com/mcp/tenant`	Müşteri (Tenant)	Bearer Token (`he_mcp_...`)	Kayıtlı siteleri listeleme/ekleme, çerez taraması tetikleme, banner tasarımı güncelleme, aydınlatma ve çerez politikası taslağı kaydetme/yayınlama, rıza oranlarını inceleme.
`https://system.hashentry.com/mcp/reseller`	Bayi (Reseller)	Bearer Token (`he_mcp_...`)	Müşteri portföyü, alt müşteri oluşturma, komisyon ve bakiye takibi, bayi destek biletleri.

Kimlik Doğrulama ve MCP Token Üretimi

Tenant ve Reseller sunucularına gönderilen istekler, HashEntry Kişisel Erişim Anahtarı (Personal Access Token — he_mcp_...) gerektirir.

HashEntry Yönetim Paneli Üzerinden Token Üretimi

HashEntry Yönetim Paneli’ne giriş yapın.
Ayarlar → AI & MCP Anahtarları sayfasına gidin.
Yeni MCP Token Üret butonuna tıklayın, tanıyabileceğiniz bir ad ve geçerlilik süresi belirleyin.
Üretilen he_mcp_... anahtarını kopyalayın ve güvenli bir yerde saklayın.

AI İstemcisi Yapılandırması

1. Cursor IDE Kurulumu

Projenizin kök dizininde .cursor/mcp.json dosyasını oluşturun veya güncelleyin:

{
  "mcpServers": {
    "hashentry-public": {
      "url": "https://system.hashentry.com/mcp/public"
    },
    "hashentry-tenant": {
      "url": "https://system.hashentry.com/mcp/tenant",
      "headers": {
        "Authorization": "Bearer he_mcp_SIZIN_TOKENINIZ"
      }
    }
  }
}

2. Claude Desktop Kurulumu

Bilgisayarınızdaki claude_desktop_config.json dosyasını açın:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Sunucu tanımını ekleyin:

{
  "mcpServers": {
    "hashentry": {
      "url": "https://system.hashentry.com/mcp/tenant",
      "headers": {
        "Authorization": "Bearer he_mcp_SIZIN_TOKENINIZ"
      }
    }
  }
}

Kullanılabilir MCP Araçları (Tools)

1. Genel Araçlar (`/mcp/public`)

Hesap veya giriş gerektirmeden çalışır:

start_cmp_scan: Herhangi bir web adresinde kapsamlı çerez ve gizlilik denetimi başlatır.
get_cmp_scan_status: Devam eden bir taramanın arka plan durumunu sorgular.
get_cmp_scan_report: Tamamlanan taramanın kategorize edilmiş çerezlerini, scriptlerini ve uyumluluk puanını getirir.
search_cookie_definitions: HashEntry global veritabanında çerez adı, sağlayıcı ve varsayılan saklama sürelerini arar.
get_pricing_plans: Aktif abonelik paketlerini ve kota limitlerini listeler.
search_knowledge_base: HashEntry resmi belgelerinde, hukuki SSS içeriklerinde ve kılavuzlarda arama yapar.

2. Müşteri Araçları (`/mcp/tenant`)

Müşteri hesabı ve geçerli bir token gerektirir:

list_sites: Hesabınıza bağlı tüm web sitelerini listeler.
get_site: Belirli bir sitenin API anahtarlarını, etki alanını ve ayarlarını getirir.
create_site: Sisteme yeni bir web sitesi veya mobil uygulama alanı ekler.
trigger_site_cookie_scan: Kayıtlı sitede otomatik çerez taraması başlatır.
list_site_cookies: Sitede tespit edilmiş tüm çerezleri ve kategori atamalarını listeler.
get_banner_config: Çerez bildirim banner’ının renk, tema, konum ve mevzuat ayarlarını çeker.
update_banner_config: Banner’ın görünüm ve davranış parametrelerini günceller.
list_documents: Aydınlatma metinlerini, gizlilik ve çerez politikalarını listeler.
get_document: Belirli bir yasal metnin markdown veya HTML içeriğini getirir.
save_document_draft: Yapay zeka ile hazırladığınız yeni madde veya revizyonları taslak olarak kaydeder.
publish_document: Onaylanan yasal metni yeni bir sürüm numarasıyla yayına alır.
get_consent_stats: Ziyaretçi rıza onay, ret ve kategori kabul yüzdelerini raporlar.
list_tickets & create_ticket: Teknik destek taleplerini listeler ve yeni bilet açar.
get_quota_usage: Kullanılan tarama, site ve API kotalarını gösterir.

3. Bayi Operasyon Araçları (`/mcp/reseller`)

Bayi yetkisi gerektirir:

get_reseller_dashboard: Toplam alt müşteri sayısı, komisyon bakiyesi ve ödeme durumlarını görüntüler.
list_reseller_tenants: Bayi bünyesindeki tüm müşteri organizasyonlarını listeler.
create_reseller_tenant: Yeni bir müşteri hesabı ve alanı açar.
list_commissions: Detaylı komisyon hakediş hareketlerini döker.
list_reseller_tickets & create_reseller_ticket: Öncelikli bayi destek kanalını yönetir.

Örnek Yapay Zeka Komutları (Promptlar)

Cursor veya Claude’a yapay zeka üzerinden şu tür komutlar verebilirsiniz:

“https://sitem.com adresini KVKK ve GDPR açısından tara, izinsiz çalışan pazarlama çerezlerini listele.”

“HashEntry’deki kayıtlı web sitelerimi listele ve son 30 günlük çerez onaylama oranlarını kıyasla.”

“Çerez Politikası metnimize Google Consent Mode v2 entegrasyonuyla ilgili açıklayıcı bir paragraf ekle ve taslak olarak kaydet.”

“Web sitemizin rıza banner’ını modern koyu tema ve yuvarlatılmış köşeler olacak şekilde güncelle.”