1. Accedere alla piattaforma Slack API;
2. Fare clic sul pulsante "Get Started";
3. Quindi fare clic su "Go to Your Apps";
4. Fare clic sul pulsante verde "Create New App";
5. Creare una nuova applicazione "From Scratch" per una configurazione personalizzata;
6. Scegliere un nome descrittivo (ad esempio, "AI Assistant" o un identificativo personale);
7. Selezionare lo workspace Slack di destinazione dal menu a tendina.

• Nel menu laterale, selezionare "OAuth & Permissions";
• Per attivare il pulsante "Install to Workspace", scorrere fino alla sezione "Scope";
• Nella sottosezione "User Token Scopes", fare clic su "Add an Oauth Scope";
• Aggiungere uno alla volta i seguenti scope:
  • channels:history - lettura della cronologia dei messaggi dai canali pubblici;
  • channels:read - accesso alle informazioni di base dei canali;
  • chat:write - invio di messaggi a canali e utenti;
  • reactions:read - visualizzazione delle reazioni emoji ai messaggi;
  • reactions:write - aggiunta di reazioni emoji ai messaggi;
  • users:read - accesso alle informazioni di base dei profili utente.
• Scorrere verso l'alto e ora fare clic sul pulsante "Install to Workspace";
• In una nuova finestra, prendere visione delle autorizzazioni richieste e consentirle facendo clic su "Allow";
• Ora si riceverà un OAuth Token che inizia con xoxp-. Non chiudere la finestra per utilizzi futuri.

• Aprire lo workspace Slack di destinazione in un browser;
• Oppure aprire la finestra Desktop di Slack;
• Fare clic sul nome dello workspace per accedere alle impostazioni;
• Copiare l'URL dello workspace e incollarlo nella barra degli indirizzi del browser o scriverlo manualmente;
• Individuare il Team ID nella struttura dell'URL (compare dopo il prefisso "T");
• Anche questa scheda del browser non deve essere chiusa.

• In Claude, digita questo 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

• Esegui il prompt.

• In Claude, incolla il 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"
      }
    }
  }
}

• Aggiungi due parametri obbligatori all'interno del blocco:
  • Slack token (inizia con xoxp-) → copialo dalla pagina API di Slack;
  • Slack team ID (inizia con T) → copialo dall'URL dello workspace.

Entrambi i valori sono sensibili. Non condividerli. Claude Desktop viene eseguito localmente, quindi è sicuro incollarli qui.

• Esegui il prompt.

• Chiudi completamente Claude Desktop (macOS: Cmd + Q, Windows: Alt + F4);
• Riapri Claude.

Potrebbero comparire alcuni avvisi — ignorali. Non influenzano la funzionalità.

• Apri il Terminale (Mac) o la Command Line (Windows);
• Naviga nella directory dove conservi i repository degli agenti AI tramite il comando cd, ad esempio:

cd Documents/projects

• Scarica il repository Slack MCP server da GitHub sulla tua macchina locale:

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

• Entra nella directory del repository appena creato:

cd slack-user-mcp

• Installa tutte le dipendenze e i pacchetti necessari per il server Slack MCP:

npm install

• Compila il progetto e crea i file di build necessari per l'esecuzione:

npm run build

• Se riscontri problemi nell'esecuzione dei comandi nel Terminale, utilizza Command/Ctrl + C per terminare il processo.

• Accedi alla configurazione di Claude tramite Command/Ctrl + ,;
• Apri la scheda Developer e seleziona "Edit Config";
• Aggiungi il blocco di configurazione Slack MCP dopo le voci esistenti;

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

• Inserisci le credenziali richieste:
  • Percorso del repository (dal comando pwd nel Terminale/Command line);
  • User OAuth Token xoxp-... (dall'API di Slack);
  • Team ID T... (dall'URL dello workspace).
• Salva il file.