1. Acesse a plataforma Slack API;
2. Clique no botão "Get Started";
3. Em seguida, clique em "Go to Your Apps";
4. Clique no botão verde "Create New App";
5. Crie uma nova aplicação "From Scratch" para configuração personalizada;
6. Escolha um nome descritivo (por exemplo, "AI Assistant" ou identificador pessoal);
7. Selecione o workspace Slack desejado no menu suspenso.

• No menu lateral, selecione "OAuth & Permissions";
• Para ativar o botão "Install to Workspace", role até a seção "Scope";
• Na subseção "User Token Scopes", clique em "Add an Oauth Scope";
• Adicione, um a um, os seguintes escopos:
  • channels:history - ler o histórico de mensagens de canais públicos;
  • channels:read - acessar informações básicas dos canais;
  • chat:write - enviar mensagens para canais e usuários;
  • reactions:read - visualizar reações de emoji em mensagens;
  • reactions:write - adicionar reações de emoji em mensagens;
  • users:read - acessar informações básicas do perfil do usuário.
• Role para cima e clique agora no botão "Install to Workspace";
• Em uma nova janela, revise as permissões solicitadas e permita-as clicando em "Allow";
• Agora, você recebeu um OAuth Token que começa com xoxp-. Não feche a janela para uso futuro.

• Abra o workspace Slack desejado em um navegador;
• Ou abra a janela do Slack Desktop;
• Clique no nome do workspace para acessar as configurações;
• Copie a URL do workspace e cole na barra de endereços do navegador ou digite manualmente;
• Localize o Team ID na estrutura da URL (aparece após o prefixo "T");
• Não feche esta aba do navegador também.

• No Claude, digite este prompt:

Clone this MCP server to the Documents/projects folder and run the commands

git clone https://github.com/lars-hagen/slack-user-mcp.git
cd slack-user-mcp
npm install
npm run build

• Execute o prompt.

• No Claude, cole o prompt:

Add this block to the Claude config file
{
  "mcpServers": {
    "slack": {
      "command": "npm",
      "args": [
        "run",
        "--prefix",
        "/path/to/slack-user-mcp",
        "start"
      ],
      "env": {
        "SLACK_TOKEN": "xoxp-your-user-token",
        "SLACK_TEAM_ID": "T01234567"
      }
    }
  }
}

• Adicione dois parâmetros obrigatórios dentro do bloco:
  • Token do Slack (começa com xoxp-) → copie da página da API do Slack;
  • ID da equipe do Slack (começa com T) → copie da URL do workspace.

Ambos os valores são sensíveis. Não compartilhe. O Claude Desktop roda localmente, então é seguro colá-los aqui.

• Execute o prompt.

• Saia completamente do Claude Desktop (macOS: Cmd + Q, Windows: Alt + F4);
• Reabra o Claude.

Alguns avisos podem aparecer — ignore-os. Eles não afetam a funcionalidade.

• Abra o Terminal (Mac) ou Prompt de Comando (Windows);
• Navegue até o diretório onde você armazena os repositórios dos agentes de IA usando o comando cd, por exemplo:

cd Documents/projects

• Baixe o repositório Slack MCP server do GitHub para sua máquina local:

git clone https://github.com/lars-hagen/slack-user-mcp.git

• Entre no diretório recém-criado do repositório:

cd slack-user-mcp

• Instale todas as dependências e pacotes necessários para o Slack MCP server:

npm install

• Compile o projeto e crie os arquivos de build necessários para a execução:

npm run build

• Se ocorrerem problemas na execução dos comandos no Terminal, utilize Command/Ctrl + C para encerrar o processo.

• Acesse a configuração do Claude via Command/Ctrl + ,;
• Abra a aba Developer e selecione "Edit Config";
• Adicione o bloco de configuração do Slack MCP após as entradas existentes;

    "slack": {
      "command": "npm",
      "args": [
        "run",
        "--prefix",
        "/path/to/slack-user-mcp",
        "start"
      ],
      "env": {
        "SLACK_TOKEN": "xoxp-...",
        "SLACK_TEAM_ID": "T..."
      }
    }

• Insira as credenciais necessárias:
  • Caminho do repositório (do comando pwd no Terminal/Prompt de comando);
  • Token OAuth do usuário xoxp-... (da API do Slack);
  • ID da equipe T... (da URL do workspace).
• Salve o arquivo.