Slack Notification

Envía notificaciones a canales de Slack usando URLs de webhook.

Documentación

🚀 Slack Notification MCP Server

¡Transforma tus flujos de trabajo de Claude AI con notificaciones instantáneas de Slack!

Un potente servidor de Model Context Protocol (MCP) que conecta sin problemas Claude AI con Slack, permitiendo notificaciones en tiempo real para la finalización de tareas, alertas y automatización de flujos de trabajo. ¡Nunca más te pierdas actualizaciones importantes de tu asistente de IA!

✨ ¿Por qué este servidor MCP?

🤖 Integración con Claude: Construido específicamente para Claude AI mediante el Model Context Protocol
⚡ Notificaciones instantáneas: Recibe actualizaciones en tiempo real cuando Claude completa tareas
🎯 Soporte multicanal: Envía mensajes dirigidos a diferentes canales de Slack
🎨 Formato enriquecido: Soporte para títulos, colores y estilos de mensaje
🔧 Sin complicaciones de configuración: Una configuración JSON simple te pone en marcha en minutos
🚀 Ligero: Implementación rápida en Node.js con dependencias mínimas

🛠️ Características

🚀 Creación dinámica de herramientas basada en tus canales de Slack configurados
📱 Soporte para formato de mensajes enriquecidos (títulos, colores)
⚡ Implementación rápida y ligera en Node.js
🔧 Configuración fácil mediante archivo JSON
🎯 Herramientas separadas para cada canal para un control preciso

🎯 Perfecto para

Automatización de flujos de trabajo de IA: Recibe notificaciones cuando Claude termina tareas de larga duración
Equipos de desarrollo: Automatiza notificaciones de despliegue y alertas de errores
Análisis de datos: Recibe actualizaciones cuando se completa el procesamiento de datos
Creación de contenido: Recibe alertas cuando Claude termina tareas de escritura o investigación
Monitoreo de sistemas: Envía alertas formateadas para actualizaciones de estado del sistema
Gestión de proyectos: Automatiza actualizaciones de estado a los canales del proyecto

🚀 Inicio rápido

# 1. Clone and install
git clone https://github.com/Zavdielx89/slack-notification-mcp.git
cd slack-notification-mcp
npm install

# 2. Configure your Slack webhooks
cp config.example.json config.json
# Edit config.json with your webhook URLs

# 3. Add to your Claude Desktop config
# See detailed setup instructions below

📋 Configuración

1. Instalar dependencias

cd ~/code/workflows/Slack-Notification-MCP
npm install

2. Crear webhooks de Slack

Para cada canal de Slack al que quieras enviar notificaciones:

Ve a tu espacio de trabajo de Slack
Navega a Apps > Manage > Custom Integrations > Incoming Webhooks
O visita: https://[your-workspace].slack.com/apps/manage/custom-integrations
Haz clic en Add to Slack
Elige el canal al que quieres enviar notificaciones
Copia la URL del webhook

3. Configurar canales

Crea un archivo config.json en el directorio del proyecto:

cp config.example.json config.json

Edita config.json con tus URL de webhook reales de Slack:

{
  "channels": {
    "general": {
      "name": "General",
      "webhook_url": "https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX"
    },
    "notifications": {
      "name": "Task Notifications",
      "webhook_url": "https://hooks.slack.com/services/T11111111/B11111111/YYYYYYYYYYYYYYYYYYYYYYYY"
    },
    "alerts": {
      "name": "System Alerts",
      "webhook_url": "https://hooks.slack.com/services/T22222222/B22222222/ZZZZZZZZZZZZZZZZZZZZZZZZ"
    }
  }
}

4. Añadir a la configuración de MCP

Añade este servidor a la configuración de tu cliente MCP (por ejemplo, Claude Desktop):

{
  "mcpServers": {
    "slack-notifications": {
      "command": "node",
      "args": ["/Users/zavdielx/code/workflows/Slack-Notification-MCP/index.js"]
    }
  }
}

5. Reiniciar Claude Desktop

Reinicia tu aplicación Claude Desktop para cargar el nuevo servidor MCP.

Uso

Una vez configurado, tendrás acceso a herramientas para cada canal que hayas configurado. Por ejemplo, si configuraste canales llamados "general", "notifications" y "alerts", verás estas herramientas:

slack_notify_general
slack_notify_notifications
slack_notify_alerts

Mensaje básico

Use the slack_notify_notifications tool to send a message "Task completed successfully!"

Mensaje con título

Send a notification to the general channel with title "Build Complete" and message "The deployment finished without errors"

Mensaje con color

Send an alert to the alerts channel with title "Error Detected", message "API endpoint is returning 500 errors", and color "danger"

Parámetros de las herramientas

Cada herramienta slack_notify_* acepta estos parámetros:

message (obligatorio): El contenido principal del mensaje
title (opcional): Un título en negrita que aparece antes del mensaje
color (opcional): Color para la barra lateral del mensaje
- "good" - Verde (éxito)
- "warning" - Amarillo (advertencia)
- "danger" - Rojo (error)

Ejemplos de flujos de trabajo

Notificaciones de finalización de tareas

After completing a long analysis, send a message to notifications channel: "Data analysis complete. Found 15 anomalies in the dataset. Report ready for review."

Alertas de error

If an error occurs, send a danger-colored alert to the alerts channel with title "Processing Error" and message "Failed to process user upload: invalid file format"

Actualizaciones de estado

Send a good-colored message to general channel with title "System Update" and message "All services are running normally after the maintenance window"

Desarrollo

Ejecutar en modo de desarrollo

npm run dev

Esto iniciará el servidor con vigilancia de archivos para reinicios automáticos.

Añadir nuevos canales

Crea un nuevo webhook de Slack para el canal
Añade la configuración del canal a config.json
Reinicia el servidor MCP
La nueva herramienta slack_notify_[channel_id] estará disponible automáticamente

Pruebas

Puedes probar el servidor directamente:

npm start

El servidor se ejecutará y esperará mensajes del protocolo MCP en stdin/stdout.

Solución de problemas

Error "Config file not found"

Asegúrate de haber creado config.json en el directorio del proyecto con URL de webhook de Slack válidas.

Error "Failed to send Slack message"

Verifica que tus URL de webhook sean correctas
Comprueba que los webhooks de Slack sigan activos
Asegúrate de que los canales sigan existiendo en tu espacio de trabajo de Slack

Las herramientas no aparecen en Claude

Verifica la ruta del servidor MCP en tu configuración de Claude
Reinicia Claude Desktop después de realizar cambios de configuración
Comprueba que Node.js esté instalado y sea accesible

Notas de seguridad

Mantén tu archivo config.json seguro y no subas las URL de webhook al control de versiones
Las URL de webhook proporcionan acceso directo para publicar en tus canales de Slack
Considera usar variables de entorno para las URL de webhook en entornos de producción