MCP prijungimas ir prieigos valdymas

Ką atliksite

MCP leidžia suderinamam klientui naudoti „Hanna“ veiksmus kaip aiškiai aprašytus įrankius. Prisijungimas atliekamas per OAuth, todėl API rakto nereikia kopijuoti į pokalbį ar MCP kliento nustatymų tekstą.

Prieš pradedant

Reikalinga administratoriaus arba darbuotojui suteikta API ir MCP prieiga. Suteikite tik konkrečiai integracijai reikalingas teises ir nenaudokite asmeninių raktų bendroms įmonės integracijoms.

Prieš prijungiant

Patikrinkite, kad:

• darbuotojas gali prisijungti prie reikiamos „Hanna“ paskyros;
• jo rolė leidžia matyti ir keisti reikalingus modulius;
• administratoriaus nustatymuose jam suteikta API ir MCP prieiga;
• naudojate patikimą MCP klientą.

Kaip prijungti „Hanna“ prie MCP kliento

1. MCP kliente pradėkite naujo nuotolinio MCP serverio prijungimą.
2. Nurodykite serverio adresą https://mcp.hannacrm.app/mcp.
3. Klientui atidarius „Hanna“ prisijungimą, nurodykite savo paskyros pavadinimą. Tai yra subdomeno dalis prieš .hannacrm.app, o ne visas interneto adresas.
4. Prisijunkite prie savo „Hanna“ paskyros.
5. Peržiūrėkite prašomą prieigą ir patvirtinkite tik tada, kai atpažįstate MCP klientą bei paskyrą.
6. Grįžę į klientą patikrinkite, ar rodomi „Hanna“ įrankiai.

Jei MCP klientas yra ChatGPT, naudokite atskirą nuoseklią instrukciją Hanna CRM prijungimas prie ChatGPT. Joje aprašytas papildinio sukūrimas, įdiegimas, OAuth autorizacija ir pirmoji saugi patikra.

Kur peržiūrėti galimus įrankius

Atidarykite Sistemos nustatymai → API ir MCP ir paspauskite MCP Dokumentacija. Dokumentacija pasiekiama adresu:

https://{jūsų-paskyra}.hannacrm.app/mcp/docs

Joje įrankiai suskirstyti pagal CRM modulius ir žinynus. Prie kiekvieno įrankio nurodyta jo paskirtis, galimi parametrai ir laukai. Pavyzdžiui, modulis gali turėti paieškos, vieno įrašo gavimo, kūrimo ir atnaujinimo įrankius. Kai kurie žinynai yra skirti tik paieškai.

Dokumentacija parodo, ką „Hanna“ gali pateikti MCP klientams, tačiau realiai pasiekiamus duomenis riboja prisijungusio darbuotojo teisės ir paskyros nustatymai.

Pagalbos centro viršuje esanti API dokumentacija skirta REST API v4 ir MCP įrankių neatvaizduoja. MCP įrankių techninį aprašą visada atidarykite savo paskyros /mcp/docs puslapyje.

Kaip saugiai naudoti MCP

Prieš patvirtindami veiksmą perskaitykite, kurį modulį ir įrašą klientas ketina keisti. Kūrimas, redagavimas ar kitas duomenis keičiantis veiksmas gali paleisti įprastas „Hanna“ automatizavimo taisykles, pranešimus ir susijusių įrašų pakeitimus.

Jeigu klientui reikia tik informacijos paieškos, nesuteikite platesnių teisių darbuotojui vien dėl MCP. Patogiau naudoti atskirą darbuotoją arba rolę su aiškiai apribotais moduliais, kai tai atitinka jūsų prieigos valdymo tvarką.

Jei MCP klientas neprisijungia

1. Patikrinkite serverio adresą: https://mcp.hannacrm.app/mcp.
2. Įsitikinkite, kad nurodėte teisingą paskyros subdomeną.
3. Prisijunkite prie „Hanna“ naršyklėje ir patikrinkite, ar darbuotojas aktyvus.
4. Patikrinkite darbuotojo API ir MCP prieigą bei modulio teises.
5. Iš naujo pradėkite OAuth prijungimą iš MCP kliento.
6. Galimų įrankių pavadinimus ir parametrus sutikrinkite su MCP Dokumentacija.

Jeigu prisijungimas veikia, bet konkretus įrankis negrąžina duomenų arba neleidžia jų pakeisti, dažniausiai reikia tikrinti darbuotojo rolę, modulio teisę, įrašo matomumą ir privalomus laukus.

Jei atlikus šiuos patikrinimus MCP vis tiek neprisijungia arba konkretus įrankis neveikia, Hanna klientų aptarnavimo komandai nurodykite savo įmonės Hanna adresą, MCP kliento pavadinimą ir versiją, bandymo laiką su laiko juosta, žingsnį arba įrankio pavadinimą ir tikslų klaidos tekstą. Nesiųskite slaptažodžių, OAuth kodų ar kitų prisijungimo duomenų.

Susiję straipsniai

• Hanna CRM prijungimas prie ChatGPT
• API ir MCP nustatymai bei dokumentacija