Preskoči na glavno vsebino

Povezava Smartsupp z Google Gemini

Povežite svoj Smartsupp račun z Google Gemini in delajte s podatki live klepeta z običajnimi besedilnimi pozivi.

Povežite Smartsupp z Google Gemini in delajte s podatki vašega live klepeta samo z vprašanji v naravnem jeziku. Namesto da klikate po nadzorni plošči, vpišete preprost stavek — Gemini poišče informacije, jih povzame ali izvede dejanje namesto vas.

Gemini v svoji spletni aplikaciji nima razdelka za povezovalnike (za razliko od ChatGPT ali Claude), zato povezava poteka prek Gemini CLI — brezplačne uradne aplikacije Google, ki teče v terminalu. Če terminala še niste uporabljali, brez skrbi: nastavitev je le nekaj ukazov za kopiranje in lepljenje in jo naredite samo enkrat.

Članek je razdeljen na več razdelkov:


Preden začnete

Potrebovali boste:

  • Node.js 20 ali novejši nameščen v vašem računalniku. Preverite ga z zagonom ukaza node -v v terminalu ali ga prenesite na nodejs.org.

  • Google račun za ustvarjanje brezplačnega Gemini API ključa. Za razliko od ChatGPT ne potrebujete nobenega plačljivega paketa.

  • Vaše Smartsupp prijavne podatke — med nastavitvijo se boste prijavili v svoj Smartsupp račun, da odobrite povezavo.

🟡 Pogoj: Smartsupp MCP strežnik je na voljo v paketu PLUS in višjih.


Nastavitev povezave

1. Namestite Gemini CLI. Odprite svoj terminal (na Mac: aplikacija Terminal, v Windows: PowerShell) in zaženite:

npm install -g @google/gemini-cli

2. Ustvarite svoj Gemini API ključ. Pojdite v Google AI Studio, se prijavite s svojim Google računom in kliknite Create API key. Kopirajte ključ — potrebovali ga boste v naslednjem koraku.

3. Shranite API ključ. V terminalu zaženite ta ukaz (zamenjajte your-key-here s ključem, ki ste ga kopirali):

mkdir -p ~/.gemini && echo 'GEMINI_API_KEY=your-key-here' >> ~/.gemini/.env

4. Dodajte povezavo Smartsupp. Odprite datoteko ~/.gemini/settings.json v katerem koli urejevalniku besedila (ustvarite jo, če še ne obstaja) in prilepite:

{  "mcpServers": {    "smartsupp": {      "command": "npx",      "args": ["mcp-remote", "https://mcp.smartsupp.com/mcp"],      "timeout": 30000    }  },  "security": {    "auth": { "selectedType": "gemini-api-key" }  }}

5. Zaženite Gemini. V terminalu zaženite gemini. Če vas vpraša, kako se želite prijaviti, izberite Use Gemini API Key.

6. Preverite povezavo. V Gemini vpišite /mcp. Videti bi morali:

🟢 smartsupp – Ready (19 tools)


7. Odobrite povezavo. Prvič, ko vprašate o svojih Smartsupp podatkih, se v brskalniku odpre Smartsupp prijavna stran. Prijavite se, da odobrite dostop — povezavo odobrite s prijavo, Gemini pa nikoli ne vidi vašega Smartsupp gesla.

⚠️ Opomba: Avtorizacija samodejno uporabi Smartsupp račun, v katerega ste trenutno prijavljeni v brskalniku. Če upravljate več kot en Smartsupp račun, pred odobritvijo še enkrat preverite, da ste prijavljeni v pravega.

8. Preverite, da deluje. Preizkusite preprosto zahtevo, na primer »List all agents on my Smartsupp account.« Če Gemini odgovori s seznamom vaših agentov, je povezava vzpostavljena in deluje.


Kaj lahko počnete

Ko je povezava vzpostavljena, lahko Gemini na vašo zahtevo bere vaše Smartsupp podatke in upravlja vašo mapo Prejeto. Preprosto napišite, kaj potrebujete, v obliki običajnega stavka:

Pregled pogovorov

  • "Show me the conversations from the last week."

  • "Summarize this conversation in three sentences."

  • "Which conversations are still open?"

Statistika

  • "How many new conversations did we have last week?"

  • "Break down the new conversations day by day."

Stiki

  • "Find the contact with the email jan@example.com."

  • "What tags does this customer have?"

Oznake

  • "Tag this conversation with Complaint."

  • "Create a new tag called VIP."

Upravljanje pogovorov

  • "Assign this conversation to the agent Marie."

  • "Close this conversation."

Odgovori v klepet

  • "Send to this conversation: Thank you for your patience, we're on it."

💡 Ideje za preizkus: jutranji povzetek ("Summarize yesterday's conversations and highlight the ones that need a reply") ali hiter pregled ("Compare the number of new conversations this week and last week").


Koristne informacije

  • Gemini dela z vašimi dejanskimi Smartsupp podatki. Dostop odobrite s prijavo (OAuth) — Gemini vašega gesla nikoli ne vidi.

  • Bralni dostop (pregledi, statistika, stiki) je v celoti na voljo. Dejanja (odgovori, oznake, dodeljevanje) se izvedejo samo, ko jih izrecno zahtevate — in Gemini vas pred izvedbo prosi za potrditev.

  • Preklop med Smartsupp računi: zaprite Gemini, izbrišite mapo ~/.mcp-auth (zaženite rm -rf ~/.mcp-auth), nato ponovno zaženite Gemini in se prijavite z drugim računom.


Odpravljanje težav

  • Napaka 401, ko začnete klepetati: Gemini CLI bere datoteko .env iz mape, v kateri ga zaženete. Če ima ta mapa svojo datoteko .env brez GEMINI_API_KEY, se ključ ne prebere. Dodajte ključ tudi v to datoteko ali Gemini zaženite iz svoje osnovne mape (home).

  • smartsupp prikazuje Disconnected: v Gemini vpišite /mcp auth smartsupp. Če to ne pomaga, izbrišite ~/.mcp-auth in poskusite znova.

  • npm install se zaključi z napako dovoljenj (EACCES): preskočite namestitev in zaženite Gemini neposredno z npx @google/gemini-cli.


Kaj sledi?

💡 Potrebujete dodatno pomoč? Obrnite se na našo ekipo za podporo — z veseljem vam pomagamo!

Ste s tem dobili odgovor na svoje vprašanje?