Slack MCP Server
Um servidor MCP (Model Context Protocol) super avançado para integração com Slack, com funcionalidades profissionais para automação, analytics e gerenciamento.
🚀 Funcionalidades
📝 Mensagens & Comunicação
- send_slack_message: Enviar mensagens para canais
- reply_in_thread: Responder em threads específicos
- mention_users: Mencionar usuários específicos
- schedule_slack_message: Agendar mensagens para o futuro
👥 Usuários & Canais (Incluindo Grupos Privados)
- list_slack_channels: Listar canais públicos e grupos privados
- list_slack_users: Listar usuários do workspace
- bulk_invite_users: Convidar múltiplos usuários para canal
- set_user_status: Definir status personalizado
- get_private_channels_with_user: Listar grupos privados específicos
- search_in_private_groups: Buscar especificamente em grupos privados
📊 Analytics & Insights (Funciona com Grupos)
- get_channel_analytics: Analytics detalhados de canais e grupos privados
- search_slack_messages: Buscar mensagens avançada (todos os canais)
- get_slack_channel_history: Histórico completo de qualquer canal ou grupo
🎯 Funcionalidades Avançadas
- create_slack_poll: Criar enquetes interativas com botões
- add_slack_reaction: Adicionar reações emoji
- upload_file_to_slack: Upload de arquivos
- send_webhook_message: Mensagens via webhook
🔧 Automação & Gestão
- archive_old_channels: Arquivar canais inativos automaticamente
- create_slack_reminder: Criar lembretes
- get_workspace_info: Informações do workspace
Configuração
1. Configurar Slack App
-
Acesse https://api.slack.com/apps
-
Crie uma nova app ou use uma existente
-
Vá para "OAuth & Permissions"
-
Adicione TODOS os seguintes Bot Token Scopes:
chat:write - Enviar mensagens chat:write.customize - Personalizar mensagens channels:read - Ler canais públicos groups:read - Ler canais privados users:read - Ler usuários channels:history - Histórico canais públicos groups:history - Histórico canais privados files:write - Upload de arquivos reactions:write - Adicionar reações reminders:write - Criar lembretes search:read - Buscar mensagens team:read - Info do workspace users.profile:write - Alterar status channels:manage - Gerenciar canais groups:write - Gerenciar grupos -
Instale a app no seu workspace
-
Copie o "Bot User OAuth Token"
2. Variáveis de Ambiente
cp .env.example .env
# Edite .env com seu token
SLACK_BOT_TOKEN=xoxb-seu-token-aqui
3. Instalação & Execução
npm install
npm run build
npm start
🎯 Exemplos de Uso Avançados
Criar Enquete Interativa
{
"name": "create_slack_poll",
"arguments": {
"channel": "#geral",
"question": "Qual horário para a reunião?",
"options": ["9h", "10h", "14h", "15h"],
"anonymous": false
}
}
Analytics de Canal
{
"name": "get_channel_analytics",
"arguments": {
"channel": "C1234567890",
"days": 30
}
}
Arquivar Canais Inativos
{
"name": "archive_old_channels",
"arguments": {
"days_inactive": 60,
"dry_run": true
}
}
Convidar Usuários em Massa
{
"name": "bulk_invite_users",
"arguments": {
"channel": "C1234567890",
"users": ["U111", "U222", "U333"]
}
}
Enviar com Menções
{
"name": "mention_users",
"arguments": {
"channel": "#dev",
"text": "Código está pronto para review!",
"users": ["U111", "U222"]
}
}
Upload de Arquivo
{
"name": "upload_file_to_slack",
"arguments": {
"channels": "#anexos",
"file_path": "C:\\docs\\relatorio.pdf",
"title": "Relatório Mensal",
"initial_comment": "Relatório do mês atual"
}
}
🔒 Segurança & Boas Práticas
- ✅ Validação rigorosa com Zod schemas
- ✅ Tratamento robusto de erros
- ✅ Tokens seguros em variáveis de ambiente
- ✅ TypeScript para type safety completo
- ✅ Rate limiting automático do Slack SDK
- ✅ Logs estruturados para debugging
🚀 Debug & Desenvolvimento
- Debug no VS Code: Pressione
F5 - Build:
npm run build - Dev mode:
npm run dev - Logs: Configurados automaticamente
📈 Casos de Uso Profissionais
- Automação de Onboarding: Convites automáticos, canais, mensagens
- Analytics de Equipe: Monitoramento de atividade e engajamento
- Gestão de Canais: Arquivamento automático, limpeza
- Notificações Inteligentes: Webhooks, menções direcionadas
- Enquetes & Feedback: Coleta de opinião da equipe
- Relatórios Automáticos: Upload e compartilhamento
Este MCP Server transforma seu Slack em uma plataforma de automação profissional! 🎯
