Servidor MCP de Slack

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

Herramientas

1. slack_list_channels

   • Enumere canales públicos o predefinidos 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:

   • Visita la página de aplicaciones de Slack

   • Haga clic en "Crear nueva aplicación"

   • Seleccione "Desde cero"

   • Nombra tu aplicación y selecciona tu espacio de trabajo

2. Configurar los ámbitos del token de bot: Vaya 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 la aplicación

   • reactions:write - Agregar reacciones emoji a los mensajes

   • users:read - Ver usuarios y su información básica

   • users.profile:read - Ver perfiles detallados de los usuarios

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 "Bot User OAuth Token" que comienza con xoxb-

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 :

NPX

estibador

Uso con VS Code

Para una instalación rápida, haga clic en uno de los botones de instalación a continuación...

Para la instalación manual, agregue el siguiente bloque JSON a su archivo de configuración de usuario (JSON) en VS Code. Para ello, presione Ctrl + Shift + P y escriba Preferences: Open Settings (JSON) .

Opcionalmente, puede agregarlo a un archivo llamado .vscode/mcp.json en su espacio de trabajo. Esto le permitirá compartir la configuración con otros.

Tenga en cuenta que la clave mcp no es necesaria en el archivo .vscode/mcp.json .

NPX

Estibador

Variables de entorno

1. SLACK_BOT_TOKEN : Obligatorio. El token OAuth del usuario del bot empieza por xoxb- .

2. SLACK_TEAM_ID : Obligatorio. El ID de tu espacio de trabajo de Slack empieza por T

3. SLACK_CHANNEL_IDS : Opcional. Lista de ID de canal, separados por comas, para limitar el acceso (p. ej., "C01234567, C76543210"). Si no se configura, se mostrarán todos los canales públicos.

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.

Construir

Compilación de Docker:

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.