Gemini · Google

Gemini Telegram MCP - для Gemini і CLI

Використовуйте Entergram як Telegram MCP-сервер для Google Gemini і Gemini CLI. Дайте Gemini безпечний доступ до ваших справжніх чатів Telegram, обмежений областями OAuth, щоб він знаходив пропущені повідомлення, клієнтів, які чекають, і ліди, що охололи.

URL сервера MCP https://mcp.entergram.com/mcp

Почати безкоштовно Переглянути всі конектори

Підключіть Gemini за 3 кроки

Працює з Gemini CLI і MCP-сумісними клієнтами Gemini.

URL сервера MCP https://mcp.entergram.com/mcp

Почніть з Entergram: URL вашого сервера зберігається в Settings → Workspace → Connectors → MCP. Скопіюйте його в буфер обміну, бо Gemini CLI читає його з файлу конфігурації, а не з поля введення.
Додайте Entergram до конфігурації MCP у Gemini CLI з URL: https://mcp.entergram.com/mcp.
Запустіть CLI знову, щоб він підхопив новий сервер, увійдіть в Entergram у браузері, який він відкриє, і надайте обмежений доступ до свого робочого простору.

Питайте Gemini про те, чого ніколи не спитаєте в Telegram

Коли ваш особистий акаунт підключено, Gemini може аналізувати всі чати одночасно. Спробуйте такі промпти:

«У яких чатах є запитання без відповіді за останні три дні?»
«Покажи контакти з моєї групи клієнтів, яких немає в групі спільноти.»
«Опублікуй вміст build.log у каналі релізів.»
«Створи канал Launch Updates і запроси туди основну команду.»
«Виправ одруківку в моєму останньому повідомленні в розмові з Acme.»
«Експортуй тікети за цей місяць у TSV, щоб я вставив їх у таблицю.»

Що Gemini може робити з вашим Telegram

І Gemini CLI, і MCP-сумісні клієнти Gemini можуть реєструвати зовнішні MCP-сервери. Додайте URL Entergram, і Gemini отримає обмежений і захищений OAuth доступ до вашого справжнього особистого акаунта Telegram. Жодного бота для підтримки, жодного коду, жодних ключів API для зберігання.

Робити запити до ваших чатів, не виходячи з термінала
Порівнювати список клієнтів зі складом спільноти
Публікувати результат збірки або файл просто в чат
Створювати канал і одразу додавати туди потрібних учасників
Виправляти повідомлення на місці замість повторного надсилання
Експортувати дані тікетів як текст із табуляцією для таблиці

Завдання для термінала, які варто налаштувати

У CLI це однорядкові виклики, які можна повісити на аліас оболонки або git hook. Кожне запитання звичайною мовою розгортається в послідовність викликів інструментів, і CLI друкує, які саме виклики зробив. Тож ви бачите механіку, перш ніж довірити йому запис. Усе нижче передбачає, що сервер один раз зареєстровано й авторизовано; далі лишається тільки друкувати.

Дізнатися більше

Ви питаєте

«Опублікуй нотатки до релізу з CHANGELOG.md у бета-каналі.»

Викликані інструменти

entergram_list_accountsentergram_list_groupsentergram_send_message

Ви отримуєте

Крок після деплою, про який ніхто не пам'ятає. Changelog уже є в контексті Gemini з репозиторію; він обирає акаунт, що адмініструє канал, знаходить канал за назвою й публікує. Прив'яжіть це до успішної збірки, і оголошення більше не залежатиме від чиєїсь пам'яті.

Ви питаєте

«Хто в бета-каналі ніколи не був позначений у нас як платний клієнт?»

Викликані інструменти

entergram_list_group_membersentergram_list_contactsentergram_get_chat_custom_fields

Ви отримуєте

Різниця множин між двома системами, які зазвичай живуть у різних вкладках браузера. Він отримує склад каналу, зіставляє цих людей із вашим списком контактів, а потім читає поля CRM, щоб побачити, у кого стоїть позначка клієнта. У результаті ви отримуєте поіменно ту половину спільноти, яка ще не стала клієнтами.

Ви питаєте

«Надішли вивід тестів, що впали, у розмову з Acme з коротким поясненням.»

Викликані інструменти

entergram_list_chatsentergram_send_media_message

Ви отримуєте

Файл уже лежить на диску поруч із вами, тож уся морока із завантаженням відпадає. Gemini прикріплює файл і сам пише супровідний рядок. Саме в цьому різниця між клієнтом, який бачить стіну стек-трейсу, і клієнтом, який бачить, що зламалося і коли це виправлять.

Ви питаєте

«Створи канал для запуску, дай йому нормальну назву й додай команду релізу.»

Викликані інструменти

entergram_create_channelentergram_update_chat_infoentergram_invite_chat_members

