Slack MCP-Server

MCP-Server für die Slack-API, der Claude die Interaktion mit Slack-Arbeitsbereichen ermöglicht.

Werkzeuge

1. slack_list_channels

   • Öffentliche oder vordefinierte Kanäle im Arbeitsbereich auflisten

   • Optionale Eingaben:

     • limit (Zahl, Standard: 100, Max: 200): Maximale Anzahl der zurückzugebenden Kanäle

     • cursor (Zeichenfolge): Seitennummerierungscursor für die nächste Seite

   • Gibt zurück: Liste der Kanäle mit ihren IDs und Informationen

2. slack_post_message

   • Eine neue Nachricht in einem Slack-Kanal posten

   • Erforderliche Eingaben:

     • channel_id (Zeichenfolge): Die ID des Kanals, in dem gepostet werden soll

     • text (Zeichenfolge): Der zu postende Nachrichtentext

   • Rückgabe: Bestätigung der Nachrichtenübermittlung und Zeitstempel

3. slack_reply_to_thread

   • Auf einen bestimmten Nachrichten-Thread antworten

   • Erforderliche Eingaben:

     • channel_id (Zeichenfolge): Der Kanal, der den Thread enthält

     • thread_ts (Zeichenfolge): Zeitstempel der übergeordneten Nachricht

     • text (Zeichenfolge): Der Antworttext

   • Rückgabe: Antwortbestätigung und Zeitstempel

4. slack_add_reaction

   • Fügen Sie einer Nachricht eine Emoji-Reaktion hinzu

   • Erforderliche Eingaben:

     • channel_id (Zeichenfolge): Der Kanal, der die Nachricht enthält

     • timestamp (Zeichenfolge): Zeitstempel der Nachricht, auf die reagiert werden soll

     • reaction (Zeichenfolge): Emoji-Name ohne Doppelpunkte

   • Rücksendungen: Reaktionsbestätigung

5. slack_get_channel_history

   • Aktuelle Nachrichten aus einem Kanal abrufen

   • Erforderliche Eingaben:

     • channel_id (Zeichenfolge): Die Kanal-ID

   • Optionale Eingaben:

     • limit (Zahl, Standard: 10): Anzahl der abzurufenden Nachrichten

   • Gibt zurück: Liste der Nachrichten mit ihrem Inhalt und Metadaten

6. slack_get_thread_replies

   • Alle Antworten in einem Nachrichtenthread abrufen

   • Erforderliche Eingaben:

     • channel_id (Zeichenfolge): Der Kanal, der den Thread enthält

     • thread_ts (Zeichenfolge): Zeitstempel der übergeordneten Nachricht

   • Gibt zurück: Liste der Antworten mit Inhalt und Metadaten

7. slack_get_users

   • Liste der Arbeitsbereichsbenutzer mit grundlegenden Profilinformationen abrufen

   • Optionale Eingaben:

     • cursor (Zeichenfolge): Seitennummerierungscursor für die nächste Seite

     • limit (Zahl, Standard: 100, Max: 200): Maximale Anzahl der zurückzugebenden Benutzer

   • Rückgabe: Liste der Benutzer mit ihren Basisprofilen

8. slack_get_user_profile

   • Erhalten Sie detaillierte Profilinformationen für einen bestimmten Benutzer

   • Erforderliche Eingaben:

     • user_id (Zeichenfolge): Die ID des Benutzers

   • Rückgabe: Detaillierte Benutzerprofilinformationen

Related MCP server: Slack Search MCP Server

Aufstellen

1. Erstellen Sie eine Slack-App:

   • Besuchen Sie die Slack Apps-Seite

   • Klicken Sie auf „Neue App erstellen“

   • Wählen Sie „Von Grund auf neu“

   • Benennen Sie Ihre App und wählen Sie Ihren Arbeitsbereich aus

2. Konfigurieren Sie Bot-Token-Bereiche: Navigieren Sie zu „OAuth & Berechtigungen“ und fügen Sie diese Bereiche hinzu:

   • channels:history – Nachrichten und andere Inhalte in öffentlichen Kanälen anzeigen

   • channels:read – Grundlegende Kanalinformationen anzeigen

   • chat:write - Nachrichten als App senden

   • reactions:write - Emoji-Reaktionen zu Nachrichten hinzufügen

   • users:read - Benutzer und ihre grundlegenden Informationen anzeigen

   • users.profile:read – Detaillierte Profile über Benutzer anzeigen

3. App im Arbeitsbereich installieren:

   • Klicken Sie auf „Im Workspace installieren“ und autorisieren Sie die App

   • Speichern Sie das „Bot User OAuth Token“, das mit xoxb- beginnt.

4. Holen Sie sich Ihre Team-ID (beginnt mit einem T ), indem Sie dieser Anleitung folgen

Verwendung mit Claude Desktop

Fügen Sie Ihrer claude_desktop_config.json Folgendes hinzu:

NPX

{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-slack"
      ],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-your-bot-token",
        "SLACK_TEAM_ID": "T01234567",
        "SLACK_CHANNEL_IDS": "C01234567, C76543210"
      }
    }
  }
}

Docker

{
  "mcpServers": {
    "slack": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SLACK_BOT_TOKEN",
        "-e",
        "SLACK_TEAM_ID",
        "-e",
        "SLACK_CHANNEL_IDS",
        "mcp/slack"
      ],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-your-bot-token",
        "SLACK_TEAM_ID": "T01234567",
        "SLACK_CHANNEL_IDS": "C01234567, C76543210"
      }
    }
  }
}

Verwendung mit VS Code

Klicken Sie für eine schnelle Installation auf eine der Installationsschaltflächen unten ...

Für die manuelle Installation fügen Sie den folgenden JSON-Block zu Ihrer Benutzereinstellungsdatei (JSON) in VS Code hinzu. Drücken Sie dazu Ctrl + Shift + P und geben Sie Preferences: Open Settings (JSON) ein.

Optional können Sie es einer Datei namens .vscode/mcp.json in Ihrem Arbeitsbereich hinzufügen. Dadurch können Sie die Konfiguration mit anderen teilen.

Beachten Sie, dass der mcp Schlüssel in der Datei .vscode/mcp.json nicht benötigt wird.

NPX

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "slack_bot_token",
        "description": "Slack Bot Token (starts with xoxb-)",
        "password": true
      },
      {
        "type": "promptString",
        "id": "slack_team_id",
        "description": "Slack Team ID (starts with T)"
      }
    ],
    "servers": {
      "slack": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-slack"],
        "env": {
          "SLACK_BOT_TOKEN": "${input:slack_bot_token}",
          "SLACK_TEAM_ID": "${input:slack_team_id}"
        }
      }
    }
  }
}

Docker

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "slack_bot_token",
        "description": "Slack Bot Token (starts with xoxb-)",
        "password": true
      },
      {
        "type": "promptString",
        "id": "slack_team_id",
        "description": "Slack Team ID (starts with T)"
      }
    ],
    "servers": {
      "slack": {
        "command": "docker",
        "args": ["run", "-i", "--rm", "mcp/slack"],
        "env": {
          "SLACK_BOT_TOKEN": "${input:slack_bot_token}",
          "SLACK_TEAM_ID": "${input:slack_team_id}"
        }
      }
    }
  }
}

Umgebungsvariablen

1. SLACK_BOT_TOKEN : Erforderlich. Das Bot-Benutzer-OAuth-Token beginnt mit xoxb- .

2. SLACK_TEAM_ID : Erforderlich. Ihre Slack-Workspace-ID beginnt mit T

3. SLACK_CHANNEL_IDS : Optional. Komma-getrennte Liste von Kanal-IDs zur Einschränkung des Kanalzugriffs (z. B. „C01234567, C76543210“). Wenn nicht festgelegt, werden alle öffentlichen Kanäle aufgelistet.

Fehlerbehebung

Wenn Berechtigungsfehler auftreten, überprüfen Sie Folgendes:

1. Alle erforderlichen Bereiche werden zu Ihrer Slack-App hinzugefügt

2. Die App ist ordnungsgemäß in Ihrem Arbeitsbereich installiert

3. Die Token und die Arbeitsbereichs-ID werden korrekt in Ihre Konfiguration kopiert

4. Die App wurde zu den Kanälen hinzugefügt, auf die sie zugreifen muss

Bauen

Docker-Build:

docker build -t mcp/slack -f src/slack/Dockerfile .

Lizenz

Dieser MCP-Server ist unter der MIT-Lizenz lizenziert. Das bedeutet, dass Sie die Software unter den Bedingungen der MIT-Lizenz frei verwenden, ändern und verbreiten dürfen. Weitere Informationen finden Sie in der LICENSE-Datei im Projekt-Repository.