/ Annuaire / Playground / Telegram MCP
● Communauté chigwell 🔑 Nécessite votre clé

Telegram MCP

par chigwell · chigwell/telegram-mcp

MCP Telegram pour compte personnel — Claude lit vos chats, gère des groupes et envoie des messages via l'API MTProto officielle.

Utilise l'API MTProto de Telegram (pas l'API Bot) pour fonctionner avec votre compte personnel. Utile pour les flux de productivité personnelle : trier les chats, résumer les groupes, planifier des messages. Respectez la vie privée — les chats sont sensibles.

Pourquoi l'utiliser

Fonctionnalités clés

Démo en direct

Aperçu en pratique

prêt

Installer

Choisissez votre client

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

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

~/.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 utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

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

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "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}"
      }
    }
  }
}

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

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

Continue utilise un tableau d'objets serveur plutôt qu'une map.

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

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

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

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : Telegram MCP

Trier vos chats Telegram

👤 Développeurs ⏱ ~15 min intermediate

Quand l'utiliser : Vous êtes submergé ; vous souhaitez un résumé par chat et des suggestions de suivi.

Déroulement
  1. S'authentifier
    Le premier lancement demande le code SMS ; la session est sauvegardée.✓ Copié
    → Fichier de session
  2. Récupérer
    list_chats ; récupérez les non-lus pour chacun.✓ Copié
    → Non-lus par chat
  3. Résumer
    Claude résume et suggère des réponses.✓ Copié
    → File de réponses

Résultat : Inbox-zero sur Telegram avec des réponses proposées.

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

telegram-mcp-chigwell + filesystem

Persister les brouillons avant envoi

Combiner telegram-mcp-chigwell avec filesystem : persister les brouillons avant envoi✓ Copié

Outils

Ce que ce MCP expose

OutilEntréesQuand appelerCoût
list_chats (voir la documentation) Lister les chats avec les compteurs de non-lus 1 appel
fetch_messages (voir la documentation) Récupérer les messages d'un chat 1 appel
send_message (voir la documentation) Envoyer un message 1 appel
search (voir la documentation) Rechercher dans les chats 1 appel

Coût et limites

Coût d'exécution

Quota d'API
Limites de rate Telegram
Tokens par appel
Les historiques peuvent être volumineux
Monétaire
Gratuit
Astuce
Prévisualisez toujours avant d'envoyer ; les agents sont trop prompts sur les opérations de chat

Sécurité

Permissions, secrets, portée

Portées minimales : user-account
Stockage des identifiants : Fichier de session sur disque
Sortie de données : telegram.org
Ne jamais accorder : expose session file; it's as good as your password

Dépannage

Erreurs courantes et correctifs

AUTH_KEY_DUPLICATED

Collision de session ; supprimez la session et ré-authentifiez-vous

Alternatives

Telegram MCP vs autres

AlternativeQuand l'utiliserCompromis
Intégration API BotVous avez besoin d'un bot, pas d'un compte personnelPas d'accès aux DMs personnels

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills