Skip to main content
Glama

Личный ассистент в Telegram на Claude

Пишешь боту в Telegram → Claude раз в 15 минут разбирает входящие, отвечает и запоминает.

Ставится из браузера за 30 минут. Терминал, Node и Git не нужны.

Deploy with Vercel


Как это работает

  Telegram  ──POST──▶  /api/telegram   ──▶  Supabase.inbox  (status = new)
                                                   │
                                        каждые 15 мин, по расписанию
                                                   ▼
                                          Claude (Cowork)
                                                   │  через MCP-коннектор
                                                   ▼
                                      /api/mcp/<секрет>  ──▶  Supabase.items
                                                   │              (память)
                                                   ▼
                                        sendMessage ──▶ Telegram

Сервер не думает. Он только принимает сообщения, хранит их и умеет писать в Telegram. Всё мышление — на стороне Claude, по расписанию. Поэтому нет ни одного платного API-ключа модели.


Related MCP server: MTM - MCP Telegram MORE

Что нужно

Сервис

План

Зачем

Telegram

бесплатно

сам бот

Supabase

Free

база: входящие + память

GitHub

Free

копия этого репозитория

Vercel

Hobby

хостинг вебхука и MCP

Claude Pro или Max

платно

Cowork + расписание + коннекторы


Установка

1. Бот в Telegram

Открой @BotFather → /newbot → имя → username (обязан кончаться на bot). Скопируй токен вида 8123456789:AAH... — это TELEGRAM_BOT_TOKEN.

2. База в Supabase

supabase.com → New project (регион — Frankfurt) → придумай пароль, запиши его. Пока проект поднимается (~2 мин), возьми ключи в Project Settings → API:

  • Project URL → это SUPABASE_URL

  • service_role (нажми Reveal) → это SUPABASE_SERVICE_ROLE_KEY

Затем SQL Editor → New query → вставь целиком файл schema.sql → Run.

service_role обходит все ограничения доступа. Он живёт только в переменных Vercel. В браузер, в чат и в скриншоты — никогда.

3. Деплой на Vercel

Нажми кнопку Deploy выше. Vercel попросит:

  1. подключить GitHub (Create Git Repository) — репозиторий скопируется тебе;

  2. заполнить 4 переменные (см. таблицу ниже).

Через ~40 секунд получишь адрес вида https://my-assistant-xxxx.vercel.app.

4. Самонастройка

Открой в браузере:

https://ТВОЙ-АДРЕС.vercel.app/api/setup?secret=ТВОЙ_APP_SECRET

Страница сама проверит ключи, проверит базу, зарегистрирует webhook в Telegram и выдаст готовый MCP-адрес для Claude.

5. Коннектор в Claude

Claude → Settings → Connectors → Add custom connector. Имя: assistant. URL: тот, что выдала страница настройки.

Проверь в чате: «покажи мои новые сообщения» — Claude должен дёрнуть get_new_messages.

6. Расписание

В Cowork напиши /schedule и вставь промт из PROMPTS.md. Раз в 15 минут — */15 * * * *.


Переменные окружения

Переменная

Откуда

TELEGRAM_BOT_TOKEN

@BotFather, шаг 1

APP_SECRET

придумай сам: 20+ случайных символов, латиница и цифры

SUPABASE_URL

Supabase → Project Settings → API → Project URL

SUPABASE_SERVICE_ROLE_KEY

там же → service_role → Reveal

APP_SECRET служит двум целям сразу: им подписан webhook Telegram и им закрыт MCP-эндпоинт. Кто знает секрет — управляет ботом. Меняется в Vercel → Settings → Environment Variables → Redeploy, после чего надо заново открыть /api/setup и обновить URL коннектора.


Что умеет ассистент

Инструменты, которые видит Claude:

Инструмент

Что делает

get_new_messages

забрать необработанные сообщения

mark_message_done

закрыть сообщение (иначе обработает повторно)

send_telegram

написать в Telegram

save_item

сохранить task / reminder / idea / note

list_items

найти в памяти по типу, статусу, подстроке

complete_item

закрыть задачу


Если что-то не работает

Симптом

Причина

/api/setup — красное про Supabase

не прогнал schema.sql, либо неверный URL/ключ

/api/setup — красное про Telegram

опечатка в токене бота

Бот молчит на сообщение

не открыл /api/setup, webhook не зарегистрирован

Claude не видит инструменты

опечатка в MCP-URL; секрет в адресе должен совпадать с APP_SECRET

Claude отвечает дважды

пропущен mark_message_done — поправь промт расписания

Всё умерло через неделю

Supabase Free ставит проект на паузу после 7 дней тишины. Разбуди в дашборде

Диагностический промт — в PROMPTS.md, раздел «Спасатель».


Куда расти

  • Голос. Ловить msg.voice в webhook, гнать file_id в распознавание, класть текст в тот же inbox.

  • Проактивность. Отдельное расписание в 8:00: list_items(kind=reminder, status=open) → сводка дня.

  • Кто угодно не напишет. Проверять msg.from.id против своего Telegram ID в api/telegram.ts.

  • Векторный поиск. pgvector в Supabase поверх items — семантический поиск вместо ilike.

Лицензия

MIT. Форкай, ломай, переделывай под себя.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      A Telegram-integrated MCP server that enables remote control of Claude sessions through a Telegram bot, including chat, tool approvals, task tracking, and workspace management. It provides a MiniApp interface for real-time monitoring and control of Claude's activities from mobile devices.
      4
      -
    • A
      license
      B
      quality
      D
      maintenance
      MCP server that enables Claude Code to interact with a personal Telegram account via MTProto, providing over 120 tools for messaging, media, chat management, and more.
      100
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A read-only Telegram MCP server that retrieves messages from your DMs, groups, and channels, enabling Claude to generate executive briefings from Telegram conversations.
      MIT