MCP ilə AI assistentini Helpdash-ə qoşun

Helpdash Model Context Protocol (MCP) serveri təqdim edir, beləcə AI assistenti biletləri söhbət pəncərəsinə kopyalayıb yapışdırmağınız əvəzinə birbaşa iş sahənizin içində işləyə bilir. "Bu gün hansı biletlər SLA-nı pozur?" və ya "bu yazışmanı növbə təhvili üçün ümumiləşdir" deyin — assistent sorğunu Helpdash-in özünə verir.

Bu yazı konnektorun nə təqdim etdiyini, necə qoşulduğunu və — iki dəfə oxumağa dəyən hissə — nəyə icazəsi olmadığını əhatə edir.

Konnektor nə təqdim edir

Server 46 alət, dörd hazır göstəriş və alətlərin qəbul etdiyi bütün enum dəyərlərini sadalayan bir resurs daşıyır. Alətlər biletləri, canlı söhbəti, bilik bazasını, hazır cavabları, layihələri və həmkarları, idarə panelini, CSAT-ı, avtomatlaşdırma qaydalarını, webhook-ları, parametrləri, fəaliyyət jurnalını və hesablaşmanı əhatə edir.

Oxuma və yazma həmişə ayrı alətlərdir. method parametri olan hər şeyi əhatə edən api_request aləti yoxdur — biletləri axtarmaq və birini dəyişmək fərqli icazələri olan fərqli alətlərdir, ona görə oxuma icazəsi verilmiş assistent arqumenti dəyişməklə heç nəyi dəyişdirə bilməz.

Dörd göstəriş əvvəlcədən yazılmağa dəyən iş axınlarıdır:

• Bileti triaj et — prioritet, kateqoriya və məsul şəxs təklif edir. Heç nəyi dəyişmir.
• Müştəriyə cavab layihəsi yaz — mətni bilik bazanız və hazır cavablarınızla hazırlayır. Göndərə bilmir; cavab sizin nəzərdən keçirməyiniz üçün geri qayıdır.
• Yazışmanı ümumiləşdir — uzun bileti və ya söhbət stenoqramını növbə təhvili üçün sıxır.
• Həftəlik dəstək hesabatı — həcm, SLA, CSAT və diqqət tələb edənlər.

Müştərini qoşmaq

Parametrlər → AI konnektorları (MCP) bölməsini açın və token buraxın. Sonra tanıyacağınız bir etiket verin, ilk tokeniniz üçün bütün yazma açarlarını söndürülmüş saxlayın və açarı kopyalayın — o, yalnız bir dəfə göstərilir.

Sonra onu qeydiyyatdan keçirin. Claude Code üçün:

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

.mcp.json oxuyan istənilən müştəri üçün:

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

Hər iki nümunə iş sahənizin ünvanı ilə doldurulmuş şəkildə, tokenin göründüyü həmin ekranda sizin üçün yaradılır.

Brauzerdən girişə üstünlük verən müştərilər statik token əvəzinə OAuth 2.1 istifadə edə bilər: server standart kəşf sənədlərini dərc edir, PKCE və dinamik müştəri qeydiyyatını dəstəkləyir və hansı sahələrin istənildiyini dəqiq sadalayan razılıq ekranı göstərir. Nə kopyalanacaq token, nə də diskdə saxlanacaq açar olur.

Nə edə bilmir

Konnektor ikinci, daha boş bir API deyil. Hər çağırış insan sorğusunun keçdiyi eyni dörd nəzarət nöqtəsindən keçir.

O, sizin adınızdan hərəkət edir. Token onu buraxan operatora bağlıdır. Həmin şəxsin rollarını və icazələrini eynilə miras alır — tətbiqdə bileti aça bilmirsinizsə, sizin tokeninizi daşıyan assistent də onu aça bilməz. Üstəlik o, bir iş sahəsinə bağlıdır: başqa kirayəçinin məlumatına çatan arqument yoxdur.

Siz başqa cür deməyincə yalnız oxuyan. Bütün açarları söndürülmüş yeni token axtarış apara, oxuya və hesabat verə bilər, bundan artığını yox. Yazma icazəsi sahə üzrə verilir — biletləri dəyişmək, canlı söhbətdə cavab yazmaq, bilik bazasını redaktə etmək, layihələri idarə etmək, həmkar dəvət etmək, parametrləri dəyişmək, avtomatlaşdırma qaydalarını dəyişmək — və yalnız işarələdiyiniz sahələr üzrə. Oxuma həmişə daxildir, çünki yaza bilən, amma oxuya bilməyən assistent faydasızdır.

Yazma alətləri əvvəlcə soruşur. Məlumatı dəyişən hər alət dağıdıcı kimi işarələnib, ona görə özünü yaxşı aparan müştəri səssizcə hərəkət etmək əvəzinə hər çağırışdan əvvəl sizdən soruşur. Müştəriyə çatan alətlər bunu öz təsvirlərində bildirir: canlı söhbət mesajı dərhal çatdırılır və geri qaytarıla bilmir, bilet şərhi isə susmaya görə daxili qeyd olur, beləcə təsadüfən heç nə müştəriyə çatmır.

Sirlər serverin tərəfində qalır. Konnektor üzərindən parametrlərinizi oxumaq inteqrasiya giriş məlumatlarını maskalanmış qaytarır. Onları açan arqument yoxdur.

Müştəri mətni hasara alınır. Bilet təsvirləri, şərhlər və söhbət stenoqramları başqa adamlar tərəfindən yazılır və dəstək gələnlər qutusu məhz kiminsə onu oxuyan AI üçün göstəriş əkməyə cəhd edəcəyi yerdir. Helpdash həmin mətni açıq şəkildə etibarsız-məzmun bloku ilə əhatə edir və serverin öz təlimatlarında modelə deyir ki, onun içindəki heç nə əmr deyil.

Hər şey jurnala yazılır. Hər çağırış operator, alət və nəticə ilə birlikdə, iş sahəsinin qalan hissəsi ilə eyni audit jurnalında qeydə alınır. "Assistent çərşənbə axşamı əslində nə etdi?" sualına cavab vermək lazım gəlsə, qeyd oradadır.

Ləğv dərhal işə düşür. Parametrlərdə tokeni silmək assistentin elə növbəti sorğusunu dayandırır. Biz açarın yalnız SHA-256 hash-ini saxlayırıq, ona görə onu sizin üçün bərpa edə bilmirik — itirsəniz, yenisini buraxırsınız.

Tokeni daha da sıxmaq

Bilməyə dəyən iki əlavə nəzarət var. Token bitmə tarixi daşıya bilər — bu, qısamüddətli təcrübənin özünü təmizləməsinin ən asan yoludur. Bir də IP icazə siyahısı daşıya bilər, beləcə bir server üçün nəzərdə tutulmuş token başqa yerdən işlədilə bilmir. Hər ikisi eyni yaratma formasındadır.

Ağlabatan ilk token

Yazma sahələri olmadan bir token buraxın və assistentə yalnız oxumaqla bir həftə verin. Ondan SLA risklərini tapmağı, səs-küylü yazışmaları ümumiləşdirməyi və özünüzün göndərəcəyiniz cavab layihələrini yazmağı istəyin. Bu, faydanın çoxunu verir, riskin isə heç birini. Hansı yazma sahəsinin doğrudan lazım olduğunu biləndə yalnız onunla ikinci token buraxın — mövcud tokeni genişləndirmək qəsdən mümkün deyil.

Yuxarıdakı hər iddia bu gün mövcud olan davranışı təsvir edir; konnektor hər Helpdash iş sahəsində əlçatandır.