Як підключити Google Gemini до ваших чатів Telegram

Щоб підключити Google Gemini до ваших чатів Telegram, зареєструйте хмарний MCP-сервер Entergram, https://mcp.entergram.com/mcp, у Gemini CLI і один раз увійдіть в Entergram у браузері. Після цього Gemini може читати ваші чати, контакти й дані CRM через ваш справжній особистий акаунт Telegram і діяти в межах наданих вами дозволів. Налаштування складається з трьох кроків і одного невеликого блоку JSON, наведеного нижче.

Саме Gemini CLI докладно описано на сторінці Gemini Telegram MCP. Будь-який інший клієнт, сумісний з MCP, що працює з моделлю Gemini, може використовувати ту саму URL-адресу, зареєстровану так, як цього вимагає клієнт.

• Робочий простір на тарифі Pro. API & MCP це функція тарифу Pro. На нижчому тарифі CLI все одно покаже сервер у списку, але кожен виклик буде відхилено. Це схоже на зламану конфігурацію, хоча насправді нею не є.
• Щонайменше один підключений акаунт Telegram на вашому місці. Особистий конектор може використовувати лише акаунти Telegram, указані для вашого учасника в розділі Settings → Accounts (Налаштування → Акаунти).
• Браузер на комп'ютері для першого входу. Він потрібен для екрана згоди, тож сервер без графічного інтерфейсу спершу треба авторизувати з робочої станції.

Крок 1: скопіюйте URL-адресу MCP в Entergram

Перейдіть у Settings → Workspace → Connectors → MCP (Налаштування → Робочий простір → Конектори → MCP) і скопіюйте URL-адресу MCP-сервера. Вона однакова для всіх клієнтів:

https://mcp.entergram.com/mcp

Крок 2: зареєструйте сервер у Gemini CLI

Додайте Entergram у розділ mcpServers файлу ~/.gemini/settings.json. Оскільки сервер віддалений і працює через HTTPS, ключ називається httpUrl, а не запис із командою та аргументами:

{
  "mcpServers": {
    "entergram": {
      "httpUrl": "https://mcp.entergram.com/mcp"
    }
  }
}

Файл у домашньому каталозі діє для всіх проєктів на цьому комп'ютері. Щоб обмежити доступ до Telegram одним репозиторієм, помістіть той самий блок у .gemini/settings.json усередині цього репозиторію.

Крок 3: перезапустіть CLI та авторизуйтеся

CLI читає конфігурацію під час запуску, тому повністю завершіть сесію й запустіть її знову. Увійдіть в Entergram у вікні браузера, що відкриється, і надайте дозволи, які хочете дати Gemini. У settings.json немає жодних облікових даних: файл лише вказує, де розташований сервер, а доступ надає вхід через OAuth.

Після авторизації виведіть у CLI список зареєстрованих MCP-серверів, і інструменти Entergram з'являться під назвою entergram.

Те, що може робити Gemini, залежить від типу клієнта, який ви авторизуєте, як описано на сторінці довідки про MCP-конектори:

Особистий агент не може надсилати повідомлення в Telegram. Якщо читання працює, а надсилання відхиляється, це межа дозволів, а не помилка. Власник або адміністратор має авторизувати конектор робочого простору, і ви повторно проходите процедуру згоди вже для нього. У будь-якому разі надавайте мінімальний набір дозволів, потрібний для завдання: messages.write дозволяє агенту надсилати повідомлення від вашого імені.

Щоб закрити доступ, відкличте клієнт в Entergram у розділі Settings → Workspace → Connectors → MCP. Видалення запису з mcpServers лише зупиняє виклики сервера з CLI, але не анулює наданий дозвіл.

MCP-сервер Entergram підключається до вашого особистого акаунта Telegram, а не до бота, тож Gemini працює з тими самими чатами, що бачите ви. Запити, які добре працюють у CLI:

• «У яких чатах є питання без відповіді за останні три дні?»
• «Покажи контакти з моєї групи клієнтів, яких немає в групі спільноти.»
• «Опублікуй примітки до випуску з CHANGELOG.md у бета-канал.» (потрібен конектор робочого простору)
• «Я помилився в номері версії в тому оголошенні, виправ.» (потрібен конектор робочого простору)
• «Дай кількість тікетів за цей тиждень за виконавцями у форматі TSV.»

CLI виводить кожен виклик інструмента, який робить, тож ви можете спостерігати за механікою на завданні лише для читання, перш ніж довірити йому запис.

• Інструментам повідомлень потрібен явно вказаний акаунт. Неявного значення за замовчуванням немає, тож скрипт має спершу отримати список акаунтів і передати далі ідентифікатор акаунта.
• Нічого не надходить саме собою. MCP працює за схемою запит і відповідь. Gemini дізнається про нове повідомлення лише тоді, коли ви або ваше заплановане завдання попросите його перевірити.
• Жодного розширеного доступу. Gemini бачить рівно те, що бачать ваші підключені акаунти Telegram. Групу, з якої ви вийшли, він прочитати не може, а чати, які ви виключили в Accounts → Exclude chats (Акаунти → Виключити чати), не потрапляють у результати MCP.

• Сервер так і не з'являється у списку MCP. Зазвичай причина в некоректному JSON: одна зайва кома в кінці змушує CLI відкинути весь файл налаштувань. Перевірте, що запис використовує httpUrl і розташований усередині mcpServers.
• Зміни в settings.json ніби нічого не дають. Повністю завершіть сесію й запустіть знову. Запущений процес зберігає список інструментів, сформований під час запуску.
• В одному каталозі працює, а в іншому ні. У вас два файли налаштувань. Перевірте, де розташований запис entergram: у ~/.gemini чи в папці .gemini репозиторію.
• Кожен виклик повертає 403. Спершу перевірте тариф (для MCP потрібен Pro), потім роль: усе, що виходить за межі дозволів особистого агента, потребує власника або адміністратора.

MCP-сервер Entergram однаковий для всіх клієнтів. Налаштуйте його один раз, і ви зможете підключити будь-який клієнт ШІ, який вам до вподоби, або кілька одразу:

• Підключіть Claude до Telegram через Entergram
• Підключіть ChatGPT до Telegram через Entergram
• Підключіть будь-який інструмент ШІ до Telegram MCP

Повний список інструментів для Gemini, приклади для окремого проєкту та заплановані завдання дивіться на сторінці Gemini Telegram MCP. Щоб зрозуміти, що сервер робить для будь-якого клієнта, почніть зі сторінки Telegram MCP-сервера.