MCP ile bir AI asistanını Helpdash'e bağlayın

Helpdash bir Model Context Protocol (MCP) sunucusu sunar; böylece bir AI asistanı, siz talepleri sohbet penceresine kopyalayıp yapıştırmak yerine doğrudan çalışma alanınızın içinde çalışabilir. "Bugün hangi talepler SLA'yı ihlal ediyor?" ya da "bu yazışmayı vardiya devri için özetle" deyin — asistan sorguyu Helpdash'in kendisine yapar.

Bu yazı, konnektörün neleri sunduğunu, nasıl bağlanacağını ve — iki kez okumaya değen kısım — neleri yapmasına izin verilmediğini kapsar.

Konnektör neleri sunar

Sunucu 46 araç, dört hazır komut istemi ve araçların kabul ettiği tüm enum değerlerini listeleyen bir kaynak taşır. Araçlar; talepleri, canlı sohbeti, bilgi bankasını, hazır yanıtları, projeleri ve ekip arkadaşlarını, kontrol panelini, CSAT'i, otomasyon kurallarını, webhook'ları, ayarları, etkinlik günlüğünü ve faturalandırmayı kapsar.

Okuma ve yazma her zaman ayrı araçlardır. method parametresi olan, her şeyi kapsayan bir api_request aracı yoktur — talepleri aramak ile birini değiştirmek, farklı izinlere sahip farklı araçlardır; dolayısıyla okuma erişimi verilmiş bir asistan bir argümanı değiştirerek hiçbir şeyi değiştiremez.

Dört komut istemi, önceden yazılmış olmaya değen iş akışlarıdır:

• Bir talebi triyaj et — öncelik, kategori ve sorumlu önerir. Hiçbir şeyi değiştirmez.
• Müşteri yanıtı taslağı yaz — metni bilgi bankanız ve hazır yanıtlarınızla hazırlar. Gönderemez; yanıt, sizin gözden geçirmeniz için geri döner.
• Bir yazışmayı özetle — uzun bir talebi ya da sohbet dökümünü vardiya devri için sıkıştırır.
• Haftalık destek raporu — hacim, SLA, CSAT ve dikkat gerektirenler.

Bir istemciyi bağlamak

Ayarlar → AI konnektörleri (MCP) bölümünü açın ve bir jeton çıkarın. Sonradan tanıyacağınız bir etiket verin, ilk jetonunuz için tüm yazma anahtarlarını kapalı bırakın ve anahtarı kopyalayın — yalnızca bir kez gösterilir.

Sonra onu kaydedin. Claude Code için:

claude mcp add --transport http helpdash https://your-workspace.helpdash.io/mcp \
  --header "Authorization: Bearer hd_mcp_..."

.mcp.json okuyan herhangi bir istemci için:

{
  "mcpServers": {
    "helpdash": {
      "type": "http",
      "url": "https://your-workspace.helpdash.io/mcp",
      "headers": { "Authorization": "Bearer hd_mcp_..." }
    }
  }
}

Her iki parça da çalışma alanı adresinizle doldurulmuş hâlde, jetonun göründüğü aynı ekranda sizin için üretilir.

Tarayıcıdan girişi tercih eden istemciler, statik jeton yerine OAuth 2.1 kullanabilir: sunucu standart keşif belgelerini yayımlar, PKCE ve dinamik istemci kaydını destekler ve tam olarak hangi kapsamların istendiğini listeleyen bir onay ekranı gösterir. Kopyalanacak jeton da, diskte saklanacak anahtar da olmaz.

Neleri yapamaz

Konnektör, ikinci ve daha gevşek bir API değildir. Her çağrı, bir insan isteğinin geçtiği aynı dört kapıdan geçer.

Sizin adınıza hareket eder. Bir jeton, onu çıkaran operatöre bağlıdır. O kişinin rollerini ve izinlerini birebir devralır — uygulamada bir talebi açamıyorsanız, jetonunuzu taşıyan bir asistan da açamaz. Ayrıca tek bir çalışma alanına bağlıdır: başka bir kiracının verisine ulaşan hiçbir argüman yoktur.

Siz aksini söylemedikçe salt okunur. Tüm anahtarları kapalı yeni bir jeton arama yapabilir, okuyabilir ve rapor verebilir; fazlasını değil. Yazma erişimi alan bazında verilir — talepleri değiştirmek, canlı sohbette yanıtlamak, bilgi bankasını düzenlemek, projeleri yönetmek, ekip arkadaşı davet etmek, ayarları değiştirmek, otomasyon kurallarını değiştirmek — ve yalnızca işaretlediklerinizle. Okuma her zaman dâhildir, çünkü yazabilen ama okuyamayan bir asistan işe yaramaz.

Yazma araçları önce sorar. Veriyi değiştiren her araç yıkıcı olarak işaretlenmiştir; böylece iyi davranan bir istemci sessizce hareket etmek yerine her çağrıdan önce size sorar. Müşteriye ulaşan araçlar bunu kendi açıklamalarında söyler: bir canlı sohbet mesajı anında iletilir ve geri alınamaz; bir talep yorumu ise varsayılan olarak dahili nottur, böylece kazara hiçbir şey müşteriye ulaşmaz.

Sırlar sunucu tarafında kalır. Ayarlarınızı bir konnektör üzerinden okumak, entegrasyon kimlik bilgilerini maskelenmiş döndürür. Onları açan hiçbir argüman yoktur.

Müşteri metni çitle çevrilir. Talep açıklamaları, yorumlar ve sohbet dökümleri başka insanlar tarafından yazılır ve bir destek gelen kutusu, tam da birinin onu okuyan bir AI için talimat ekmeye çalışacağı yerdir. Helpdash bu metni açıkça güvenilmez-içerik bloğuyla sarar ve sunucunun kendi talimatlarında modele, içindeki hiçbir şeyin bir komut olmadığını söyler.

Her şey günlüğe yazılır. Her çağrı; operatör, araç ve sonuçla birlikte çalışma alanının geri kalanıyla aynı denetim günlüğüne kaydedilir. "Asistan salı günü aslında ne yaptı?" sorusunu yanıtlamanız gerekirse kayıt oradadır.

İptal anında geçerlidir. Ayarlar'da bir jetonu silmek, asistanın bir sonraki isteğini durdurur. Anahtarın yalnızca SHA-256 özetini sakladığımız için onu sizin adınıza kurtaramayız — kaybederseniz yenisini çıkarırsınız.

Bir jetonu daha da sıkmak

Bilmeye değer iki isteğe bağlı denetim var. Bir jeton son kullanma tarihi taşıyabilir; bu, kısa ömürlü bir denemenin kendi kendini temizlemesinin en kolay yoludur. Bir de IP izin listesi taşıyabilir; böylece tek bir sunucu için düşünülmüş bir jeton başka bir yerden kullanılamaz. İkisi de aynı oluşturma formundadır.

Makul bir ilk jeton

Yazma kapsamı olmadan bir tane çıkarın ve asistana salt okunur bir hafta verin. Ondan SLA risklerini bulmasını, gürültülü yazışmaları özetlemesini ve sizin göndereceğiniz yanıt taslaklarını yazmasını isteyin. Bu, değerin çoğunu kapsar, riskin hiçbirini almadan. Hangi yazma kapsamını gerçekten istediğinizi öğrendiğinizde yalnızca onunla ikinci bir jeton çıkarın — mevcut bir jetonu genişletmek kasıtlı olarak mümkün değildir.

Yukarıdaki her ifade bugün mevcut olan davranışı anlatır; konnektör her Helpdash çalışma alanında kullanılabilir.