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 povezava za nastavljanje, ne za podporo. Nastavlja delovni prostor. Ne more brati vaših pogovorov ali odgovoriti stranki — glejte Č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#

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.

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 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.

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.