Перейти до основного вмісту
Усі конектори Telegram MCP

opencode · SST

opencode Telegram MCP - доручіть свої вхідні агентові в терміналі

Додайте Entergram як MCP-сервер в opencode, термінальний AI-агент із відкритим кодом від SST, і дозвольте йому працювати з вашим справжнім акаунтом Telegram: знаходити пропущені повідомлення, повертатися до лідів, що охололи, і діяти в чатах із командного рядка.

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

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

Працює з TUI та CLI opencode.

URL сервера MCP https://mcp.entergram.com/mcp
  1. Скопіюйте адресу сервера в Entergram у Settings → Workspace → Connectors → MCP. opencode читає її з opencode.json, тож вставлятимете ви її у файл, а не в промпт.

  2. У своєму opencode.json додайте Entergram у блок "mcp" як віддалений сервер, що вказує на MCP URL Entergram: https://mcp.entergram.com/mcp.

  3. Запустіть opencode, увійдіть зі своїм акаунтом Entergram і натисніть Allow access, щоб надати обмежений доступ. Після цього opencode може читати ваш акаунт Telegram і діяти в ньому під час сесій.

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

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

  1. «Відкрий канал для інциденту й додай туди всіх, хто зараз чергує.»

  2. «Опублікуй підсумок деплою в каналі оновлень для клієнтів.»

  3. «Скільки тікетів ще відкрито, перш ніж я зроблю реліз?»

  4. «Знайди чати, де згадують міграцію, і підсумуй занепокоєння.»

  5. «Додай до того треду нотатку з планом відкату.»

  6. «Хто в бета-групі не відповів на повідомлення про оновлення?»

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

opencode завантажує MCP-сервери зі свого файлу конфігурації. Зареєструйте сервер Entergram як віддалений MCP-сервер, і агент із відкритим кодом від SST працюватиме з вашим справжнім особистим акаунтом Telegram просто в терміналі. Доступ обмежено через OAuth, без бот-акаунта й без API-ключів.

  1. Керувати Telegram повністю з клавіатури

  2. Оголосити деплой у клієнтському каналі одразу після релізу

  3. Відкрити канал для інциденту й запросити тих, хто реагує

  4. Порахувати відкриті тікети перед релізом

  5. Налаштовуватися глобально або для проєкту через opencode.json

  6. Працювати неінтерактивно для завдань у скриптах

Реліз і повідомлення з однієї оболонки

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

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

Ви питаєте

«Деплой завершився. Опублікуй версію й посилання на changelog у каналі релізів.»

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

entergram_list_accountsentergram_list_groupsentergram_send_message

Ви отримуєте

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

Ви питаєте

«Я вказав у тому оголошенні не той номер збірки. Виправ його на місці.»

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

entergram_list_messagesentergram_get_messageentergram_edit_message

Ви отримуєте

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

Ви питаєте

«Відкрий для цього кімнату інциденту й додай туди всіх, хто чергує.»

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

entergram_create_group_chatentergram_list_membersentergram_invite_chat_members

Ви отримуєте

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

Ви питаєте

«Перешли п'ятничне повідомлення про технічні роботи в усі клієнтські групи, які його ще не бачили.»

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

entergram_list_groupsentergram_list_messagesentergram_forward_messages

Ви отримуєте

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

Ви питаєте

«Цей автор звіту є в деяких наших спільнотах. У яких саме і хто ще з нашого списку там є?»

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

entergram_list_contactsentergram_get_contactentergram_list_contact_shared_groups

Ви отримуєте

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

Ви питаєте

«Перш ніж я зроблю реліз: скільки відкритих тікетів позначено для цього етапу?»

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

entergram_list_ticket_custom_columnsentergram_list_ticketsentergram_get_ticket

Ви отримуєте

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

Історія користувача · Черговий інженер

Спостереження за Telegram після деплою з термінала

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

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

Дві години після деплою сигнали від клієнтів доходять до Slack і Linear

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

Інструкція

Протягом наступних двох годин кожні 10 хвилин перевіряй нові повідомлення в усіх підключених акаунтах Telegram на скарги щодо оплати, входу чи помилок. Зберігай курсор і account_id для кожного джерела. Публікуй у #release-watch у Slack коротке сповіщення з акаунтом, чатом і посиланням на повідомлення. Групуй схожі скарги під однією задачею в Linear і доповнюй її новими доказами замість відкривати дублікати. Додай ID задачі Linear як приватний коментар Entergram у кожен зачеплений чат. Ніколи не надсилай відповідь клієнтові автоматично.

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

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

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

Кожні 10 хвилин протягом обмеженого вікна релізу

  1. Цикл в оболонці або запис cron викликає opencode зі збереженим курсором для кожного акаунта.

  2. Агент порівнює нові скарги з задеплоєною зміною й шукає в Linear перед будь-яким створенням.

  3. Slack одразу бачить сигнал, Linear накопичує докази, а Entergram фіксує передачу інженерам.

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

opencode не стає демоном лише тому, що підключено MCP. За 10-хвилинний ритм і файл стану відповідає оболонка або CI-раннер. Використовуйте блокування, щоб запуски не накладалися, і надавайте області доступу для надсилання й запису лише тим викликам, які потрібні цій процедурі.

Глобально, для проєкту або без інтерфейсу

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

Глобально: ~/.config/opencode/opencode.json

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

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "entergram": {
      "type": "remote",
      "url": "https://mcp.entergram.com/mcp",
      "enabled": true
    }
  }
}

Для проєкту: opencode.json у корені репозиторію

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

Без інтерфейсу: opencode run

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

opencode run "post the release summary for v2.14 in the customer channel"

