MCP: HelpStack nastavite z vprašanjem

HelpStack govori MCP (Model Context Protocol), zato lahko pomočnik UI, kot je Claude, namesto vas nastavi vaš delovni prostor. Vi opišete, kaj želite, s svojimi besedami; on doda članke baze znanja, čipe s pogostimi vprašanji in orodja agenta.

»Zajemi naš center za pomoč, nato dodaj orodje, ki poišče naročilo po številki in e-pošti na https://api.mystore.si/orders.«

To je privzeto povezava za nastavljanje: nastavlja delovni prostor. Vaše pogovore bere ali strankam odgovarja le, če skrbnik ob ustvarjanju žetona označi te obsege, za kar je potreben paket Growth. Preostale omejitve so pod Česa ne zmore.

Na hitro#

1. Ustvarite žeton#

Nastavitve → Žetoni API → Ustvari žeton. Poimenujte ga tako, da ga boste pozneje prepoznali, na primer »Claude na mojem prenosniku«, saj boste po tem imenu vedeli, katerega preklicati.

Žeton je prikazan samo enkrat. Shranimo le njegovo zgoščeno vrednost, zato ni zaslona, ki bi vam ga lahko znova pokazal, in ni zahtevka za podporo, ki bi ga lahko obnovil. Če ga izgubite, ga prekličite in ustvarite novega. To traja deset sekund in je predvidena pot, ne napaka.

Žeton je vezan na eno organizacijo — tisto, v kateri ste bili, ko ste ga ustvarili. Če pripadate več organizacijam, ustvarite po en žeton za vsako, ki jo želite nastaviti. Žetona ni mogoče prestaviti med njimi, poznejša pridružitev drugi organizaciji pa ne razširi žetona, ki ga že imate.

1b. Izberite, kaj žeton lahko počne#

Ko ustvarite žeton, označite, do česa lahko seže. Žeton nikoli ne zmore več kot vi — vaša vloga še vedno velja — obsegi pa ga le še dodatno zožijo.

Obsega settings: sta privzeto označena, kar je površina za nastavljanje, ki jo opisuje ta stran. Obsega conversations: nista nikoli vnaprej označena — odločitev, da pomočniku pokažete svoj nabiralnik, mora nekdo sprejeti, ne pa je podedovati — in se pojavita šele na paketu Growth. Odznačite settings:write in dobite žeton, ki si vašo konfiguracijo lahko ogleda, spremeni pa ničesar — uporabno, kadar želite, da pomočnik pregleda nastavitve ali odgovori na vprašanje »kaj imamo pravzaprav nastavljeno?«, brez kakršnega koli tveganja urejanja.

tools/list prikaže samo orodja, ki jih žeton lahko pokliče, zato pomočnik nikoli ne vidi vrat, ki jih ne more odpreti.

2. Povežite pomočnika#

Claude Code:

claude mcp add helpstack --transport http https://helpstack.eu/api/mcp \
  --header "Authorization: Bearer hs_your_token_here"

Claude Desktop in ChatGPT — dodajte povezovalnik po meri, ki kaže na https://helpstack.eu/api/mcp, in se prijavite, ko vas vpraša. Ta odjemalca ne moreta poslati žetona, ki bi ga prilepili, zato namesto tega uporabita prijavo: izberete, katero organizacijo povezujete, in na strani HelpStacka odobrite, kaj aplikacija sme. Nič ni podeljeno, dokler tega ne odobrite, aplikacijo pa lahko pozneje odklopite v Nastavitve → Žetoni API.

Za to pot vam žetona ni treba ustvariti. Žetoni so za odjemalce, kot je Claude Code, ki si glavo lahko nastavijo sami.

Codex — žeton prebere iz okoljske spremenljivke, zato nikoli ne pristane v vaši konfiguracijski datoteki:

export HELPSTACK_MCP_TOKEN="hs_vas_zeton"
codex mcp add helpstack --url https://helpstack.eu/api/mcp \
  --bearer-token-env-var HELPSTACK_MCP_TOKEN

Karkoli drugega, kar govori MCP prek HTTP — usmerite na isti naslov z isto glavo. V prenosu ni ničesar, kar bi bilo značilno za HelpStack.

Nato ga prosite, naj zažene whoami. Odgovoriti mora z imenom vaše organizacije in vašo vlogo. Če to stori, bo delovalo vse spodaj.

Dva načina povezave#

Oboje se konča enako: identiteta z vlogo, organizacijo in naborom dovoljenj, ki se preveri ob vsakem klicu.

Kaj zmore#

Kaj pomočnik izve, preden pokliče