Ви отримуєте

Три кроки в інтерфейсі Telegram стискаються до одного речення. Канал створено, назву й опис задано з вашого опису, а список запрошених визначено з ваших контактів. Для цього потрібен конектор робочого простору: адміністрування груп не входить до набору областей доступу особистого агента.

Ви питаєте

«Я помилився в номері версії в тому оголошенні, виправ.»

Викликані інструменти

entergram_list_messagesentergram_edit_message

Ви отримуєте

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

Ви питаєте

«Дай мені кількість тікетів за цей тиждень за виконавцями у форматі TSV.»

Викликані інструменти

entergram_list_ticketsentergram_list_ticket_custom_columnsentergram_list_members

Ви отримуєте

Саме у форматуванні виводу термінальний клієнт показує свою цінність. Він отримує чергу, зіставляє колонки категорії й серйозності з їхніми справжніми значеннями, перетворює ID виконавців на імена людей і друкує рядки з табуляцією, які можна одразу передати в таблицю або скрипт для графіка. Звітність на льоту, і нікому не треба спершу будувати звіт.

Історія користувача · Revenue operations

Щотижнева звірка воронки між Telegram і HubSpot

Той самий промпт може запускатися для кожної ідентичності Telegram, але результат має зберігати походження: який акаунт вів розмову, з яким записом HubSpot її зіставлено і що змінилося з попереднього запуску.

Дізнатися більше

П'ятничний огляд воронки включає угоди, які існували лише в Telegram

Продавці використовують різні акаунти Telegram для регіонів і брендів. До п'ятниці CRM відображає зустрічі й листи, але пропускає обговорення цін, заперечення й наступні кроки, про які домовилися в Telegram.

Інструкція

Для кожного підключеного акаунта Telegram переглянь чати, оновлені цього тижня. Зіставляй бізнес-контакти з HubSpot за підтвердженим телефоном, електронною адресою або наявним зовнішнім ID, ніколи лише за відображуваним ім'ям. Склади таблицю звірки. Для зіставлених угод запропонуй нотатку з назвою акаунта, останнім рішенням і наступною дією. Незіставлені кваліфіковані ліди винеси в окремий список для перевірки. Опублікуй фінальне зведення в Slack і не створюй та не об'єднуй контакти без погодження.

Що отримує команда

Revenue operations бачить, які розмови в Telegram просунулися, застопорилися або так і не дійшли до HubSpot. Кожна нотатка в CRM містить вихідний акаунт і діапазон дат, тож менеджер може простежити підсумок до реальної розмови.

Періодичність

Щотижня через cron або заплановане завдання Gemini CLI

Gemini визначає значення account_id і читає зміни за сім днів для кожного акаунта.
Скрипт-обгортка робить запити до HubSpot, застосовує детерміновані ключі зіставлення й просить Gemini підсумувати лише пов'язані чати.
Погоджені нотатки записуються в HubSpot; підсумки по всіх акаунтах і список незіставлених потрапляють у Slack.

Перевірка реальністю

Gemini CLI дає міркування й інструменти Entergram MCP; HubSpot і Slack потребують власних облікових даних API або MCP-конекторів. Для запусків без нагляду використовуйте планувальник, який ви контролюєте, зберігайте час останнього запуску й вимагайте перевірки перед створенням або об'єднанням записів CRM.

Де зареєструвати сервер

Дізнатися більше

Gemini CLI, рівень користувача

Основний шлях, і саме це більшість має на увазі під Gemini MCP. Додайте сервер у ~/.gemini/settings.json у розділ mcpServers, де httpUrl вказує на розміщений ендпоінт, перезапустіть CLI, і інструменти стануть доступні в кожному проєкті на цьому комп'ютері. Оскільки це віддалений HTTPS, немає ні обгортки npx, ні мосту stdio, який треба тримати запущеним.

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

Gemini CLI, рівень проєкту

Той самий блок у .gemini/settings.json усередині репозиторію діє лише для цієї робочої копії. Це зручно, коли один репозиторій є пайплайном деплою, що оголошує релізи в каналі Telegram, а решті вашої роботи чати ні до чого. До того ж конфігурація лишається в системі контролю версій, де її може прочитати колега.

mkdir -p .gemini && $EDITOR .gemini/settings.json

Будь-який клієнт на моделі Gemini

Ендпоінт не залежить від моделі. Агент в IDE, скриптова обв'язка чи внутрішній інструмент, що працює на Gemini, реєструє Entergram так, як вимагає його власна конфігурація MCP, і отримує той самий список інструментів. Екран згоди належить Entergram, тож кожен, хто запускає клієнт, авторизується сам, а не успадковує чужий дозвіл.

Набір інструментів у CLI

