por chigwell · chigwell/telegram-mcp
MCP do Telegram para conta pessoal — o Claude lê seus chats, gerencia grupos e envia mensagens via API MTProto oficial.
Usa a API MTProto do Telegram (não a Bot API), então funciona com sua conta pessoal. Útil para fluxos de produtividade pessoal: triagem de chats, resumo de grupos, agendamento de mensagens. Respeite a privacidade — chats são sensíveis.
%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}"
}
}
}
}Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.
{
"mcpServers": {
"telegram-mcp-chigwell": {
"command": "uvx",
"args": [
"telegram-mcp"
],
"env": {
"TG_API_ID": "${TG_API_ID}",
"TG_API_HASH": "${TG_API_HASH}"
}
}
}
}Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.
{
"mcpServers": {
"telegram-mcp-chigwell": {
"command": "uvx",
"args": [
"telegram-mcp"
],
"env": {
"TG_API_ID": "${TG_API_ID}",
"TG_API_HASH": "${TG_API_HASH}"
}
}
}
}Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".
{
"mcpServers": {
"telegram-mcp-chigwell": {
"command": "uvx",
"args": [
"telegram-mcp"
],
"env": {
"TG_API_ID": "${TG_API_ID}",
"TG_API_HASH": "${TG_API_HASH}"
}
}
}
}Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.
{
"mcpServers": [
{
"name": "telegram-mcp-chigwell",
"command": "uvx",
"args": [
"telegram-mcp"
]
}
]
}O Continue usa um array de objetos de servidor em vez de um map.
{
"context_servers": {
"telegram-mcp-chigwell": {
"command": {
"path": "uvx",
"args": [
"telegram-mcp"
]
}
}
}
}Adicione em context_servers. Zed recarrega automaticamente ao salvar.
claude mcp add telegram-mcp-chigwell -- uvx telegram-mcpUma linha só. Verifique com claude mcp list. Remova com claude mcp remove.
Quando usar: Você está sobrecarregado; quer um resumo por chat e sugestões de acompanhamento.
Resultado: Inbox zero no Telegram com respostas sugeridas.
Persista rascunhos antes de enviar
| Ferramenta | Entradas | Quando chamar | Custo |
|---|---|---|---|
| list_chats | (ver docs) | Lista chats com contagens de não lidos | 1 chamada |
| fetch_messages | (ver docs) | Busca mensagens de um chat | 1 chamada |
| send_message | (ver docs) | Envia uma mensagem | 1 chamada |
| search | (ver docs) | Pesquisa em todos os chats | 1 chamada |
user-accountexpose session file; it's as good as your passwordAUTH_KEY_DUPLICATEDColisão de sessão; delete a sessão e reautentique
| Alternativa | Quando usar | Troca |
|---|---|---|
| Bot API integration | Você precisa de um bot, não de uma conta pessoal | Sem acesso a DMs pessoais |