Slack User MCP Server

by lars-hagen
Verified

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Allows Claude to interact with Slack workspaces as a user, including listing channels, posting messages, replying to threads, adding reactions, getting channel history, getting thread replies, retrieving user lists, and viewing user profiles

Servidor MCP de usuarios de Slack

Servidor MCP para la API de Slack, que permite a Claude interactuar con los espacios de trabajo de Slack como usuario.

Herramientas

  1. slack_list_channels
    • Enumerar canales públicos en el espacio de trabajo
    • Entradas opcionales:
      • limit (número, predeterminado: 100, máximo: 200): Número máximo de canales a devolver
      • cursor (cadena): cursor de paginación para la página siguiente
    • Devuelve: Lista de canales con sus IDs e información
  2. slack_post_message
    • Publicar un nuevo mensaje en un canal de Slack
    • Entradas requeridas:
      • channel_id (cadena): El ID del canal donde se publicará
      • text (cadena): el texto del mensaje a publicar
    • Devoluciones: Confirmación de publicación del mensaje y marca de tiempo
  3. slack_reply_to_thread
    • Responder a un hilo de mensajes específico
    • Entradas requeridas:
      • channel_id (cadena): El canal que contiene el hilo
      • thread_ts (cadena): marca de tiempo del mensaje principal
      • text (cadena): El texto de respuesta
    • Devoluciones: Confirmación de respuesta y marca de tiempo
  4. slack_add_reaction
    • Agregar una reacción emoji a un mensaje
    • Entradas requeridas:
      • channel_id (cadena): El canal que contiene el mensaje
      • timestamp (cadena): Marca de tiempo del mensaje al que se debe reaccionar
      • reaction (cadena): Nombre del emoji sin dos puntos
    • Devoluciones: Confirmación de reacción
  5. slack_get_channel_history
    • Obtener mensajes recientes de un canal
    • Entradas requeridas:
      • channel_id (cadena): El ID del canal
    • Entradas opcionales:
      • limit (número, predeterminado: 10): Número de mensajes a recuperar
    • Devuelve: Lista de mensajes con su contenido y metadatos
  6. slack_get_thread_replies
    • Obtener todas las respuestas en un hilo de mensajes
    • Entradas requeridas:
      • channel_id (cadena): El canal que contiene el hilo
      • thread_ts (cadena): marca de tiempo del mensaje principal
    • Devuelve: Lista de respuestas con su contenido y metadatos
  7. slack_get_users
    • Obtener la lista de usuarios del espacio de trabajo con información básica del perfil
    • Entradas opcionales:
      • cursor (cadena): cursor de paginación para la página siguiente
      • limit (número, predeterminado: 100, máximo: 200): Máximo de usuarios a devolver
    • Devuelve: Lista de usuarios con sus perfiles básicos
  8. slack_get_user_profile
    • Obtenga información detallada del perfil de un usuario específico
    • Entradas requeridas:
      • user_id (cadena): el ID del usuario
    • Devoluciones: Información detallada del perfil de usuario

Configuración

  1. Crear una aplicación de Slack:
  2. Configurar los ámbitos de token de usuario: navegue a "OAuth y permisos" y agregue estos ámbitos:
    • channels:history - Ver mensajes y otro contenido en canales públicos
    • channels:read - Ver información básica del canal
    • chat:write - Envía mensajes como tú mismo
    • reactions:write - Agregar reacciones emoji a los mensajes
    • users:read - Ver usuarios y su información básica
  3. Instalar la aplicación en el espacio de trabajo:
    • Haga clic en "Instalar en el espacio de trabajo" y autorice la aplicación.
    • Guarde el "Token OAuth del usuario" que comienza con xoxp-
  4. Obtén tu ID de equipo (comienza con T ) siguiendo esta guía

Uso con Claude Desktop

Agregue lo siguiente a su claude_desktop_config.json :

Instalación local

Primero instale y construya el servidor:

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

A continuación configure Claude Desktop:

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

NPX

{ "mcpServers": { "slack": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-slack-user" ], "env": { "SLACK_TOKEN": "xoxp-your-user-token", "SLACK_TEAM_ID": "T01234567" } } } }

Estibador

{ "mcpServers": { "slack": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "SLACK_TOKEN", "-e", "SLACK_TEAM_ID", "mcp/slack-user" ], "env": { "SLACK_TOKEN": "xoxp-your-user-token", "SLACK_TEAM_ID": "T01234567" } } } }

Instalación mediante herrería

Para instalar Slack User Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @lars-hagen/slack-user-mcp2 --client claude

Solución de problemas

Si encuentra errores de permisos, verifique que:

  1. Todos los ámbitos necesarios se agregan a su aplicación Slack
  2. La aplicación está instalada correctamente en su espacio de trabajo.
  3. Los tokens y el ID del espacio de trabajo se copian correctamente en su configuración
  4. La aplicación se ha añadido a los canales a los que necesita acceder.
  5. Estás usando un token OAuth de usuario (comienza con xoxp-), no un token de bot

Construir

Compilación de Docker:

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

Licencia

Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Permite la interacción con los espacios de trabajo de Slack como usuario, lo que admite la lista de canales, la publicación de mensajes, los hilos, las reacciones y la gestión de usuarios a través de la API de Slack.

  1. Tools
    1. Setup
      1. Usage with Claude Desktop
      2. Installing via Smithery
      3. Troubleshooting
    2. Build
      1. License
        ID: wc0u5519qh