DarkTelegram
Инструменты

Как подключить Claude Code и Codex к Telegram через MCP

Подключите свои Telegram-аккаунты к ИИ-агенту: читайте переписку, готовьте ответы клиентам и управляйте задачами обычным текстом. Ниже — подключение через DarkTelegram и три примера запросов.

Claude Code и Codex подключены к Telegram: серебряный самолёт и две клавиши на лаймовом фоне

Что можно поручить ИИ

MCP — протокол, через который Claude Code или Codex вызывает инструменты DarkTelegram. Агент может работать с подключёнными аккаунтами: читать диалоги, отправлять сообщения, проверять статусы и управлять доступными модулями.

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

Вы описываете задачу словами, агент выбирает инструменты MCP. Для собственных скриптов есть REST API. В Claude Code можно выбрать доступную вам модель Opus.

Как подключить Claude Code

  1. Добавьте свои аккаунты в DarkTelegram. Если делаете это впервые, начните с инструкции по настройке кабинета.
  2. Откройте «Интеграции», создайте API-ключ и сохраните его: полный секрет показывается один раз.
  3. В терминале с установленным Claude Code выполните команду, заменив YOUR_DARKTELEGRAM_API_KEY своим ключом:
claude mcp add --transport http darktelegram https://darktelegram.pro/api/v1/mcp --header "Authorization: Bearer YOUR_DARKTELEGRAM_API_KEY"

Запустите Claude Code из этой папки и откройте /mcp: сервер darktelegram должен подключиться. Синтаксис команды описан в документации Claude Code.

Как подключить Codex

Используйте тот же адрес MCP и свой API-ключ. В терминале с установленным Codex CLI сначала задайте ключ для текущей сессии.

Windows PowerShell:

$env:DARKTELEGRAM_API_KEY = "YOUR_DARKTELEGRAM_API_KEY"

macOS / Linux, bash или zsh:

export DARKTELEGRAM_API_KEY="YOUR_DARKTELEGRAM_API_KEY"

Затем добавьте сервер и запустите Codex из этого же терминала:

codex mcp add darktelegram --url https://darktelegram.pro/api/v1/mcp --bearer-token-env-var DARKTELEGRAM_API_KEY
codex

В новом терминале переменную нужно задать снова. Готовые настройки обоих клиентов также есть в «Интеграциях». Команды с ключом могут сохраниться в истории терминала; храните ключ как пароль.

Как проверить подключение

Попросите агента: «Покажи мои аккаунты через DarkTelegram». Он должен вызвать list_accounts и вернуть список, совпадающий с кабинетом. При ошибке 401 проверьте ключ, при 403 — доступ к API и выбранной функции.

Три задачи для первого запуска

«На аккаунте „Продажи“ найди диалоги за сегодня, где последнее сообщение оставил клиент. Подготовь ответы по приложенному прайсу и покажи их перед отправкой».
«Проверь статусы 20 аккаунтов в папке „Команда“. Составь список тех, которым нужно внимание, и объясни причину».
«Прочитай публикации за неделю в этих трёх каналах. Собери промокоды, условия и сроки действия со ссылками на посты».

Как перейти к постоянной работе

Для регулярных ответов клиентам настройте ИИ-продажника или обеспечьте постоянный запуск своего агента. Подключение MCP само по себе не запускает круглосуточную обработку сообщений.

Перед отправкой проверяйте аккаунт, получателя и текст. У отправки сообщений через MCP есть режим предпросмотра (dry_run=true); выполнение требует dry_run=false. Число аккаунтов и доступные действия зависят от тарифа, состояния сессий и ограничений Telegram.