Получите код Клода в своем местном проекте, разговаривая с Telegram за 3 минуты!

TSGram MCP подключает сеансы кода Claude к Telegram с использованием TS/Node/Docker/cli-utils, обеспечивая поддержку кода на основе AI непосредственно в ваших Telegram-чатах. Задавайте вопросы о своей кодовой базе, получайте информацию об ИИ и даже редактируйте файлы - все из Telegram на вашем телефоне!

Как это работает (All Local)

• Локальный контейнер Docker запускает сервер Telegram webhook Сервер TSGram MCP работает локально Ваш Claude Code или Claude Desktop работает локально и добавляет MCP локально. Создание и удаление ботов в приложении через Telegram, доступ ограничен к вашему идентификатору пользователя телеграммы Современная локальная веб-панель для управления ботами от localhost
• Местный означает местный! Если ваш компьютер отключен, то и ваши боты тоже.

Быстрый старт (3 минуты)

Настройка AI Agent Enhanced Setup (рекомендуется!)

Пусть Клод справится со всей настройкой и спросит вас о необходимых значениях.

** Из вашего терминала: ** Установите Docker Desktop и Node.js 20+ (включая npm)

1. Клонировать хранилище:

2. Из командной строки начните Клод:

3. Инициировать с /init

4. Копировать и вставлять эту подсказку:

TSGram MCP 🚀

Get Claude Code in your local project talking to Telegram in 3 minutes!

TSGram MCP connects Claude Code sessions to Telegram using TS/Node/Docker/cli-utils, enabling AI-powered code assistance directly in your Telegram chats. Ask questions about your codebase, get AI insights, and even edit files - all from Telegram on your phone!

🔒 How It Works (All Local)

• Local Docker container runs the Telegram webhook server
• TSGram MCP server runs locally
• Your Claude Code or Claude Desktop runs locally and adds MCP locally
• Create and delete bots in-app through Telegram, access limited to your telegram user id
• Modern local web dashboard to manage bots from localhost
• Local means local! If your computer is offline, so are your bots.

Quick Start (3 Minutes)

🤖 AI Agent Enhanced Setup (Recommended!)

Let Claude handle the entire setup and ask you for the required values.

From your terminal: 0. Install Docker Desktop and Node.js 20+ (npm included)

1. Clone the repository:

   git clone https://github.com/areweai/tsgram-mcp.git
   cd tsgram-mcp
   

2. From the command line, start Claude:

   claude --model sonnet
   

3. Initialize with /init

4. Copy and paste this prompt:

   First, explain to the human how to register a new Telegram bot with @BotFather and get their bot token (TELEGRAM_BOT_TOKEN), and how to get their Telegram user ID from @userinfobot (for AUTHORIZED_CHAT_ID). They can work on getting these credentials while you set up the system. Then help the user set up tsgram-mcp for claude code. Do everything from installing node modules to creating and deploying the local docker containers. Finally, when everything is deployed, remind the user to configure their bot token and authorized chat ID along wither other required .env variables.

Make sure you replace the TELEGRAM_BOT_TOKEN and AUTHORIZED_CHAT_ID placeholders with the actual values.

In order to retrieve those values, you will have to message the following Telegram bots and follow their instructions:

• @BotFather
• @userinfobot

The AI will then handle all the setup steps for you, including:

• Installing dependencies
• Configuring environment variables
• Building Docker containers
• Starting services
• Guiding you through bot registration
• Setting up the MCP server (and allow you to extend functionality locally)

CLI no-AI Alternative If Hitting LLM troubles: Setup Shell Script Run from your project root:

# One-line install (macOS/Linux)
curl -sSL https://raw.githubusercontent.com/areweai/tsgram-mcp/main/setup.sh | bash

# Or if you prefer to review first:
curl -sSL https://raw.githubusercontent.com/areweai/tsgram-mcp/main/setup.sh > setup.sh
chmod +x setup.sh