Servidor MCP de Telegram

Este es un servidor MCP simple que le permite a Claude acceder a su cuenta de Telegram para leer y enviar mensajes.

Funciones

get_chats : Obtén una lista de tus chats de Telegram
send_message : Envía un mensaje a un chat
get_message : obtiene mensajes de un chat e imprime los mensajes no leídos
mark_messages_read : Marcar mensajes como leídos
get_conversation_context : supera los 20 mensajes y lee convostyle.txt para determinar una respuesta apropiada

Configuración

Configuración recomendada

Paso 1: Obtén tus credenciales de API de Telegram

Vaya a https://my.telegram.org/apps
Inicie sesión y cree una aplicación (o utilice una existente) Nota: No importa qué tipo de aplicación sea, simplemente cree cualquier cosa... asegúrese de seleccionar "web" en el tipo.
Anote su ID de API y su hash de API

Paso 2: Configurar el entorno de Python

Instala los paquetes necesarios (abre tu terminal para hacerlo. Comando+Espacio en Mac e ingresa "terminal" o en Windows presiona la tecla de Windows e ingresa "terminal". Copia y pega el código en la terminal línea por línea). Asegúrate de haber instalado Git de antemano.

# Clone the repository within your desired directory (if you haven't already)
git clone https://github.com/alexandertsai/mcp-telegram
cd mcp-telegram

Configura el entorno virtual. Usa pip3 si corresponde.

# Set up virtual environment
pip install uv
uv venv
source .venv/bin/activate
# .venv\Scripts\activate for windows
uv add mcp-sdk telethon python-dotenv nest_asyncio

Paso 3: Agregar identificaciones

Para Mac (bash):

En el entorno virtual, ejecute lo siguiente:

export TELEGRAM_PHONE=phone number with country code and no spaces
export TELEGRAM_API_ID=api_id
export TELEGRAM_API_HASH=api_hash

Verifique si se han exportado con printenv en la terminal.

Para Windows (PowerShell):

En el entorno virtual, ejecute lo siguiente. Asegúrese de incluir las comillas; de lo contrario, PowerShell podría tener problemas:

$env:TELEGRAM_PHONE="phone number with country code and no spaces"
$env:TELEGRAM_API_ID="api_id"
$env:TELEGRAM_API_HASH="api_hash"

Verifique si se han exportado con gci env: en powershell.

Paso 4: Ejecutar la autenticación

Ejecuta esto para autenticarte. Si tienes autenticación de dos factores (A2F), al escribir tu contraseña no verás ningún texto en la terminal. ¡Es normal! Intenta no cometer errores tipográficos durante la A2F; si lo haces, tendrás que reiniciar todo el proceso. Usa python o python3 según lo que tengas instalado.

cd src/mcp_telegram
python3 telethon_auth.py

Se le solicitará:

Tu número de teléfono (en formato internacional con +) (no dejes espacios)
El código que Telegram envía a tu cuenta
Su contraseña 2FA (si está habilitada)

Esto crea un archivo de sesión en su directorio de inicio para que no necesite autenticarse nuevamente.

Paso 5: Agregar a Claude Desktop

Edite la configuración de Claude Desktop:

Abra el escritorio de Claude, vaya a Configuración (cmd+,), haga clic en Desarrollador y luego en Editar configuración. Edite el archivo claude)desktop_config.json. Asegúrese de que el modo de desarrollador esté habilitado.

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
Ventanas : %APPDATA%\Claude\claude_desktop_config.json

Añade esto a tu configuración (reemplázalo con tus credenciales). Presiona Comando+S para guardar.

"mcpServers": {
      "telegram": {
      "command": "/your/path/to/python3",
      "args": ["/full/path/to/mcp-telegram/main.py"],
      "env": {
          "TELEGRAM_API_ID": "your_api_id_here",
          "TELEGRAM_API_HASH": "your_api_hash_here",
          "TELEGRAM_PHONE": "+65945678900"
          }
      }
  }

main.py: para obtener la ruta completa, vaya a su IDE o escritorio, busque el archivo, haga clic derecho sobre él y haga clic en "COPIAR RUTA".

Python: Ejecute where.exe python (Windows) o where python (Mac) en su terminal para obtener la ruta completa (reemplace con python3 si es necesario). En Windows, podría necesitar reemplazar las barras invertidas en su ruta con barras diagonales debido al formato JSON (Ctrl+f "\", reemplazar todo (Ctrl+h) con "/").

MUY IMPORTANTE:

Utilice la ruta absoluta completa tanto a Python como al script main.py
Reemplace las credenciales de API con sus valores reales del Paso 1
Establezca su número de teléfono en formato internacional

Paso 6 (opcional):

Siéntete libre de configurar convostyle.txt en src/mcp_telegram si quieres que el chatbot responda y suene como tú.

¡Eso es todo!

Reinicie Claude Desktop (salga y vuelva a abrir) y ahora podrá pedirle a Claude que:

Muestra tus chats recientes de Telegram
Leer mensajes de chats específicos
Marcar ciertos mensajes como "leídos"
Envía mensajes a tus contactos o grupos sonando natural

Asegúrate de incluir la palabra "Telegram" al pedirle a Claude una instrucción; de lo contrario, podría no entenderla. Por ejemplo: "Claude, ¿tengo algún mensaje de Telegram sin leer?"

Personalización

Puedes ir a Claude Desktop -> hacer clic en tu usuario y luego en configuración en la esquina inferior izquierda -> configurar tus preferencias para obtener respuestas más personalizadas. Por ejemplo, "Al usar MCP para consultar Telegram, ignorar canales".

Solución de problemas molestos

Mientras esté en el entorno virtual, intente ejecutar:

ls -la ~/.mcp_telegram_*

Luego finalice sus archivos de sesión con (simplemente copie y pegue la ruta de los archivos con rm al frente)

rm /Users/username/.mcp_telegram_numberininternationalformat*

Intente el paso 3 nuevamente.

Telegram MCP Server

Integrations