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

Подключите 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 ключ. Скопируйте ключ — он понадобится на следующем этапе.

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 в терминале. Если вам предложат выбрать метод входа, выберите Использовать ключ Gemini API.

6. Проверьте подключение. Внутри Gemini введите /mcp. Должно появиться:

🟢 smartsupp – Готово (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 никогда не получает ваш пароль.

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

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


Устранение неполадок

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

  • Smartsupp отображается как Disconnected: введите /mcp auth smartsupp внутри Gemini. Если это не помогло — удалите ~/.mcp-auth и попробуйте снова.

  • npm install выдает ошибку прав (EACCES): пропустите установку и запустите Gemini напрямую через npx @google/gemini-cli.


Что дальше?

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

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