Към основното съдържание

Свържете 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 app, на 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 инструмента)


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

⚠️ Забележка: Одобрението автоматично използва Smartsupp акаунта, с който сте влезли в браузъра в момента. Ако управлявате повече от един Smartsupp акаунт, проверете с кой акаунт сте влезли, преди да одобрите достъпа.

8. Проверете дали работи. Пробвайте проста заявка, например "Списък на всички агенти в моя Smartsupp акаунт." Ако Gemini отговори с Вашия списък с агенти, връзката работи коректно.


Какво можете да правите

След като свържете Smartsupp с Gemini, Gemini може да прочете Вашите Smartsupp данни и да управлява Вашата пощенска кутия според инструкциите Ви. Просто напишете каквото желаете като нормално изречение:

  • "Обобщи вчерашните разговори и подчертавай онези, на които още няма отговор."

  • "Кои разговори все още са отворени?"

  • "Колко нови разговора имахме миналата седмица спрямо предходната?"

Типични употреби (с примерни заявки):

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

💡 Още примери, информация какво остава в Smartsupp и как се обработват Вашите данни: Работете с Вашата 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 от начален (home) каталог.

  • smartsupp показва Disconnected: въведете /mcp auth smartsupp в Gemini. Ако това не помогне, изтрийте ~/.mcp-auth и опитайте отново.

  • npm install връща грешка с права (EACCES): пропуснете инсталирането и стартирайте Gemini направо с npx @google/gemini-cli.


Какво следва?

💡 Нужда от още помощ? Свържете се с нашия екип за поддръжка — с удоволствие ще Ви съдействаме!

Това отговори ли на въпроса ви?