К основному содержимому

Подключение Smartsupp к Google Gemini

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

Автор: Michal Jindra

Подключите Smartsupp к Google Gemini и работайте с данными живого чата, просто задавая вопросы. Вместо переходов по разделам панели управления Вы вводите обычное предложение — Gemini находит информацию, обобщает её или выполняет действие за Вас.

В веб-приложении Gemini нет раздела коннекторов (в отличие от ChatGPT или Claude), поэтому подключение осуществляется через Gemini CLI — бесплатное официальное приложение от Google, которое работает в терминале. Не беспокойтесь, если Вы раньше не пользовались терминалом: настройка сводится к копированию и вставке нескольких команд, и выполнить её нужно только один раз.

Мы разделили статью на несколько разделов:


Перед началом

Вам понадобятся:

  • Node.js 20 или новее установленный на Вашем компьютере. Чтобы проверить установку, выполните node -v в терминале или скачайте Node.js на nodejs.org.

  • Аккаунт Google для создания бесплатного API-ключа Gemini. В отличие от ChatGPT, платный план Вам не нужен.

  • Ваши данные для входа в Smartsupp — во время настройки Вы войдёте в свой аккаунт Smartsupp, чтобы подтвердить подключение.

🟡 Требование: MCP-сервер Smartsupp доступен на плане PLUS и выше.


Настройка подключения

1. Установите Gemini CLI. Откройте терминал (на Mac: приложение «Терминал», на 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.


Что дальше?

💡 Нужна дополнительная помощь? Обратитесь в нашу Службу поддержки — мы будем рады помочь!

Нашли ответ на свой вопрос?