Přeskočit na hlavní obsah

Propojte Smartsupp s Google Gemini

Propojte svůj účet Smartsupp s Google Gemini a pracujte se svými daty z live chatu pomocí běžných dotazů v přirozeném jazyce.

Autor: Michal Jindra

Propojte Smartsupp s Google Gemini a pracujte se svými daty z live chatu jednoduše tím, že zadáte dotaz. Místo zdlouhavého proklikávání v dashboardu stačí napsat běžnou větu – Gemini za vás informace najde, shrne nebo provede požadovanou akci.

Na rozdíl od ChatGPT nebo Claude nenajdete v Gemini ve webové aplikaci sekci pro konektory, takže propojení probíhá přes Gemini CLI – oficiální bezplatnou aplikaci od Google, která běží v terminálu. Nemějte obavy, pokud jste terminál ještě nikdy nepoužili – nastavení spočívá jen v několika zkopírovaných příkazech a stačí ho udělat jen jednou.

Článek jsme rozdělili do několika částí:


Než začnete

Budete potřebovat:

  • Node.js 20 nebo vyšší nainstalovaný na vašem počítači. Zkontrolujte příkazem node -v v terminálu, nebo stáhněte na nodejs.org.

  • Google účet k vytvoření bezplatného Gemini API klíče. Na rozdíl od ChatGPT nepotřebujete placený plán.

  • Přihlašovací údaje ke Smartsupp – během nastavení se přihlásíte do svého účtu Smartsupp pro schválení propojení.

🟡 Podmínka: Server Smartsupp MCP je dostupný v tarifu PLUS a vyšších.


Nastavit propojení

1. Nainstalujte Gemini CLI. Otevřete terminál (na Macu: aplikace Terminal, ve Windows: PowerShell) a spusťte:

npm install -g @google/gemini-cli

2. Vytvořte API klíč pro Gemini. Přejděte na Google AI Studio, přihlaste se svým Google účtem a klikněte na Vytvořit API klíč. Klíč si zkopírujte – budete ho potřebovat v dalším kroku.

3. Uložte API klíč. V terminálu spusťte následující příkaz (nahraďte your-key-here svým klíčem):

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

4. Přidejte propojení na Smartsupp. Otevřete soubor ~/.gemini/settings.json v libovolném textovém editoru (vytvořte ho, pokud ještě neexistuje) a vložte:

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

5. Spusťte Gemini. V terminálu spusťte gemini. Pokud budete dotázáni na způsob přihlášení, vyberte Použít Gemini API Key.

6. Ověřte propojení. V prostředí Gemini zadejte /mcp. Měli byste vidět:

🟢 smartsupp – Připraveno (19 nástrojů)


​7. Autorizujte propojení. Přitom když poprvé požádáte o data ze Smartsupp, otevře se v prohlížeči přihlašovací stránka Smartsupp. Přihlaste se a schvalte přístup – přístup schvalujete přihlášením se a Gemini vaše heslo ke Smartsupp nikdy nevidí.

⚠️ Poznámka: Autorizace automaticky využívá účet Smartsupp, ke kterému jste aktuálně přihlášeni ve svém prohlížeči. Pokud spravujete více účtů Smartsupp, zkontrolujte před povolením přístupů, ke kterému účtu jste přihlášeni.

8. Ověřte, zda vše funguje. Vyzkoušejte jednoduchý dotaz, například „Vypsat všechny agenty na mém účtu Smartsupp.“ Když Gemini odpoví seznamem agentů, propojení funguje správně.


Co vše můžete dělat

Po propojení může Gemini přistupovat k vašim datům ze Smartsupp a spravovat váš Inbox podle vašich pokynů. Stačí napsat, co potřebujete, běžnou větou:

  • „Shrňte včerejší konverzace a zvýrazněte ty, které stále potřebují odpověď.“

  • „Které konverzace jsou otevřené?“

  • „Kolik nových konverzací jsme měli minulý týden oproti týdnu předtím?“

Mezi typické využití patří (s příklady dotazů):

⚠️ Odpovědi a akce jsou skutečné. Vaše zpráva odeslaná prostřednictvím AI agenta jde do chatu zákazníkovi a uzavírání, přiřazování nebo štítkování mění Inbox pro celý tým. Než něco odešlete, zkontrolujte, co váš agent provede, zvlášť při provádění akcí nad více konverzacemi najednou.

💡 Další příklady dotazů, co zůstává ve Smartsupp a jak se s daty nakládá: Práce s Inboxem Smartsupp z vašeho AI agenta.


Důležité informace

  • Gemini pracuje s vašimi reálnými daty Smartsupp. Přístup autorizujete přihlášením (OAuth) – Gemini vaše heslo nikdy nezná.

  • Čtení (přehledy, statistiky, kontakty) je plně k dispozici. Akce (odpovědi, štítky, přiřazení) se provedou pouze na základě vašeho pokynu – Gemini si vždy vyžádá potvrzení před samotným provedením.

  • Přepnutí účtu Smartsupp: zavřete Gemini, smažte složku ~/.mcp-auth (příkaz rm -rf ~/.mcp-auth), spusťte Gemini znovu a přihlaste se s druhým účtem.


Řešení potíží

  • Chyba 401 při spuštění chatu: Gemini CLI čte soubor .env ze složky, odkud je spuštěna. Pokud má tato složka vlastní .env bez GEMINI_API_KEY, klíč nebude rozpoznán. Přidejte klíč i do tohoto souboru nebo spusťte Gemini z domovské složky.

  • smartsupp hlásí Odpojeno: zadejte v Gemini příkaz /mcp auth smartsupp. Pokud to nepomůže, smažte adresář ~/.mcp-auth a zkuste znovu.

  • npm install selže kvůli oprávněním (EACCES): instalaci přeskočte a spusťte Gemini přímo pomocí npx @google/gemini-cli.


Co dál?

💡 Potřebujete pomoc? Kontaktujte náš tým podpory – rádi vám pomůžeme!

Dostali jste odpověď na svou otázku?