Claude Channels con Telegram y Discord: Guía de Configuración Completa 2026
Claude Channels: de la teoría a la práctica
Si eres de los que leyó nuestro artículo sobre Claude Channels y Remote Tasks y pensó "esto suena increíble pero ¿cómo se configura exactamente?", este artículo es para ti.
Aquí no hay teoría: es la guía práctica de configuración de Claude Channels con Telegram y Discord, con todos los pasos, los errores más comunes y las mejores prácticas de seguridad.
Antes de empezar: lo que necesitas
- Claude Code v2.1.80 o superior (verifica con
claude --version) - Una cuenta activa en claude.ai (Pro, Team o Enterprise — las API keys solas no funcionan)
- Una cuenta de Telegram o un servidor de Discord donde tengas permisos de administración
- Si usas cuenta Team o Enterprise: que el administrador habilite Channels desde el panel de admin
El error que comete todo el mundo (léelo antes)
Antes de entrar en los pasos, hay un error que comete el 90% de las personas que intentan configurar Channels por primera vez:
Instalar el plugin en .mcp.json NO activa los Channels.
El plugin MCP se conecta y sus herramientas funcionan, pero los mensajes del canal no llegan a tu sesión si no lanzas Claude Code con el flag correcto. Te explicamos cuál es en cada sección.
Opción A: Configurar Claude Channels con Telegram
Paso 1: Crea tu bot en BotFather
Abre Telegram y busca @BotFather. Envía el comando:
/newbot
Sigue el flujo: elige un nombre para el bot y un username (debe acabar en bot). BotFather te dará un token de API con este formato:
1234567890:AAFxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Guárdalo. Lo necesitarás en el siguiente paso.
Paso 2: Instala el plugin oficial de Telegram
Añade la configuración del servidor MCP a tu archivo .mcp.json en la raíz del proyecto (o en ~/.claude/mcp.json para uso global):
{
"mcpServers": {
"telegram": {
"command": "npx",
"args": ["-y", "@claude-plugins/telegram"],
"env": {
"TELEGRAM_BOT_TOKEN": "TU_TOKEN_AQUI",
"TELEGRAM_ALLOWED_USERS": "TU_USER_ID_DE_TELEGRAM"
}
}
}
}
Para obtener tu TELEGRAM_USER_ID, envía un mensaje a @userinfobot en Telegram. Te responderá con tu ID numérico.
Paso 3: Lanza Claude Code con el flag --channels
Este es el paso que muchos se saltan. Debes lanzar Claude Code explícitamente con:
claude --channels plugin:telegram@claude-plugins-official
Sin este flag, el servidor MCP se inicializa y sus herramientas están disponibles, pero Claude no escuchará los mensajes entrantes del canal.
Paso 4: Prueba la conexión
Envía un mensaje a tu bot desde Telegram. Claude debería responder. Si no responde, verifica:
- Que el token del bot sea correcto
- Que tu User ID esté en
TELEGRAM_ALLOWED_USERS - Que hayas lanzado con
--channelsy no solo iniciado Claude Code normalmente
Opción B: Configurar Claude Channels con Discord
Discord usa WebSocket en lugar de polling, lo que le da una latencia más baja.
Paso 1: Crea una aplicación en Discord Developer Portal
Ve a discord.com/developers/applications → crea una nueva aplicación → ve a la sección Bot → activa el bot → copia el Bot Token.
En Privileged Gateway Intents, activa:
- Message Content Intent
- Server Members Intent (opcional)
Paso 2: Invita el bot a tu servidor
En OAuth2 → URL Generator, selecciona los scopes bot y applications.commands, con permisos Send Messages y Read Message History. Usa la URL generada para invitar el bot a tu servidor.
Paso 3: Configura el plugin en .mcp.json
{
"mcpServers": {
"discord": {
"command": "npx",
"args": ["-y", "@claude-plugins/discord"],
"env": {
"DISCORD_BOT_TOKEN": "TU_TOKEN_AQUI",
"DISCORD_CHANNEL_ID": "ID_DEL_CANAL",
"DISCORD_ALLOWED_USER_IDS": "TU_USER_ID_DISCORD"
}
}
}
}
Para el DISCORD_CHANNEL_ID: activa el modo desarrollador en Discord (Configuración → Avanzado → Modo desarrollador) y haz clic derecho en el canal → Copiar ID.
Paso 4: Lanza con el flag --channels
claude --channels plugin:discord@claude-plugins-official
Opción C: Fakechat (perfecto para probar sin configurar nada)
Anthropic incluye un canal de demostración que abre una interfaz de chat en localhost sin necesidad de configurar ningún servicio externo:
claude --channels plugin:fakechat@claude-plugins-official
Se abre una URL en tu navegador. Perfecta para entender cómo funciona el sistema antes de conectar Telegram o Discord.
Automatización avanzada: webhooks externos
Una vez configurado el canal, puedes hacer que cualquier herramienta externa dispare eventos en tu sesión de Claude. Ejemplos reales:
GitHub Actions → notifica fallo de build:
- name: Notify Claude on failure
if: failure()
run: |
curl -X POST "${{ secrets.CLAUDE_WEBHOOK_URL }}" \
-d '{"event": "build_failed", "branch": "${{ github.ref_name }}"}'
Alertas de monitorización: Configura Datadog, Grafana o cualquier sistema de alertas para enviar webhooks a tu canal. Claude recibirá la alerta y puede analizarla automáticamente.
Gestión de permisos: el punto más importante de seguridad
Cuando Claude está escuchando mensajes de un canal externo y tú no estás presente, hay acciones que pueden requerir aprobación (escribir archivos, ejecutar comandos). Por defecto, Claude se detiene y espera sin notificarte.
Tienes dos opciones para gestionar esto:
Opción 1 (recomendada): Pre-configura qué acciones puede realizar Claude sin preguntarte usando el archivo de configuración de permisos de Claude Code.
Opción 2 (para entornos de confianza): Usa --dangerously-skip-permissions solo si confías plenamente en el tipo de tareas que estás automatizando y en quién tiene acceso al canal.
Nunca compartas el token de tu bot públicamente ni en repos de código.
¿Necesitas que alguien te lo configure y lo integre en tu flujo de trabajo?
Configurar Claude Channels puede parecer sencillo en un tutorial, pero adaptarlo a un entorno de equipo real —con múltiples usuarios, políticas de permisos, integración con CI/CD y herramientas existentes— es otra historia.
Eso es lo que hago: integro agentes de IA en flujos de trabajo reales, con configuraciones seguras y escalables.
Si quieres que hablemos de cómo Claude Channels puede encajar en tu equipo o proyecto, escríbeme por WhatsApp. Sin compromiso y sin coste.