/ Directorio / Playground / Telegram MCP
● Comunidad chigwell 🔑 Requiere tu clave

Telegram MCP

por chigwell · chigwell/telegram-mcp

MCP de Telegram para cuenta personal — Claude lee tus chats, gestiona grupos y envía mensajes vía la API oficial MTProto.

Usa la API MTProto de Telegram (no la Bot API) por lo que funciona con tu cuenta personal. Útil para flujos de productividad personal: clasificar chats, resumir grupos, programar mensajes. Respeta la privacidad — los chats son datos sensibles.

Por qué usarlo

Características clave

Demo en vivo

Cómo se ve en la práctica

listo

Instalar

Elige tu cliente

~/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}"
      }
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.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 usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

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}"
      }
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "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}"
      }
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

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

Continue usa un array de objetos de servidor en lugar de un mapa.

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

Añádelo a context_servers. Zed recarga en caliente al guardar.

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

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: Telegram MCP

Clasificar tus chats de Telegram

👤 Desarrolladores ⏱ ~15 min intermediate

Cuándo usarlo: Estás desbordado; quieres un resumen por chat y sugerencias de seguimiento.

Flujo
  1. Autenticar
    First run prompts for SMS code; session saved.✓ Copiado
    → Archivo de sesión
  2. Obtener
    list_chats; fetch unread for each.✓ Copiado
    → No leídos por chat
  3. Resumir
    Claude summarizes and suggests replies.✓ Copiado
    → Cola de respuestas

Resultado: Inbox-zero en Telegram con respuestas propuestas.

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

telegram-mcp-chigwell + filesystem

Persistir borradores antes de enviar

Combine telegram-mcp-chigwell with filesystem: Persist drafts before sending✓ Copiado

Herramientas

Lo que expone este MCP

HerramientaEntradasCuándo llamarCoste
list_chats (see docs) Listar chats con recuentos de no leídos 1 call
fetch_messages (see docs) Obtener mensajes de un chat 1 call
send_message (see docs) Enviar un mensaje 1 call
search (see docs) Buscar en chats 1 call

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API
Límites de tasa de Telegram
Tokens por llamada
Los historiales pueden ser grandes
Monetario
Gratuito
Consejo
Siempre previsualiza antes de enviar; los agentes son impacientes en operaciones de chat

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: user-account
Almacenamiento de credenciales: Archivo de sesión en disco
Salida de datos: telegram.org
No conceder nunca: expose session file; it's as good as your password

Resolución de problemas

Errores comunes y soluciones

AUTH_KEY_DUPLICATED

Colisión de sesión; elimina la sesión y re-autentica

Alternativas

Telegram MCP vs otros

AlternativaCuándo usarlaContrapartida
Bot API integrationNecesitas un bot, no una cuenta personalSin acceso a DMs personales

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills