Slack Notification

Enviar notificações para canais do Slack usando URLs de webhook.

Documentação

🚀 Slack Notification MCP Server

Transforme seus fluxos de trabalho com Claude AI com notificações instantâneas do Slack!

Um poderoso servidor Model Context Protocol (MCP) que conecta perfeitamente o Claude AI ao Slack, permitindo notificações em tempo real para conclusões de tarefas, alertas e automação de fluxos de trabalho. Nunca mais perca atualizações importantes do seu assistente de IA!

✨ Por que este servidor MCP?

🤖 Integração com Claude: Construído especificamente para o Claude AI via Model Context Protocol
⚡ Notificações Instantâneas: Receba atualizações em tempo real quando o Claude concluir tarefas
🎯 Suporte a Múltiplos Canais: Envie mensagens direcionadas para diferentes canais do Slack
🎨 Formatação Rica: Suporte para títulos, cores e estilos de mensagem
🔧 Sem Complicação de Configuração: Configuração JSON simples para você começar em minutos
🚀 Leve: Implementação Node.js rápida com dependências mínimas

🛠️ Recursos

🚀 Criação dinâmica de ferramentas com base nos seus canais do Slack configurados
📱 Suporte para formatação rica de mensagens (títulos, cores)
⚡ Implementação Node.js rápida e leve
🔧 Configuração fácil via arquivo JSON
🎯 Ferramentas separadas para cada canal para controle preciso

🎯 Perfeito Para

Automação de Fluxos de Trabalho com IA: Seja notificado quando o Claude terminar tarefas de longa duração
Equipes de Desenvolvimento: Automatize notificações de deploy e alertas de erro
Análise de Dados: Receba atualizações quando o processamento de dados for concluído
Criação de Conteúdo: Receba alertas quando o Claude terminar tarefas de escrita ou pesquisa
Monitoramento de Sistemas: Envie alertas formatados para atualizações de status do sistema
Gerenciamento de Projetos: Automatize atualizações de status para canais de projetos

🚀 Início 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

📋 Configuração

1. Instalar Dependências

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

2. Criar Webhooks do Slack

Para cada canal do Slack para o qual você deseja enviar notificações:

Acesse seu workspace do Slack
Navegue até Apps > Manage > Custom Integrations > Incoming Webhooks
Ou visite: https://[your-workspace].slack.com/apps/manage/custom-integrations
Clique em Add to Slack
Escolha o canal para o qual deseja enviar notificações
Copie a URL do Webhook

3. Configurar Canais

Crie um arquivo config.json no diretório do projeto:

cp config.example.json config.json

Edite o config.json com suas URLs reais de webhook do 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. Adicionar às Configurações do MCP

Adicione este servidor à configuração do seu cliente MCP (ex.: Claude Desktop):

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

5. Reiniciar o Claude Desktop

Reinicie o aplicativo Claude Desktop para carregar o novo servidor MCP.

Uso

Após a configuração, você terá acesso a ferramentas para cada canal configurado. Por exemplo, se você configurou canais chamados "general", "notifications" e "alerts", verá estas ferramentas:

slack_notify_general
slack_notify_notifications
slack_notify_alerts

Mensagem Básica

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

Mensagem com Título

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

Mensagem Colorida

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

Parâmetros da Ferramenta

Cada ferramenta slack_notify_* aceita estes parâmetros:

message (obrigatório): O conteúdo principal da mensagem
title (opcional): Um título em negrito que aparece antes da mensagem
color (opcional): Cor para a barra lateral da mensagem
- "good" - Verde (sucesso)
- "warning" - Amarelo (aviso)
- "danger" - Vermelho (erro)

Exemplos de Fluxos de Trabalho

Notificações de Conclusão de Tarefas

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 Erro

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"

Atualizações de Status

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

Desenvolvimento

Executando em Modo de Desenvolvimento

npm run dev

Isso iniciará o servidor com monitoramento de arquivos para reinicializações automáticas.

Adicionando Novos Canais

Crie um novo webhook do Slack para o canal
Adicione a configuração do canal ao config.json
Reinicie o servidor MCP
A nova ferramenta slack_notify_[channel_id] estará automaticamente disponível

Testes

Você pode testar o servidor diretamente:

npm start

O servidor será executado e aguardará mensagens do protocolo MCP em stdin/stdout.

Solução de Problemas

Erro "Config file not found"

Certifique-se de ter criado o config.json no diretório do projeto com URLs válidas de webhook do Slack.

Erro "Failed to send Slack message"

Verifique se suas URLs de webhook estão corretas
Verifique se os webhooks do Slack ainda estão ativos
Certifique-se de que os canais ainda existem no seu workspace do Slack

Ferramentas Não Aparecendo no Claude

Verifique o caminho do servidor MCP na sua configuração do Claude
Reinicie o Claude Desktop após fazer alterações de configuração
Verifique se o Node.js está instalado e acessível

Notas de Segurança

Mantenha seu arquivo config.json seguro e não envie URLs de webhook para o controle de versão
As URLs de webhook fornecem acesso direto para publicar nos seus canais do Slack
Considere usar variáveis de ambiente para URLs de webhook em ambientes de produção