Перейти до основного контенту

Підключіть Smartsupp до Google Gemini

Підключіть свій обліковий запис Smartsupp до Google Gemini і працюйте з даними живого чату за допомогою запитів у природній мові.

Автор: Michal Jindra

Підключіть Smartsupp до Google Gemini і отримуйте відповіді на ключові запитання щодо ваших даних живого чату так само просто, як написати звичайне речення. Більше не потрібно витрачати час на навігацію панеллю управління: просто сформулюйте запит, а Gemini знайде потрібну інформацію, підсумує її або виконає потрібну дію замість вас.

У Gemini, на відміну від ChatGPT чи Claude, немає розділу конекторів у вебдодатку: підключення здійснюється через Gemini CLI — безкоштовний офіційний додаток від Google, який працює у терміналі. Не хвилюйтеся, якщо ще не працювали з терміналом: налаштування займає лише кілька хвилин і складається з кількох простих команд для копіювання й вставки, які потрібно виконати лише раз.

Статтю розбито на такі розділи:


Перед початком

Вам знадобиться:

  • Node.js 20 або новіша встановлена на вашому комп’ютері. Перевірте це, виконавши node -v у терміналі, або завантажте його на nodejs.org.

  • Обліковий запис Google, щоб створити безкоштовний ключ Gemini API. На відміну від ChatGPT, тут не потрібен жоден платний план.

  • Ваші дані для входу в Smartsupp — під час налаштування потрібно увійти у свій обліковий запис Smartsupp для підтвердження підключення.

🟡 Вимога: Сервер Smartsupp MCP доступний на тарифі Plus і вище.


Налаштування підключення

1. Встановіть Gemini CLI. Відкрийте термінал (на Mac: додаток Terminal, на Windows: PowerShell) і виконайте команду:

npm install -g @google/gemini-cli

2. Створіть ключ Gemini API. Перейдіть у Google AI Studio, увійдіть у свій обліковий запис Google й натисніть Створити API key. Скопіюйте ключ — він знадобиться на наступному кроці.

3. Збережіть API key. Виконайте у терміналі цю команду (замініть your-key-here на скопійований ключ):

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

4. Додайте підключення Smartsupp. Відкрийте файл ~/.gemini/settings.json у будь-якому текстовому редакторі (створіть його, якщо файл відсутній) і вставте наступне:

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

5. Запустіть Gemini. Виконайте gemini у терміналі. Якщо з’явиться запит щодо способу входу — оберіть Використовувати Gemini API Key.

6. Перевірте підключення. Введіть у Gemini команду /mcp. Ви маєте побачити:

🟢 smartsupp – Готово (19 інструментів)


​7. Авторизуйте підключення. Під час першого запиту до даних Smartsupp відкриється сторінка входу Smartsupp у браузері. Увійдіть, щоб підтвердити доступ — ви дозволяєте підключення через обліковий запис, а пароль Smartsupp недоступний Gemini.

⚠️ Зверніть увагу: Авторизація автоматично використовує той обліковий запис Smartsupp, у який вже здійснено вхід у браузері. Якщо ви керуєте декількома обліковими записами Smartsupp, переконайтеся, що ввійшли у потрібний перед авторизацією.

8. Переконайтеся, що все працює. Спробуйте, наприклад, такий запит: "Перелічити всіх агентів у моєму обліковому записі Smartsupp." Якщо Gemini поверне список агентів — підключення виконано успішно.


Можливості

Після підключення Gemini може переглядати ваші дані Smartsupp і керувати вашою поштовою скринькою на ваш запит. Просто сформулюйте, що потрібно, як звичайне речення:

  • "Підсумуй учорашні розмови та виділи ті, що ще потребують відповіді."

  • "Які розмови ще відкриті?"

  • "Скільки нових розмов було минулого тижня порівняно з попереднім?"

Типові варіанти використання (з прикладами запитів):

⚠️ Відповіді та дії справжні. Повідомлення, яке ви відправляєте через AI асистента, потрапляє у чат клієнта, а закриття, призначення чи тегування змінюють поштову скриньку для всієї команди. Перевіряйте, що ваш асистент збирається зробити, перед виконанням дії, особливо якщо це стосується багатьох розмов одночасно.

💡 Більше прикладів запитів, що залишається в Smartsupp, і як обробляються ваші дані: Працюйте з поштовою скринькою Smartsupp у своєму AI асистенті.


Корисна інформація

  • Gemini працює з вашими реальними даними Smartsupp. Ви підтверджуєте доступ за допомогою входу (OAuth) — пароль Smartsupp не передається Gemini.

  • Читання (огляди, статистика, контакти) повністю доступні. Дії (відповіді, теги, призначення) виконуються лише на ваш запит — і кожного разу потрібно підтвердження.

  • Щоб змінити обліковий запис Smartsupp: закрийте Gemini, видаліть папку ~/.mcp-auth (виконайте rm -rf ~/.mcp-auth), запустіть Gemini знову й увійдіть з іншим обліковим записом.


Вирішення проблем

  • Помилка 401 при запуску чату: Gemini CLI зчитує файл .env із папки, в якій ви його запускаєте. Якщо в цій папці є .env без GEMINI_API_KEY, ключ не підтягується. Додайте ключ у цей файл або запускайте Gemini з домашньої папки.

  • smartsupp показує Disconnected: введіть у Gemini /mcp auth smartsupp. Якщо не допомагає, видаліть ~/.mcp-auth і спробуйте ще раз.

  • npm install завершується помилкою доступу (EACCES): пропустіть цей крок і запустіть Gemini напряму командою npx @google/gemini-cli.


Що далі?

💡 Потрібна допомога? Зверніться до нашої служби підтримки — ми завжди готові допомогти!

Ви отримали відповідь на своє запитання?