Siirry pääsisältöön

Yhdistä Smartsupp Google Geminiin

Yhdistä Smartsupp-tilisi Google Geminiin ja työskentele live chat -tietojesi kanssa tavallisilla kielikomennoilla.

Tekijä: Michal Jindra

Yhdistä Smartsupp Google Geminiin ja työskentele live chat -tietojesi kanssa pelkästään kysymällä. Sen sijaan että klikkaisit hallintapaneelin läpi, kirjoitat tavallisen lauseen — Gemini löytää tiedot, tiivistää ne tai suorittaa toiminnon puolestasi.

Geminin verkkosovelluksessa ei ole liitinosiota (toisin kuin ChatGPT:ssä tai Claudessa), joten yhdistäminen tehdään Gemini CLI:n kautta — ilmainen Googlen virallinen sovellus, joka pyörii terminaalissa. Älä huoli, jos et ole käyttänyt terminaalia aiemmin: käyttöönotto on muutama kopioi–liitä-komento ja teet sen vain kerran.

Olemme jakaneet tämän ohjeen muutamaan osioon:


Ennen kuin aloitat

Tarvitset:

  • Node.js 20 tai uudempi asennettuna tietokoneellesi. Tarkista ajamalla komento node -v terminaalissasi tai lataa osoitteesta nodejs.org.

  • Google-tili jonka avulla luot ilmaisen Gemini API -avaimen. Toisin kuin ChatGPT:ssä, et tarvitse mitään maksettua pakettia.

  • Smartsupp-kirjautumistietosi — käyttöönoton aikana kirjaudut Smartsupp-tilillesi ja hyväksyt yhdistämisen.

🟡 Vaatimus: Smartsupp MCP -palvelin on saatavilla Plus -paketissa ja sitä korkeammissa.


Yhdistä yhteys

1. Asenna Gemini CLI. Avaa terminaali (Mac: Terminal-sovellus, Windows: PowerShell) ja suorita:

npm install -g @google/gemini-cli

2. Luo Gemini API -avain. Siirry sivulle Google AI Studio, kirjaudu sisään Google-tililläsi ja klikkaa Luo API-avain. Kopioi avain — tarvitset sitä seuraavassa vaiheessa.

3. Tallenna API-avain. Suorita tämä komento terminaalissa (korvaa your-key-here kopioimallasi avaimella):

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

4. Lisää Smartsupp-yhteys. Avaa tiedosto ~/.gemini/settings.json millä tahansa tekstieditorilla (luo se, jos sitä ei ole) ja liitä:

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

5. Käynnistä Gemini. Suorita gemini terminaalissa. Jos se kysyy, miten haluat kirjautua sisään, valitse Käytä Gemini API -avainta.

6. Tarkista yhteys. Kirjoita Geminissä /mcp. Sinun pitäisi nähdä:

🟢 smartsupp – Ready (19 tools)


​7. Valtuuta yhteys. Kun kysyt ensimmäistä kertaa Smartsupp-dataasi liittyvän kysymyksen, selain avaa Smartsupp-kirjautumissivun. Kirjaudu sisään hyväksyäksesi pääsyn — hyväksyt yhteyden kirjautumalla sisään, eikä Gemini näe Smartsupp-salasanaasi.

⚠️ Huomio: Valtuutus käyttää automaattisesti sitä Smartsupp-tiliä, jolla olet juuri nyt kirjautuneena selaimeen. Jos hallinnoit useampaa kuin yhtä Smartsupp-tiliä, tarkista, että olet kirjautunut oikealle tilille ennen valtuutusta.

8. Varmista, että se toimii. Kokeile yksinkertaista pyyntöä, esimerkiksi "Listaa kaikki agentit Smartsupp-tililtäni." Jos Gemini vastaa agenttilistallasi, yhteys toimii.


Mitä voit tehdä

Kun yhteys on muodostettu, Gemini voi lukea Smartsupp-tietosi ja hallita postilaatikkoasi ohjeidesi mukaan. Kirjoita vain, mitä tarvitset, tavallisena lauseena:

  • "Tee yhteenveto eilisistä keskusteluista ja korosta ne, jotka vielä kaipaavat vastausta."

  • "Mitkä keskustelut ovat yhä auki?"

  • "Montako uutta keskustelua meillä oli viime viikolla verrattuna sitä edeltävään viikkoon?"

⚠️ Vastaukset ja toimet ovat todellisia. Tekoälyavustajan kautta lähettämäsi viesti päätyy asiakkaan chattiin, ja sulkeminen, määrittäminen tai tunnisteen lisääminen muuttaa saapuneita koko tiimillesi. Lue, mitä avustaja aikoo tehdä, ennen kuin se toimii, varsinkin kun se käsittelee monta keskustelua kerralla.

💡 Lisää esimerkkipyyntöjä, mitä jää Smartsuppiin ja miten tietojasi käsitellään: Käytä Smartsupp-saapuneitasi tekoälyavustajasi kautta.


Hyvä tietää

  • Gemini toimii sinun oikeilla Smartsupp-tiedoillasi. Hyväksyt pääsyn kirjautumalla sisään (OAuth) – Gemini ei näe salasanaasi koskaan.

  • Luku (yleiskatsaus, tilastot, kontaktit) on käytettävissä kokonaan. Toiminnot (vastaukset, tunnisteet, tehtävien määritykset) suoritetaan vain, kun pyydät niitä — ja Gemini pyytää sinua vahvistamaan ennen niiden suorittamista.

  • Smartsupp-tilien vaihtaminen: sulje Gemini, poista kansio ~/.mcp-auth (suorita rm -rf ~/.mcp-auth), käynnistä Gemini uudelleen ja kirjaudu sisään toisella tilillä.


Vianmääritys

  • 401-virhe, kun aloitat chatin: Gemini CLI lukee .env .env-tiedoston kansiosta, josta ajat sen. Jos kyseisessä kansiossa on oma .env ilman GEMINI_API_KEY, avainta ei poimita. Lisää avain myös siihen tiedostoon tai käynnistä Gemini kotikansiostasi.

  • Smartsupp näyttää tilaksi Disconnected: kirjoita /mcp auth smartsupp Geminin sisällä. Jos tämä ei auta, poista ~/.mcp-auth ja yritä uudelleen.

  • npm install epäonnistuu oikeusvirheellä (EACCES): ohita asennus ja aja Gemini suoraan komennolla npx @google/gemini-cli.


Mitä seuraavaksi?

💡 Tarvitsetko lisää apua? Ota yhteyttä tukeemme tukitiimiin — autamme mielellämme!

Vastasiko tämä kysymykseesi?