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

Підключіть 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 Для створення безкоштовного ключа API Gemini. На відміну від ChatGPT, вам не потрібен платний план.

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

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


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

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

npm install -g @google/gemini-cli

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

3. Збережіть ключ API. Виконайте цю команду в терміналі (замініть 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 У терміналі. Якщо з’явиться запит щодо способу входу, виберіть Використати ключ API Gemini.

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

🟢 smartsupp – Ready (19 tools)


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

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

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


Що ви можете робити

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

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

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

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

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

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

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


Корисно знати

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

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

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


Усунення несправностей

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

  • Smartsupp показує статус «Відключено»: Введіть /mcp auth smartsupp У Gemini. Якщо це не допоможе, видаліть ~/.mcp-auth І спробуйте ще раз.

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


Що далі?

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

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