# 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
```bash
cp .env.example .env
# Edite .env com seu token
```
```env
SLACK_BOT_TOKEN=xoxb-seu-token-aqui
```
### 3. Instalação & Execução
```bash
npm install
npm run build
npm start
```
## 🎯 Exemplos de Uso Avançados
### Criar Enquete Interativa
```json
{
"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
```json
{
"name": "get_channel_analytics",
"arguments": {
"channel": "C1234567890",
"days": 30
}
}
```
### Arquivar Canais Inativos
```json
{
"name": "archive_old_channels",
"arguments": {
"days_inactive": 60,
"dry_run": true
}
}
```
### Convidar Usuários em Massa
```json
{
"name": "bulk_invite_users",
"arguments": {
"channel": "C1234567890",
"users": ["U111", "U222", "U333"]
}
}
```
### Enviar com Menções
```json
{
"name": "mention_users",
"arguments": {
"channel": "#dev",
"text": "Código está pronto para review!",
"users": ["U111", "U222"]
}
}
```
### Upload de Arquivo
```json
{
"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**! 🎯