Vsako orodje je objavljeno s tremi namigi: ali samo bere, ali je njegov učinek mogoče razveljaviti in katero dovoljenje potrebuje. Odjemalci kot Claude, Cursor in ChatGPT se po njih odločijo, kaj vam pokažejo najprej, zato izpis vaših kanalov steče tiho, pošiljanje odgovora pa vpraša.

Dva sta vredna omembe:

• Samo dve orodji sežeta ven iz HelpStacka. add_knowledge_base_url in recrawl_knowledge_base_source prineseta stran s spleta. Vsako drugo orodje ostane znotraj vašega delovnega prostora.
• send_reply je označen kot nepovraten, prav tako štiri orodja za brisanje in urejanja, ki nekaj prepišejo na mestu. draft_reply ni: osnutek, ki ga nihče ni odobril, ni dosegel nikogar, zato njegov umik ne stane nič.

Namigi so nasvet odjemalcu, ne ključavnica. Kaj žeton v resnici sme, še naprej določata njegova dovoljenja in vaša vloga, preverjena ob vsakem klicu.

Številke brez nabiralnika

analytics:read in conversations:read sta namenoma ločena in prav to je razlika, ki jo je vredno razumeti, preden karkoli obkljukate. get_analytics vrne zbirne podatke: koliko pogovorov, kako hitro so bili odgovorjeni, katere oznake naraščajo, kaj je AI zgrešil. Nič od tega ni to, kar je napisala stranka. search_conversations vrne besedilo strank, zato sodi med orodja nabiralnika.

Tako lahko pomočniku daste svoje številke, ne da bi mu dali nabiralnik. »Vračila so narasla za 40 %« in »tukaj je, kaj je o vračilih napisalo štirinajst ljudi« sta različni razkritji in se podelita ločeno.

Branje je na voljo vsakemu članu. Pisanje zahteva lastnika ali skrbnika, enako kot na nadzorni plošči: žeton agenta lahko gleda, ne more pa spreminjati. To se preveri pred vašimi argumenti, zato žeton brez pravic s klicem o orodju ne izve ničesar.

Tisto, kar vse poveže

attach_knowledge_base_groups_to_channel je korak, ki ga ljudje spregledajo. Dodajanje člankov jih nikamor ne usmeri: kanal brez pripetih skupin preiskuje celotno bazo znanja, kar je prav za eno temo in slabo za več. Članke združite v skupino, skupino pripnite in UI bo na tem kanalu odgovarjal iz tega izseka.

Odgovarjanje na težke primere#

Z obsegoma conversations:read in conversations:draft lahko pomočnik prebere zahtevno nit in vam napiše premišljen odgovor:

Vi: Preberi pogovor 4821 in pripravi osnutek odgovora. Stranka ima prav, da smo odpremili pozno, vendar je vračilo, ki ga zahteva, večje od vrednosti naročila.

Pokliče get_conversation, prebere celotno nit in pokliče draft_reply. Osnutek pristane v vašem nabiralniku enako kot tisti, ki jih ustvari UI, pošljete pa ga vi.

Osnutek ne more doseči stranke. draft_reply nikoli ne uvrsti pošiljanja v vrsto: osnutek miruje, dokler ga človek v HelpStacku ne odobri, kjer se odobritev zabeleži z njegovim imenom.

Pri e-poštnem kanalu s predlogo odgovora napišite samo besedilo. Pozdrav na začetku in zaključek (pozdravna vrstica in podpisnik) se dodata ob pošiljanju, zato draft_reply in send_reply odstranita pozdrav ali zaključek, ki ga je napisal vaš asistent, namesto da bi ju poslala dvakrat.

Pošiljanje je ločen obseg, conversations:send, in prav ta ločnica je bistvo. conversations:draft ga ne vključuje, nič drugega ga ne podeli in nikoli ni privzeto označen. »Napiši mi odgovor« in »odgovori namesto mene« sta različni odločitvi, zato sta različni dovoljenji.

Če ga podelite, send_reply odgovori takoj in brez pregleda — enako kot že počnejo vaši kanali z vklopljenim samodejnim odgovarjanjem. Izvede enako zaznavanje jezika in prevod kot gumb za odobritev, tako da angleški odgovor ne pride do stranke, ki je pisala v slovenščini, sporočilo pa se pripiše osebi, ki ji pripada žeton, in ne anonimnemu pomočniku. Poslanega sporočila ni mogoče preklicati.

Neposlani osnutki so označeni, ko pomočnik znova prebere nit, zato svojega neodobrenega osnutka nikoli ne zamenja za nekaj, kar je stranka že videla.

Česa ne zmore#

Namenoma, in to je uporabnejša polovica seznama:

• Ne more poslati, razen če ste podelili conversations:send, ki je privzeto izklopljen, ločen od pisanja osnutkov in na voljo le na paketu Growth.
• Ne vidi druge organizacije. Organizacija izhaja iz žetona in nikoli ni nekaj, kar bi klicatelj podal.
• Vašega nabiralnika ne more brati, če tega niste dovolili. Obsega za pogovore sta izklopljena, dokler ju ne označite, in nista na voljo pod paketom Growth.
• Ne more preseči vaših pravic. Žeton deluje kot oseba, ki ga je ustvarila, z njeno trenutno vlogo.
• Ne preživi vašega članstva. Odstranite osebo iz organizacije in njeni žetoni ob naslednjem klicu nehajo delovati.
• Ne dotika se poverilnic kanala. Gesla predalov, Googlovi osvežitveni žetoni in Metini žetoni strani niso polje v nobenem orodju, zato ostaja povezovanje kanalov stvar nadzorne plošče. Spremeni lahko, kako se kanal obnaša, ne pa tudi, s čim se prijavlja.
• Ne more ustvariti žetona. Žeton, ki bi lahko izdajal žetone, bi v enem klicu ušel iz svojih lastnih dovoljenj, zato orodja za to ni. Žetone ustvari oseba v nastavitvah.
• Ne more dodati ali odstraniti člana ekipe ali mu spremeniti vloge. Spreminjanje tega, kdo doseže vaš nabiralnik, je enaka stopnja pooblastil kot izdaja žetona: list_team_members bere, nič ne piše. Vabila ostajajo na nadzorni plošči.
• Ne dotika se obračunavanja. Nobeno orodje ne začne plačila, ne zamenja paketa in ne odpre portala za obračun.
• Ne more povezati Shopifyja ali WooCommerca. Oba potrebujeta človeka v brskalniku — zaslon OAuth ali kodo za povezavo, prilepljeno v WordPress.
• Ne spremeni obvestil nikomur drugemu. Nastavitev obvestila pripada eni osebi, zato set_notification_preferences piše nastavitve lastnika žetona in nikogar drugega.
• Ne spremeni URL-oznake organizacije. Ime in privzeti jezik sta nastavljiva; oznaka v naslovu je del povezav in ni.
• Ne obdrži obsega, ki ga je paket izgubil. Ob prehodu z Growth navzdol obsega za pogovore tisti dan nehata delovati, tudi na že izdanih žetonih. Z oznakami je enako: orodja za taksonomijo zavrnejo organizacijo pod paketom Growth, zato MCP nikoli ni pot mimo paketa.

Primer#

Nastavitev podpore za trgovino iz nič, v enem pogovoru:

Vi: Tukaj je naš center za pomoč: https://mystore.si/pomoc. Zajemi ga, nato dodaj čip s pogostim vprašanjem o rokih dostave in orodje, ki preveri stanje naročila prek našega API-ja.

Pomočnik bo klical add_knowledge_base_url, nato create_faq in nato create_agent_tool — običajno bo najprej klical list_agent_tools, da ne podvoji orodja, ki ga že imate.

Dvoje je treba pričakovati:

• Zajem ni takojšen. Vsak zagon indeksira približno 50 strani, ponovni zagon pa seže dlje, zato je veliko spletno mesto pokrito v več zajemih. Za pregled napredka prosite za list_knowledge_base_sources.
• Opis orodja je najpomembnejši del. To je tisto, kar model prebere, da se odloči, kdaj poklicati vaše orodje. Povejte to preprosto — »uporabi samo, kadar stranka navede tako številko naročila kot e-pošto, s katero je naročila« — in to bo zapisano v opis, kamor sodi.

Ko je nekaj zavrnjeno#

Napake, ki jih boste najverjetneje videli, in kaj pomenijo:

Kako varovati žeton#

Žeton je geslo, ki se vtipka samo. Ravnajte z njim tako:

• En žeton na mesto uporabe, da preklic enega ne pokvari drugih.
• Prekličite ga, ko ga nehate uporabljati. Nastavitve → Žetoni API prikazujejo, kdaj je bil vsak nazadnje uporabljen, kar običajno zadošča za ugotovitev, kateri miruje.
• Ne lepite ga v deljen dokument ali klepet. Če ste ga, ga prekličite — cena napake je, da nekdo drug prenastavi vašega pomočnika.
• Ni za vaše stranke ali vaše spletno mesto. Sodi na naprave, ki jih nadzirate.

Povezano#

• Orodja agenta — kaj so orodja in kako napisati dober opis.
• Prilagojena orodja agenta — referenca za integratorje o končnih točkah, ki jih kličejo vaša orodja.
• Baza znanja — kako se obnašata zajem in članki.
• Funkcijske zastavice — katere zmogljivosti vključuje vaš paket.