Siirry pääsisältöön

Yhdistä Smartsupp Google Geminiin

Yhdistä Smartsupp-tili Google Geminiin ja käsittele live-chat-tietojasi luonnollisen kielen komennoilla.

Tekijä: Michal Jindra

Yhdistä Smartsupp Google Geminiin ja käsittele live-chat-tietojasi helposti kyselemällä – hallintapaneelin klikkailun sijaan voit kirjoittaa tavallisen lauseen, ja Gemini etsii tiedot, tiivistää ne tai suorittaa sinulle toimintapyynnön.

Geminin verkkosovelluksessa ei ole liitännäisosioita (toisin kuin ChatGPT:llä tai Claudella), joten yhteys toimii Gemini CLI:n kautta – tämä on Googlen maksuton virallinen sovellus, joka toimii komentorivillä. Ei haittaa, jos et ole ennen käyttänyt komentoriviä: asennus hoituu muutamalla kopioi–liitä-komennolla ja tarvitsee tehdä vain kerran.

Olemme jakaneet tämän ohjeen osioihin:

Ennen kuin aloitat

Tarvitset nämä:

  • Node.js 20 tai uudempi asennettuna tietokoneellesi. Tarkista komennolla node -v terminaalissa tai lataa osoitteesta nodejs.org.

  • Google-tili ilmaiseksi Gemini API -avaimen luontiin. Toisin kuin ChatGPT:ssä, et tarvitse maksullista tilausta.

  • Smartsupp-kirjautumistiedot – käyttöönotossa kirjaudut Smartsupp-tiliin ja hyväksyt yhteyden.

🟡 Vaatimus: Smartsupp MCP -palvelin on saatavilla Plus- ja sitä korkeammilla paketeilla.

Yhteyden käyttöönotto

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

npm install -g @google/gemini-cli

2. Luo Gemini API -avain. Mene Google AI Studioon, kirjaudu Google-tilillä ja klikkaa Luo API-avain. Kopioi avain – tarvitset sen seuraavassa vaiheessa.

3. Tallenna API-avain. Kirjoita komentoriville (korvaa your-key-here kopioidulla avaimella):

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

4. Lisää Smartsupp-yhteys. Avaa tiedosto ~/.gemini/settings.json tekstieditorissa (luo tiedosto, jos sitä ei ole) ja liitä seuraava sisältö:

{
  "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 kysytään kirjautumistapaa, valitse Käytä Gemini API -avainta.

6. Tarkista yhteys. Kirjoita Geminissä /mcp. Näet jotakin tämän tyylistä:

🟢 smartsupp – Valmis (19 työkalua)


​7. Valtuuta yhteys. Kun kysyt ensi kerran Smartsupp-tiedoista, selaimesi avaa Smartsuppin kirjautumissivun. Kirjaudu sisään hyväksyäksesi pääsyn – hyväksyt yhteyden kirjautumalla, ja Gemini ei koskaan näe salasanaasi.

⚠️ Huomio: Valtuutus käyttää automaattisesti sitä Smartsupp-tiliä, johon olet selaimessa kirjautunut. Jos hallinnoit useaa Smartsupp-tiliä, tarkista että oikea tili on aktiivinen ennen hyväksymistä.

8. Varmista toiminta. Testaa yhteys pyytämällä vaikka näin: "Listaa kaikki agentit Smartsupp-tililläni." Jos Gemini palauttaa agenttilistan, yhteys toimii.

Mitä voit tehdä

Kun yhteys on valmis, Gemini voi lukea Smartsupp-tietosi ja hallinnoida inboxiasi ohjeidesi mukaan. Kirjoita vain mitä haluat tehdä luonnollisena lauseena:

  • "Tiivistä eilisen keskustelut ja korosta ne, jotka vaativat vielä vastausta."

  • "Mitkä keskustelut ovat vielä avoinna?"

  • "Montako uutta keskustelua oli viime viikolla verrattuna edellisviikkoon?"

Tyypillisiä käyttötapoja (esimerkkikomentojen kanssa):

⚠️ Vastaukset ja toiminnot ovat todellisia. Viesti, jonka lähetät AI-assistentin kautta päätyy asiakkaan chattiin; sulkeminen, delegointi tai tunnisteiden lisääminen muuttaa inbox-näkymää koko tiimille. Lue aina, mitä assistenttisi aikoo tehdä ennen kuin hyväksyt – erityisesti, jos toimintaa tehdään useassa keskustelussa kerralla.

💡 Lisää esimerkkikomentoja, mitä jää Smartsuppiin ja miten tietojasi käsitellään: Työskentele Smartsupp-inboxilla AI-assistentista.

Hyvä tietää

  • Gemini käyttää todellisia Smartsupp-tietojasi. Hyväksyt pääsyn kirjautumalla sisään (OAuth) – Gemini ei koskaan näe salasanaasi.

  • Luku (yleiskatsauksia, tilastoja, kontakteja) onnistuu kokonaan. Toimintoja (vastaukset, tunnisteet, delegoinnit) suoritetaan vain kun pyydät – ja Gemini pyytää vahvistusta ennen suorittamista.

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

Vianetsintä

  • 401-virhe keskustelun alkaessa: Gemini CLI lukee .env-tiedoston siitä kansiosta, jossa suoritat ohjelmaa. Jos kansiolla on oma .env eikä siinä ole GEMINI_API_KEY:tä, avainta ei käytetä. Lisää avain siihenkin tiedostoon tai suorita Gemini kotikansiosta.

  • smartsupp näkyy tilassa Katkaistu: kirjoita Geminissä /mcp auth smartsupp. Ellei auta, poista ~/.mcp-auth ja yritä uudestaan.

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

Mitä seuraavaksi?

💡 Tarvitsetko apua? Ota yhteyttä tukitiimiimme – autamme mielellämme!

Aiheeseen liittyvät artikkelit
Vastasiko tämä kysymykseesi?