MCP Entegrasyonu

SupportBot, Model Context Protocol (MCP) sunucusuyla gelir: Claude ve MCP destekleyen diğer yapay-zekâ istemcileri, destek platformunuzu 44 araçla doğrudan yönetebilir — konuşmaları inceleme, bilgi tabanına doküman yükleme, test senaryosu koşturma, haftalık rapor tetikleme ve daha fazlası.

Uç nokta

Alan	Değer
URL	`https://showcase.<alan-adınız>/api/mcp`
Taşıma	Streamable HTTP (MCP standardı; `POST`/`GET`/`DELETE`)
Kimlik doğrulama	`Authorization: Bearer <API anahtarı>`
Hız sınırı	Anahtar başına dakikada 60 istek
Oturum	Durum korumalı; 30 dakika boşta kalan oturum kapatılır

API anahtarı oluşturma

Yönetim panelinde Ayarlar → API Anahtarları sekmesini açın.
Anahtara bir ad verin (örn. "Claude Desktop") ve oluşturun.
sk_showcase_ ile başlayan anahtar yalnızca bir kez gösterilir — güvenli bir yere kaydedin. Sunucu tarafında anahtarın kendisi değil, SHA-256 özeti saklanır.
Kullanılmayan anahtarları aynı ekrandan iptal edebilirsiniz. Her MCP çağrısı, çağrıyı yapan anahtara ve kullanıcıya kayıtlanır (denetim izi).

Claude'a bağlama

Claude Code (CLI):

claude mcp add supportbot \
  --transport http https://showcase.<alan-adınız>/api/mcp \
  --header "Authorization: Bearer sk_showcase_..."

Claude Desktop / diğer istemciler: MCP sunucu ayarlarına aynı URL'i Streamable HTTP taşımasıyla ekleyin ve Authorization başlığına anahtarınızı yazın.

Bağlantıyı tarayıcıdan denemek için showcase uygulamasındaki /mcp-test sayfasını kullanabilirsiniz.

Araç kataloğu

Araçlar MCP davranış ipuçlarıyla (salt-okunur / yazan / dış sisteme çıkan) işaretlidir; istemciniz onay akışını buna göre gösterir.

İzleme ve konuşmalar (salt-okunur)

Araç	İşlev
`get_overview`	Genel Bakış metrikleri (konuşma sayıları, çözüm oranı)
`get_recent_conversations`	Son konuşmalar; konu/duygu/saat filtreleri
`get_conversation`	Tek konuşmanın ayrıntısı
`get_quality_report`	Bot kalite raporu
`get_system_health`	Servis sağlık durumu (Chatwoot, Dify, DB, Redis)

Bilgi tabanı

Araç	İşlev
`list_datasets` / `list_documents`	Veri kümelerini ve dokümanları listeler
`upload_document`	Bilgi tabanına doküman yükler
`get_document_status`	İndeksleme durumunu izler
`delete_document`	Doküman siler
`query_knowledge`	Bilgi tabanında arama (RAG sorgusu)
`get_knowledge_stats`	KB istatistikleri

Yapılandırma ve görünüm

Araç	İşlev
`get_config` / `update_config`	Bot yapılandırması (ad, karşılama, LLM modeli…)
`get_appearance` / `set_appearance`	Widget renkleri ve görünümü
`get_widget_config` / `update_widget_config`	Widget yapılandırması
`get_widget_snippet`	Siteye eklenecek embed kodu
`list_topics` / `create_topic` / `update_topic` / `delete_topic`	Konu taksonomisi (silme = arşivleme)

Personalar ve test

Araç	İşlev
`list_personas` / `list_customer_personas`	Bot ve müşteri personaları
`create_bot_persona` / `update_bot_persona` / `delete_bot_persona`	Persona yönetimi
`set_default_persona`	Varsayılan personayı değiştirir
`list_scenarios` / `run_scenario`	Test senaryolarını listeler/koşturur
`run_acceptance_suite`	Kabul test paketini koşturur
`run_rag_eval`	Uçtan uca RAG doğrulama testi
`run_rag_metrics`	Ragas-tarzı RAG metrikleri (faithfulness, context precision/recall…)
`send_test_message` / `test_model` / `classify_message`	Tekil test çağrıları

Raporlar ve operasyon

Araç	İşlev
`list_reports` / `get_report`	Haftalık raporları listeler/okur
`trigger_weekly_report`	Rapor üretimini elle tetikler
`submit_conversation_feedback`	Konuşmaya operatör geri bildirimi ekler
`list_webhook_events` / `retry_webhook_event`	Webhook kuyruğunu izler/yeniden dener
`list_api_keys`	API anahtarlarını listeler

Güvenlik notları

Uç nokta, tarayıcı kaynaklı istekler için Origin doğrulaması yapar (DNS-rebinding koruması). Claude Desktop/CLI gibi tarayıcı-dışı istemciler etkilenmez; ek güvenilir tarayıcı origin'leri MCP_ALLOWED_ORIGINS ortam değişkeniyle tanımlanır.
Anahtarlar geri alınamaz şekilde özetlenerek saklanır; sızdığından şüphelendiğiniz anahtarı panelden iptal edip yenisini oluşturun.
Yazan araçlar (yapılandırma, doküman, konu) denetim günlüğüne işlenir.