MCP Sunucu Belgeleri

Biscotti CMP MCP Sunucusu, yapay zeka asistanlarının Biscotti CMP hesabınızla programlı olarak etkileşime girmesini sağlar. Web sitelerini, banner'ları, uyumluluk taramalarını, rıza analizlerini, yasal belgeleri ve daha fazlasını — tüm bunları IDE'nizdeki doğal dil komutları aracılığıyla yönetin.

MCP (Model Context Protocol) Sunucusu, yapay zeka asistanınız ile Biscotti CMP API'si arasında bir köprü görevi görür ve geliştirme ortamınızdan doğrudan çağrılabilen bir dizi araç sunar.

Ön koşullar

• Node.js 18 veya üstü
• Bir Ajans veya LTD Ajans planına sahip bir Biscotti CMP hesabı
• Geliştirici Ayarları sayfasından alınan bir API anahtarı

Hızlı Başlangıç

Başlamanın en hızlı yolu şudur: npx — kurulum gerektirmez:

npx @biscotti-cmp/mcp-server

MCP Sunucusunu genel olarak yüklemeden doğrudan çalıştırın. Bu, çoğu kullanıcı için önerilen yöntemdir:

npx @biscotti-cmp/mcp-server

MCP Sunucusunu sisteminizde küresel olarak kurmayı tercih ediyorsanız:

npm install -g @biscotti-cmp/mcp-server

Kurulumdan sonra sunucuyu doğrudan çalıştırabilirsiniz:

biscotti-mcp

Biscotti CMP MCP Sunucusunu Claude Desktop ile kullanmak için, aşağıdaki yapılandırmayı Claude Desktop ayar dosyanıza ekleyin.

Yapılandırma Dosyasının Konumu

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

Ayarlar

Yapılandırma dosyanıza aşağıdakileri ekleyin:

{
  "mcpServers": {
    "biscotti-cmp": {
      "command": "npx",
      "args": ["-y", "@biscotti-cmp/mcp-server"],
      "env": {
        "BISCOTTI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Yapılandırma dosyasını kaydettikten sonra Claude Desktop'ı yeniden başlatın. Biscotti CMP araçları, araçlar menüsünde görünecektir.

Biscotti CMP MCP Sunucusunu Cursor ile kullanmak için, Cursor MCP ayarlarınıza aşağıdaki yapılandırmayı ekleyin.

Yapılandırma Dosyasının Konumu

• Proje düzeyinde: .cursor/mcp.json projenizin kök dizininde
• Global: ~/.cursor/mcp.json

Ayarlar

{
  "mcpServers": {
    "biscotti-cmp": {
      "command": "npx",
      "args": ["-y", "@biscotti-cmp/mcp-server"],
      "env": {
        "BISCOTTI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Kaydettikten sonra, Cursor MCP sunucusunu otomatik olarak algılayacak ve araçları AI asistanında kullanıma sunacaktır.

Biscotti CMP MCP Sunucusunu Kiro ile kullanmak için, MCP ayarları üzerinden yapılandırın.

Yapılandırma Dosyasının Konumu

• Proje düzeyinde: .kiro/settings/mcp.json projenizin kök dizininde
• Dünya çapında: ~/.kiro/settings/mcp.json

Ayarlar

{
  "mcpServers": {
    "biscotti-cmp": {
      "command": "npx",
      "args": ["-y", "@biscotti-cmp/mcp-server"],
      "env": {
        "BISCOTTI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Kiro, MCP sunucu yapılandırmasını otomatik olarak algılayacak ve Biscotti CMP araçlarını kullanıma sunacaktır.

Biscotti CMP MCP Sunucusu, MCP uyumlu tüm istemcilerle uyumludur. Aşağıdaki genel yapılandırmayı kullanın:

Genel Yapılandırma

{
  "mcpServers": {
    "biscotti-cmp": {
      "command": "npx",
      "args": ["-y", "@biscotti-cmp/mcp-server"],
      "env": {
        "BISCOTTI_API_KEY": "your-api-key-here"
      }
    }
  }
}

MCP istemciniz farklı bir yapılandırma biçimi kullanıyorsa, temel parametreler şunlardır:

• Komut: npx
• Gerekçeler: -y @biscotti-cmp/mcp-server
• Ortam değişkeni: BISCOTTI_API_KEY API anahtarınızla ayarlayın

Biscotti CMP'deki web sitelerinizi yönetme araçları.

Onay başlıklarını oluşturmaya ve yönetmeye yarayan araçlar.

Web sitelerini tarama ve uyumluluk durumunu kontrol etme araçları.

Onay istatistiklerine ve analiz verilerine erişim araçları.

Gizlilik politikaları, hizmet şartları ve yasal uyarı sayfaları gibi yasal belgeleri yönetmeye yarayan araçlar.

Tespit edilen üçüncü taraf servisleri ve bunların rıza kategorilerini yönetmek için araçlar.

Gerçek zamanlı olay bildirimleri için webhook entegrasyonlarını yönetme araçları.

Ajans hesabı yönetimi ve müşteri işlemleri için araçlar.

Biscotti CMP MCP Sunucusu, yapay zeka asistanlarının bağlam bilgisi elde etmek için okuyabileceği aşağıdaki kaynakları sunar:

• biscotti://web siteleri — Hesabınızdaki tüm web sitelerinin listesi
• biscotti://website/{id} — Ayrıntılı web sitesi yapılandırması
• biscotti://compliance/{id} — Bir web sitesinin güncel uyumluluk durumu
• biscotti://banners/{websiteId} — Bir web sitesine ait tüm banner'lar

Kaynaklar, yapay zeka asistanlarının değişiklik yapmadan önce mevcut yapılandırmanızı anlamasına yardımcı olan salt okunur bir bağlam sağlar.

MCP Sunucusu, yaygın iş akışları için yerleşik komut istemi şablonları içerir:

Uyum Denetimi

Bir web sitesinde tam bir uyumluluk denetimi gerçekleştirin; çerezleri tarayın, onay ayarlarını kontrol edin ve bir rapor oluşturun.

example.com web sitemde bir uyumluluk denetimi çalıştırın ve iyileştirmeler önerin.

Afiş Kurulumu

Tercih ettiğiniz tasarım ve davranış ayarlarıyla bir onay başlığı oluşturun ve yapılandırın.

Koyu temalı ve sol alt konumlu, GDPR uyumlu bir onay başlığı oluşturun.

Yasal Belge Oluşturma

Web sitenizin yapılandırmasına ve hedef yargı bölgesine göre yasal belgeler oluşturun.

Google Analytics ve Facebook Pixel'i kapsayan Alman web sitem için bir gizlilik politikası oluşturun.

Biscotti CMP MCP Sunucusu, Biscotti CMP API'sinde kimlik doğrulaması yapmak için bir API anahtarına ihtiyaç duyar. MCP Sunucusu tarafından yapılan tüm istekler, API anahtarınız kullanılarak doğrulanır.

Kimlik Doğrulama Nasıl Çalışır?

1. Biscotti CMP kontrol panelinizin Geliştirici Ayarları sayfasında bir API anahtarı oluşturursunuz.
2. API anahtarı, BISCOTTI_API_KEY ortam değişkeni olarak ayarlanır.
3. MCP Sunucusu, tüm API isteklerinde bu anahtarı bir Bearer belirteci olarak ekler.
4. Biscotti CMP API'si anahtarı doğrular ve hesabınızla sınırlı verileri döndürür.

MCP Sunucusu için bir API anahtarı almak için:

1. app.biscotti-cmp.com adresinden Biscotti CMP kontrol panelinize giriş yapın.
2. Kenar çubuğunda "Geliştirici Ayarları"na gidin.
3. API Anahtarları sekmesinde "Yeni Anahtar Oluştur" seçeneğine tıklayın.
4. Anahtarınıza açıklayıcı bir ad verin (örneğin, "MCP Sunucusu - Geliştirme").
5. İsterseniz anahtar için bir son kullanma tarihi belirleyin.
6. Oluşturulan anahtarı hemen kopyalayın — bu anahtar yalnızca bir kez gösterilecektir.

Anahtar Yönetimi Konusunda En İyi Uygulamalar

• Geliştirme ve üretim ortamları için ayrı API anahtarları kullanın.
• Geçici olarak kullanılan anahtarlara son kullanma tarihleri belirleyin.
• Anahtarları düzenli olarak değiştirin ve kullanılmayan anahtarları iptal edin.
• Anahtar değiştirme özelliğini kullanarak kesintiye uğramadan anahtarları değiştirin.