78 інструментів, нічого не встановлено локально

Сервер розміщує Entergram, тож opencode отримує дев'ять груп інструментів без жодної залежності на вашій машині чи в образі CI: без процесу-мосту, без середовища Python, без облікових даних у репозиторії. Усе нижче доступне щойно з'явився дозвіл, у межах обраного вами рівня доступу, і той самий список доступний як інтерактивній сесії, так і одноразовому запуску.

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

Безпека на боці термінала в одному абзаці

У ваші dotfiles не потрапляє нічого чутливого. opencode.json містить URL і прапорець. Сам обліковий запис доступу після входу в браузері зберігається у власному сховищі автентифікації opencode, а ваша сесія Telegram лишається всередині Entergram, де її не бачать ні SST, ні постачальник моделі. Якщо машина зникла або CI-раннер виводять з експлуатації, відкличте дозвіл в Entergram у Settings → Workspace → Connectors → MCP, і кожна сесія на тій машині втратить доступ під час наступного виклику.

Дізнатися більше
Особистий агент
Типовий варіант для термінала одного розробника, доступний кожному учаснику без кроку погодження. Читання охоплює запис робочого простору, ваші підключені акаунти, контакти, чати, історію повідомлень і чергу тікетів. Запис обмежено власними полями в чатах, що належать вашим акаунтам. Цього досить для сортування, дайджестів і перевірок готовності до релізу, і свідомо недостатньо для будь-чого, що звертається до клієнта.
Конектор робочого простору
Створює власник або адміністратор, і він має всі області доступу, визначені сервером: надсилання, редагування, пересилання, запис тікетів, запис власних полів будь-де в робочому просторі й адміністрування груп. Саме такий рівень потрібен скрипту деплою, якщо він публікуватиме в клієнтському каналі без людини в процесі.
Відкликання
Миттєве й свідомо одностороннє. Щоб відрізати доступ, вам не потрібен доступ до машини, на якій працює opencode. Відкликання в Entergram анулює дозвіл, хоч би де його зберігали, і саме це важливо, коли раннер є CI-машиною, а не ноутбуком на вашому столі.

Обмеження конектора, створеного для термінала

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

Дізнатися більше
  • Перша авторизація потребує браузера. Скрипт не може пройти екран згоди, тож авторизуйтеся один раз в інтерактивній сесії, а збережений дозвіл обслуговуватиме подальші запуски.
  • Закомічений opencode.json поширює адресу, а не доступ. Колеги, які завантажують репозиторій, проходять кожен свій вхід, і їхній токен несе їхні дозволи, а не ваші.
  • На нашому боці немає планувальника. opencode завершує роботу разом із запуском, тож усе регулярне (нічний дайджест, повідомлення після деплою) виконує ваш запис cron або крок пайплайну, а не щось, що Entergram запускає сам.
  • MCP входить у тариф Pro. На нижчих тарифах сервер усе одно відповідає на рукостискання, тому збій схожий на помилку конфігурації, хоча насправді це питання оплати.
  • Для запису колонка має вже існувати. Агент може заповнити поле відстеження релізу в чаті, але створення цього поля належить до дій конектора робочого простору, і з особистим дозволом цього не зробити.
  • Адресація за акаунтом обов'язкова. Термінальні звички чекають розумного значення за замовчуванням, а його немає, тож назвіть акаунт у промпті, інакше агент сам визначить його зі списку акаунтів.

Усунення проблем із конектором opencode

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

opencode запускається, але не показує інструментів Entergram

Перевірте, що запис стоїть у блоці mcp, де type має значення remote, а enabled має значення true. Запис без будь-якого з них розбирається й мовчки пропускається. Конфігурацію читають під час запуску, тож після редагування перезапустіть сесію.

Після редагування opencode відмовляється запускатися

Залиште рядок $schema і перевірте файл JSON-парсером. Зазвичай винна кома в кінці, а помилка запуску здебільшого називає файл, а не проблемний рядок.

Запуск зі скрипту зависає на авторизації

Неінтерактивні запуски не можуть відкрити екран згоди. Один раз запустіть opencode інтерактивно, пройдіть вхід в Entergram, і збережений дозвіл обслуговуватиме запуски зі скриптів надалі.

Діє не та конфігурація

opencode.json проєкту накладається на глобальний файл у ~/.config/opencode/. Якщо колега закомітив запис, використовується саме його. Узгодьте обидва файли замість додавати другий сервер під іншою назвою.

Повідомлення потрапляють не туди

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

Через кілька днів виклики почали падати

Токени спливають. Запустіть opencode інтерактивно й знову підтвердьте доступ. Файл конфігурації не змінюється, змінюється лише дозвіл за ним.

opencode + Telegram: поширені запитання

Як opencode підключається до MCP-серверів?
opencode читає MCP-сервери зі свого файлу конфігурації. Додайте Entergram як віддалений сервер з MCP URL і авторизуйтеся через OAuth.
Це бот Telegram?
Ні. У цьому налаштуванні ніде немає токена бота. Розміщений MCP-сервер діє як ваш власний акаунт Telegram, тому може читати історію, недоступну жодному ботові.
Це безпечно?
Так. OAuth 2.0 з обмеженими дозволами: ви вирішуєте, до чого opencode має доступ, і можете відкликати його будь-коли.
Чи може opencode виконувати багатокрокові дії в Telegram?
Так. Як автономний агент у терміналі, opencode поєднує кроки в одному запуску: читає чати без відповіді, готує чернетки відповідей і відкриває тікети, а перед будь-яким надсиланням чекає вашого погодження.

opencode Telegram MCP - доручіть свої вхідні агентові в терміналі