Telegram

Servidor MCP de Telegram

El servidor es un puente entre la API de Telegram y los asistentes de IA, y se basa en el Model Context Protocol.

[!IMPORTANTE] Asegúrate de haber leído y comprendido los Términos de Servicio de la API de Telegram antes de usar este servidor. Cualquier uso indebido de la API de Telegram puede resultar en la suspensión de tu cuenta.

Tabla de Contenidos

• ¿Qué es MCP?
• ¿Qué hace este servidor?
  • Capacidades
  • Ejemplos de prompts
    • Gestión de Mensajes
    • Organización
    • Comunicación
• Instalación
  • Homebrew
  • NPX
  • Desde Releases
    • MacOS
    • Linux
    • Windows
  • Desde el Código Fuente
• Configuración
  • Autorización
  • Configuración del Cliente
  • Versión del Esquema JSON
• Historial de Estrellas

¿Qué es MCP?

El Model Context Protocol (MCP) es un sistema que permite que aplicaciones de IA, como Claude Desktop o Cursor, se conecten a herramientas externas y fuentes de datos. Proporciona una forma clara y segura para que los asistentes de IA trabajen con servicios locales y APIs, manteniendo al usuario en control.

¿Qué hace este servidor?

Capacidades

• Obtener información de la cuenta actual (tool: tg_me)
• Listar diálogos con filtro opcional de no leídos (tool: tg_dialogs)
• Marcar diálogo como leído (tool: tg_read)
• Recuperar mensajes de un diálogo específico (tool: tg_dialog)
• Enviar mensajes borradores a cualquier diálogo (tool: tg_send)

Ejemplos de prompts

Aquí hay algunos ejemplos de prompts que puedes usar con asistentes de IA:

Gestión de Mensajes

• "Revisa si hay mensajes importantes no leídos en mi Telegram"
• "Resume todos mis mensajes no leídos de Telegram"
• "Lee y analiza mis mensajes no leídos, prepara respuestas borrador donde sea necesario"
• "Revisa mensajes no leídos no críticos y dame un resumen breve"

Organización

• "Analiza mis diálogos de Telegram y sugiere una estructura de carpetas"
• "Ayúdame a categorizar mis chats de Telegram por importancia"
• "Encuentra todas las conversaciones relacionadas con el trabajo y sugiere cómo organizarlas"

Comunicación

• "Monitorea un chat específico para actualizaciones sobre [tema]"
• "Redacta una respuesta cortés al último mensaje en [chat]"
• "Verifica si hay preguntas sin responder en mis chats"

Instalación

Homebrew

Puedes instalar una versión binaria en macOS/Linux usando brew:

# Install
brew install chaindead/tap/telegram-mcp

# Update
brew upgrade chaindead/tap/telegram-mcp

NPX

Puedes ejecutar la última versión directamente usando npx (compatible con macOS, Linux y Windows):

npx -y @chaindead/telegram-mcp

Al usar NPX, modifica los comandos estándar y la configuración de la siguiente manera:

• Comando de autenticación se convierte en:

npx -y @chaindead/telegram-mcp auth ...

• Configuración del servidor MCP de Claude se convierte en:

{
  "mcpServers": {
    "telegram": {
      "command": "npx",
      "args": ["-y", "@chaindead/telegram-mcp"],
      "env": {
        "TG_APP_ID": "<your-api-id>",
        "TG_API_HASH": "<your-api-hash>"
      }
    }
  }
}

Para instrucciones completas de configuración, consulta Autorización y Configuración del Cliente.

Desde Releases

MacOS

# For Intel Mac (x86_64)
curl -L -o telegram-mcp.tar.gz https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Darwin_x86_64.tar.gz

# For Apple Silicon (M1/M2)
curl -L -o telegram-mcp.tar.gz https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Darwin_arm64.tar.gz

# Extract the binary
sudo tar xzf telegram-mcp.tar.gz -C /usr/local/bin

# Make it executable
sudo chmod +x /usr/local/bin/telegram-mcp

# Clean up
rm telegram-mcp.tar.gz

Linux

# For x86_64 (64-bit)
curl -L -o telegram-mcp.tar.gz https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Linux_x86_64.tar.gz

# For ARM64
curl -L -o telegram-mcp.tar.gz https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Linux_arm64.tar.gz

# Extract the binary
sudo tar xzf telegram-mcp.tar.gz -C /usr/local/bin

# Make it executable
sudo chmod +x /usr/local/bin/telegram-mcp

# Clean up
rm telegram-mcp.tar.gz

Windows

Desde el Código Fuente

Requisitos:

• Go 1.24 o posterior
• GOBIN en PATH

go install github.com/chaindead/telegram-mcp@latest

Configuración

Autorización

Antes de poder usar el servidor, necesitas conectarte a la API de Telegram.

1. Obtén el ID de API y el hash desde API de Telegram

2. Ejecuta el siguiente comando:

   Nota: Si tienes 2FA habilitado: agrega --password <2fa_password>

   Nota: Si deseas sobrescribir una sesión existente: agrega --new

   telegram-mcp auth --app-id <your-api-id> --api-hash <your-api-hash> --phone <your-phone-number>
   

   📩 Ingresa el código que recibiste de Telegram para conectarte a la API.

3. ¡Listo! Por favor, dale una ⭐️ a este proyecto para apoyar su desarrollo.

Configuración del Cliente

Ejemplo de configuración de Claude Desktop para reconocer el servidor MCP de Telegram.

1. Abre el archivo de configuración de Claude Desktop:

   • en MacOS, el archivo de configuración se encuentra en ~/Library/Application Support/Claude/claude_desktop_config.json
   • en Windows, el archivo de configuración se encuentra en %APPDATA%\Claude\claude_desktop_config.json

   Nota: También puedes encontrar claude_desktop_config.json dentro de la configuración de la aplicación Claude Desktop

2. Agrega la configuración del servidor

   para Claude desktop:

    {
      "mcpServers": {
        "telegram": {
          "command": "telegram-mcp",
          "env": {
            "TG_APP_ID": "<your-app-id>",
            "TG_API_HASH": "<your-api-hash>",
            "PATH": "<path_to_telegram-mcp_binary_dir>",
            "HOME": "<path_to_your_home_directory"
          }
        }
      }
    }
   

   para Cursor:

   {
     "mcpServers": {
       "telegram-mcp": {
         "command": "telegram-mcp",
         "env": {
           "TG_APP_ID": "<your-app-id>",
           "TG_API_HASH": "<your-api-hash>"
         }
       }
     }
   }
   

Versión del Esquema JSON

Algunos clientes MCP (por ejemplo, VS Code) no admiten JSON Schema Draft 2020-12 y rechazarán las herramientas que lo usen. Puedes sobrescribir la versión del esquema JSON configurando la bandera --schema-version o la variable de entorno TG_SCHEMA_VERSION.

Valores comunes:

Historial de Estrellas