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

1. Acesse https://api.slack.com/apps

2. Crie uma nova app ou use uma existente

3. Vá para "OAuth & Permissions"

4. 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
   

5. Instale a app no seu workspace

6. 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

1. Automação de Onboarding: Convites automáticos, canais, mensagens
2. Analytics de Equipe: Monitoramento de atividade e engajamento
3. Gestão de Canais: Arquivamento automático, limpeza
4. Notificações Inteligentes: Webhooks, menções direcionadas
5. Enquetes & Feedback: Coleta de opinião da equipe
6. Relatórios Automáticos: Upload e compartilhamento

Este MCP Server transforma seu Slack em uma plataforma de automação profissional! 🎯