Після підключення виведіть список зареєстрованих MCP-серверів, і всі 78 інструментів з'являться під entergram, згруповані так, як показано нижче. Назви інструментів є буквальними ідентифікаторами, і в терміналі це важить більше, ніж у вікні чату: ви можете назвати виклик прямо в промпті, коли потрібна детермінована поведінка, а не маршрут, обраний моделлю. CLI друкує кожен виклик і його аргументи по ходу, тож незнайомий список інструментів швидко засвоюється.

Дізнатися більше

Показати всі інструменти (78, груп: 9) →

Згода для кожного комп'ютера окремо

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

Дізнатися більше

Набір областей особистого агента: Будь-який учасник може створити його, не питаючи адміністратора. Він охоплює читання робочого простору, підключених акаунтів, контактів, чатів, повідомлень і тікетів, а також запис значень власних полів у ваших власних чатах. Цього досить для кожного завдання з аналізу й експорту на цій сторінці, але не досить, щоб надіслати повідомлення.
Набір областей конектора робочого простору: Доступний лише власникам і адміністраторам, і саме він справді потрібен автоматизації. Він додає надсилання, медіа, редагування, запис тікетів, запис власних полів у всьому робочому просторі й адміністрування груп Telegram. Оскільки він спільний, а не особистий, ставтеся до комп'ютера, на якому його авторизуєте, з відповідною обережністю.
Як розірвати підключення: Видалення запису в mcpServers зупиняє виклики сервера з CLI, але нічого не анулює. Щоб справді закрити доступ, відкличте клієнт на боці Entergram у Settings → Workspace → Connectors → MCP. Це діє одразу на всіх комп'ютерах, що ним користувалися.

Обмеження, які варто врахувати в дизайні

Більшість із них дається взнаки лише тоді, коли ви намагаєтеся запускати CLI без нагляду.

Дізнатися більше

Зареєструвати сервер не те саме, що авторизувати його. Кожен комп'ютер уперше проходить екран згоди самостійно, тож новому ноутбуку чи перезібраному контейнеру хоча б раз потрібен браузер.
Робочий простір Entergram має бути на тарифі Pro. На нижчому тарифі CLI спокійно покаже сервер у списку, а потім збиратиме відмови на кожен виклик. Це схоже на зламану конфігурацію, але нею не є.
Неявного акаунта немає. Інструменти повідомлень вимагають явного account_id, тож будь-який скрипт має спершу отримати список акаунтів. У чаті це майже непомітно, у пайплайні це ще одна річ, про яку треба пам'ятати. Отримайте його один раз на початку скрипта й передавайте далі.
Особистий агент не може надсилати повідомлення й адмініструвати групи. Автоматизаціям, які публікують нотатки до релізу або створюють канали, потрібен конектор робочого простору, авторизований власником або адміністратором.
Протокол працює за принципом запит і відповідь, а не підписки. Нічого не приходить у ваш термінал без запиту; Gemini дізнається про нове повідомлення лише тоді, коли його попросять подивитися. Усе, що схоже на моніторинг, має бути запланованим завданням, яким керуєте ви.
CLI не підвищує жодних прав. Він бачить рівно ті чати, які бачить ваш власний акаунт Telegram, і групу, з якої ви вийшли, прочитати не може.

Проблеми з CLI та їхні причини

Дізнатися більше

Сервер так і не з'являється в списку MCP

Майже завжди це некоректний JSON: одна зайва кома в кінці змушує CLI мовчки відкинути весь файл налаштувань. Перевірте його валідатором, переконайтеся, що для віддаленого HTTPS-сервера ключ саме httpUrl, а не запис stdio з command і args, і що запис справді стоїть усередині mcpServers.

Зміни в settings.json ні на що не впливають

Конфігурація зчитується під час запуску. Повністю вийдіть із сесії й запустіть знову: запущений процес і далі віддає список інструментів, який склав під час старту, тож файл може бути правильним і все одно здаватися проігнорованим.

OAuth не завершується на комп'ютері без дисплея

Екрану згоди потрібен браузер. Авторизуйтеся на робочій станції, яку ви бачите, або прокиньте порт зворотного виклику через SSH. Агент збірки без дисплея не може сам завершити цей обмін.

В одній теці працює, в іншій ні

У вас два файли налаштувань. Той, що в ~/.gemini, діє всюди, а той, що в .gemini усередині репозиторію, діє лише там. Перш ніж редагувати щось інше, перевірте, у якому з них насправді є запис entergram.

Кожен виклик повертає 403

Спершу перевірте тариф, потім роль. Доступ до MCP потребує тарифу Pro, а все, що виходить за межі набору областей особистого агента, потребує прав власника або адміністратора в робочому просторі Entergram.

Читання працює, а надсилання відхиляється

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