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

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

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

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

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 в терминале. Если появится вопрос о способе входа, выберите Use Gemini API Key.

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

🟢 smartsupp – Ready (19 tools)


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

⚠️ Примечание: авторизация автоматически использует аккаунт Smartsupp, в который Вы сейчас вошли в своём браузере. Если Вы управляете несколькими аккаунтами Smartsupp, перед авторизацией ещё раз проверьте, что вошли в нужный аккаунт.

8. Убедитесь, что всё работает. Попробуйте простой запрос, например «Перечисли всех агентов в моём аккаунте Smartsupp». Если Gemini ответит списком агентов, подключение успешно установлено.

Что можно делать

После подключения Gemini может читать данные Smartsupp и управлять Вашим inbox по Вашим инструкциям. Просто опишите, что Вам нужно, обычным предложением:

Обзор разговоров

  • «Покажи мне разговоры за последнюю неделю»

  • «Сделай краткое резюме этого разговора в трёх предложениях»

  • «Какие разговоры всё ещё открыты?»

Статистика

  • «Сколько новых разговоров у нас было на прошлой неделе?»

  • «Разбей количество новых разговоров по дням»

Контакты

  • «Найди контакт с эл. почтой jan@example.com»

  • «Какие теги у этого клиента?»

Теги

  • «Добавь к этому разговору тег Complaint»

  • «Создай новый тег с названием VIP»

Управление разговорами

  • «Назначь этот разговор агенту Marie»

  • «Закрой этот разговор»

Ответы в чат

  • «Отправь в этот разговор: Спасибо за ожидание, мы уже занимаемся Вашим вопросом»

💡 Идеи, которые можно попробовать: утренний дайджест («Сделай сводку вчерашних разговоров и выдели те, которые требуют ответа»), или короткий отчёт («Сравни количество новых разговоров на этой неделе и на прошлой»).

Полезная информация

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

  • Чтение (обзоры, статистика, контакты) доступно полностью. Действия (ответы, теги, назначения) выполняются только по Вашему запросу — и перед запуском 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.

Что дальше?

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

Другие статьи по теме
Нашли ответ на свой вопрос?