Przejdź do głównej zawartości

Połącz Smartsupp z Google Gemini

Połącz swoje konto Smartsupp z Google Gemini i pracuj na danych z live czatu, korzystając z poleceń w prostym języku.

Napisane przez Michal Jindra

Połącz Smartsupp z Google Gemini i wygodnie pracuj na danych z live czatu, po prostu zadając pytania po polsku. Nie musisz już szukać po dashboardzie – wpisujesz zwykłe zdanie, a Gemini sam znajdzie potrzebne informacje, podsumuje je lub wykona za Ciebie potrzebną akcję.

Gemini nie udostępnia connectorów bezpośrednio w aplikacji webowej (w przeciwieństwie do ChatGPT czy Claude), dlatego integracja odbywa się przez Gemini CLI – darmową, oficjalną aplikację Google uruchamianą w terminalu. Jeśli nigdy nie korzystałeś z terminala, nie przejmuj się: instalacja to dosłownie kilka prostych komend kopiuj-wklej do jednorazowego wykonania.

Dla Twojej wygody podzieliliśmy instrukcję na sekcje:


Zanim zaczniesz

Przygotuj:

  • Node.js 20 lub nowszy zainstalowany na Twoim komputerze. Sprawdź wersję, wpisując node -v w terminalu lub pobierz ze strony nodejs.org.

  • Konto Google do utworzenia darmowego klucza API Gemini. W przeciwieństwie do ChatGPT nie potrzebujesz tu żadnej płatnej subskrypcji.

  • Swoje dane logowania do Smartsupp — podczas konfiguracji zalogujesz się, by zatwierdzić połączenie.

🟡 Wymagania: Serwer Smartsupp MCP jest dostępny w planie Plus i wyższych.


Konfiguracja połączenia

1. Zainstaluj Gemini CLI. Otwórz terminal (na Macu: Terminal, na Windows: PowerShell) i wpisz:

npm install -g @google/gemini-cli

2. Wygeneruj klucz API Gemini. Wejdź na Google AI Studio, zaloguj się na swoje konto Google i kliknij Utwórz klucz API. Skopiuj klucz, przyda się w następnym kroku.

3. Zapisz klucz API. W terminalu wpisz poniższą komendę (zamień your-key-here na swój skopiowany klucz):

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

4. Dodaj integrację Smartsupp. Otwórz plik ~/.gemini/settings.json w dowolnym edytorze tekstu (utwórz, jeśli nie istnieje) i wklej poniższy kod:

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

5. Uruchom Gemini. Wpisz w terminalu gemini. Jeśli pojawi się pytanie, jak się zalogować, wybierz Użyj klucza API Gemini.

6. Sprawdź połączenie. W Gemini wpisz /mcp. Po poprawnej konfiguracji zobaczysz:

🟢 smartsupp – Gotowe (19 narzędzi)


​7. Autoryzuj dostęp. Przy pierwszej próbie pytania o dane ze Smartsupp, w przeglądarce otworzy się okno logowania do Smartsupp. Zaloguj się, aby potwierdzić dostęp – połączenie autoryzujesz przez logowanie, a Gemini nigdy nie pozna Twojego hasła do Smartsupp.

⚠️ Uwaga: Autoryzacja wykorzystuje aktualne konto Smartsupp, na którym jesteś zalogowany w przeglądarce. Jeśli masz więcej niż jedno konto Smartsupp, upewnij się, że jesteś na właściwym, zanim potwierdzisz połączenie.

8. Sprawdź działanie. Przetestuj prostym zapytaniem, np. "Wypisz wszystkich agentów na moim koncie Smartsupp." Jeśli Gemini odeśle listę agentów, wszystko działa!


Co możesz zrobić

Po połączeniu Gemini ma dostęp do danych z Twojego konta Smartsupp i może pomóc w zarządzaniu skrzynką odbiorczą na Twoją prośbę. Wystarczy, że napiszesz po polsku, czego potrzebujesz, np.:

  • "Podsumuj wczorajsze rozmowy i wyróżnij te, które wciąż czekają na odpowiedź."

  • "Które rozmowy są nadal otwarte?"

  • "Ile nowych rozmów mieliśmy w zeszłym tygodniu w porównaniu z wcześniejszym?"

Najpopularniejsze zastosowania (przykładowe prompt’y):

⚠️ Odpowiedzi i działania są rzeczywiste. Wiadomości wysłane przez Asystenta AI trafiają do rozmowy z klientem, a wszelkie zamykanie, przypisywanie czy oznaczanie rozmów zmienia sytuację dla całego zespołu. Zawsze przeczytaj, co Asystent zamierza zrobić, zanim to potwierdzisz – zwłaszcza przy działaniach na wielu wątkach naraz.

💡 Jeszcze więcej przykładów promptów i szczegóły odnośnie tego, które dane zostają w Smartsupp oraz jak są przetwarzane – znajdziesz tutaj: Praca z Twoją skrzynką Smartsupp przez Asystenta AI.


Warto wiedzieć

  • Gemini korzysta z prawdziwych danych Twojego Smartsupp. Dostęp zatwierdzasz (OAuth) przez logowanie – Gemini nie zna Twojego hasła.

  • Podgląd (przeglądy, statystyki, kontakty) jest zawsze dostępny. Akcje (odpowiedzi, tagi, przypisania) są wykonywane tylko na Twoją wyraźną prośbę – za każdym razem Gemini zapyta o potwierdzenie przed wykonaniem zadania.

  • Zmiana konta Smartsupp: zamknij Gemini, usuń folder ~/.mcp-auth (polecenie rm -rf ~/.mcp-auth), następnie otwórz Gemini ponownie i zaloguj się na inne konto.


Rozwiązywanie problemów

  • Błąd 401 podczas startu czatu: Gemini CLI czyta plik .env z katalogu, z którego jest uruchamiany. Jeśli w tym folderze jest własny .env bez GEMINI_API_KEY, klucz nie zostanie wczytany. Dodaj klucz do tego pliku lub uruchom Gemini z katalogu domowego.

  • smartsupp pokazuje Rozłączono: wpisz /mcp auth smartsupp w Gemini. Jeżeli to nie zadziała, usuń ~/.mcp-auth i spróbuj jeszcze raz.

  • npm install kończy się błędem uprawnień (EACCES): pomiń instalację i uruchom Gemini bezpośrednio poleceniem npx @google/gemini-cli.


Co dalej?

💡 Potrzebujesz pomocy? Skontaktuj się z naszym zespołem wsparcia — chętnie pomożemy!

Czy to odpowiedziało na twoje pytanie?