/ Каталог / Песочница / Telegram MCP
● Сообщество chigwell 🔑 Нужен свой ключ

Telegram MCP

автор chigwell · chigwell/telegram-mcp

MCP для личного аккаунта Telegram — Claude читает ваши чаты, управляет группами и отправляет сообщения через официальный MTProto API.

Использует MTProto API Telegram (не Bot API), поэтому работает с вашим личным аккаунтом. Подходит для задач личной продуктивности: разбор чатов, сводки по группам, планирование сообщений. Соблюдайте приватность — чаты чувствительны.

Зачем использовать

Ключевые функции

Живое демо

Как выглядит на практике

готово

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "telegram-mcp-chigwell": {
      "command": "uvx",
      "args": [
        "telegram-mcp"
      ],
      "env": {
        "TG_API_ID": "${TG_API_ID}",
        "TG_API_HASH": "${TG_API_HASH}"
      }
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "telegram-mcp-chigwell": {
      "command": "uvx",
      "args": [
        "telegram-mcp"
      ],
      "env": {
        "TG_API_ID": "${TG_API_ID}",
        "TG_API_HASH": "${TG_API_HASH}"
      }
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "telegram-mcp-chigwell": {
      "command": "uvx",
      "args": [
        "telegram-mcp"
      ],
      "env": {
        "TG_API_ID": "${TG_API_ID}",
        "TG_API_HASH": "${TG_API_HASH}"
      }
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "telegram-mcp-chigwell": {
      "command": "uvx",
      "args": [
        "telegram-mcp"
      ],
      "env": {
        "TG_API_ID": "${TG_API_ID}",
        "TG_API_HASH": "${TG_API_HASH}"
      }
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "telegram-mcp-chigwell",
      "command": "uvx",
      "args": [
        "telegram-mcp"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json
{
  "context_servers": {
    "telegram-mcp-chigwell": {
      "command": {
        "path": "uvx",
        "args": [
          "telegram-mcp"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add telegram-mcp-chigwell -- uvx telegram-mcp

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: Telegram MCP

Разобрать чаты Telegram

👤 Разработчики ⏱ ~15 min intermediate

Когда использовать: Вас переполняют сообщения; нужна сводка по каждому чату и предложения по ответам.

Поток
  1. Аутентификация
    При первом запуске запросится SMS-код; сессия сохраняется.✓ Скопировано
    → Файл сессии
  2. Получить сообщения
    list_chats; fetch unread for each.✓ Скопировано
    → Непрочитанные по каждому чату
  3. Сводка
    Claude делает сводку и предлагает ответы.✓ Скопировано
    → Очередь ответов

Итог: Inbox-zero в Telegram с предложенными ответами.

Комбинации

Сочетайте с другими MCP — эффект x10

telegram-mcp-chigwell + filesystem

Сохранить черновики перед отправкой

Combine telegram-mcp-chigwell with filesystem: Persist drafts before sending✓ Скопировано

Инструменты

Что предоставляет этот MCP

ИнструментВходные данныеКогда вызыватьСтоимость
list_chats (см. документацию) Список чатов с числом непрочитанных 1 вызов
fetch_messages (см. документацию) Получить сообщения из чата 1 вызов
send_message (см. документацию) Отправить сообщение 1 вызов
search (см. документацию) Поиск по всем чатам 1 вызов

Стоимость и лимиты

Во что обходится

Квота API
Rate limit'ы Telegram
Токенов на вызов
Истории могут быть большими
Деньги
Бесплатно
Совет
Всегда просматривайте перед отправкой — agent'ы склонны торопиться с операциями в чатах

Безопасность

Права, секреты, радиус поражения

Минимальные скоупы: user-account
Хранение учётных данных: Файл сессии на диске
Исходящий трафик: telegram.org
Никогда не давайте: expose session file; it's as good as your password

Устранение неполадок

Частые ошибки и исправления

AUTH_KEY_DUPLICATED

Коллизия сессии; удалите файл сессии и пройдите повторную аутентификацию

Альтернативы

Telegram MCP в сравнении

АльтернативаКогда использоватьКомпромисс
Интеграция с Bot APIНужен бот, а не личный аккаунтНет доступа к личным DM

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills