Slack MCP Server

    

Slack MCP Server

Ponte al día en Slack sin leerlo.

No leídos, hilos y búsqueda, en el contexto de tu agente, desde la sesión que ya tienes.

npx -y @jtalk22/slack-mcp --setup

Claude Code Claude Desktop Cursor Copilot Windsurf Gemini CLI Codex CLI cualquier cliente stdio MCP

▶ Es lunes, 9:07—mira lo que explotó durante la noche · recorrido interactivo · guía de configuración

Cómo funciona · Por qué autenticación de sesión · Grid y credenciales · Instalación · 21 herramientas · Flujos de trabajo · Local vs. alojado

Es lunes, 9:07. Slack ya tiene opiniones formadas.

Preguntas "¿qué explotó durante la noche?" y el agente lee el espacio de trabajo en lugar de ti. Reconstruye el P1 de las 2 AM desde #incidents—responsable, resolución y el paso del runbook que sigue mal. Encuentra el PIN de la impresora que ha estado esperando en #facilities durante cinco meses. Luego cierra los bucles gestionados—respuestas, reacciones, cambios de estado de lectura—solo donde tú lo apruebas.

Esto no es automatización de capturas de pantalla. El agente llama a Slack a través de una superficie de herramientas MCP real y recibe resultados tipados que puede buscar, resumir, exportar o sobre los que puede actuar.

Construido más allá de la demo

La parte difícil no es otra herramienta de chat. Es la capa operativa subyacente: extracción de sesión del navegador que nombra sus etapas de fallo, un ciclo de vida de credenciales diseñado para rotación, lecturas de fidelidad completa, escrituras protegidas y salida de flujo de trabajo tipada. El código es JavaScript simple en este repositorio—audítalo antes de confiarle una sesión.

Dos formas de acceder a Slack

Slack ya sabe quién eres. La ruta oficial es una integración remota gestionada por Slack gobernada por la política del espacio de trabajo—un ajuste sólido para despliegues sancionados por la organización, documentada por Slack con ajustes de integración bajo control administrativo. Este proyecto es la ruta local directa: autenticación basada en sesión desde la sesión del navegador que ya está en Chrome, stdio local, cualquier cliente stdio MCP y sin aplicación de Slack ni solicitud de administrador. Misma identidad de Slack. Mismos permisos subyacentes. Una ruta radicalmente más corta desde tu espacio de trabajo hasta tu agente.

Grid, credenciales y caché

Enterprise Grid. Grid ejecuta detección agresiva de anomalías de sesión. La automatización de sesión del navegador puede activarla, lo que marca la sesión y la mata, independientemente de qué herramienta impulse el tráfico. Las llamadas salientes se espacian por defecto para mantenerse bajo los umbrales de ráfaga (SLACK_MCP_MIN_REQUEST_INTERVAL_MS, predeterminado 350; SLACK_MCP_MAX_CONCURRENCY, predeterminado 3). El espaciado reduce ese riesgo; no lo elimina. En Grid, usa el nivel OAuth alojado o el MCP oficial de Slack en su lugar.

Extracción de credenciales. --setup lee el token xoxc- más reciente del LevelDB en disco de Chrome, captura la base de datos SQLite de cookies, recupera el Almacenamiento Seguro de Chrome del Llavero de macOS y ejecuta descifrado PBKDF2 + AES-128-CBC localmente. Escribe el archivo de token, entradas del Llavero y metadatos no secretos. No transmite nada—el servidor habla con Slack y con ningún otro lugar.

Este es el mismo patrón de acceso que usan los ladrones de credenciales. El Cifrado Vinculado a la Aplicación de Chrome existe para hacer más difícil esta clase de lectura, y las familias de infostealers (Lumma, Vidar, Meduza) lo evaden para robar sesiones activas. El mecanismo aquí es comparable. Lo que difiere es que tú lo ejecutas, en tu propia máquina, contra tu propia sesión, y nada sale del host. La fuente es JavaScript simple en este repositorio; audítalo antes de entregarle una sesión activa.

Caché de usuarios. Existe una caché: búsquedas de nombres de usuario, pobladas bajo demanda, máximo 500 entradas, TTL de una hora. Sin contenido de mensajes, sin historial de canales y sin copia persistente del espacio de trabajo almacenada.

Instalación

Se recomienda Node 22 o 24. Node 20 sigue siendo compatible para la línea v4.

npx -y @jtalk22/slack-mcp --setup

¿Prefieres una CLI persistente: npm install -g @jtalk22/slack-mcp y luego slack-mcp --setup.

Luego:

1. Elige tu cliente en la guía de configuración.
2. Registra el comando stdio generado.
3. Reinicia completamente el cliente.
4. Pide al agente que ejecute slack_health_check.
5. Un nombre de espacio de trabajo en la respuesta significa que la conexión está activa.

Usa el mismo comando de servidor en todas partes:

{
  "command": "npx",
  "args": ["-y", "@jtalk22/slack-mcp"]
}

En macOS, la configuración puede extraer desde Chrome y persistir el backend de almacenamiento seleccionado. En otras plataformas, proporciona SLACK_TOKEN y SLACK_COOKIE a través de la configuración de entorno del cliente. Docker, HTTP y ejemplos detallados de clientes están en docs/SETUP.md y docs/DEPLOYMENT-MODES.md.

21 herramientas: leer, actuar, automatizar

La superficie local incluye 21 herramientas hoy: 12 operaciones de Slack de solo lectura, 4 herramientas de ruta de escritura que cada una lleva una anotación destructiva MCP para que los clientes puedan controlar las escrituras en el espacio de trabajo, 3 herramientas de flujo de trabajo locales incluida la propia puesta al día, y 2 stubs de inteligencia alojada que devuelven un payload de actualización estructurado sin hacer una llamada a Slack. Cuatro herramientas de lectura aceptan include_rich_message_fields: true para mostrar adjuntos, bloques, archivos, reacciones y metadatos—las entradas completas y los contratos de respuesta están en docs/API.md.

Anunciar menos herramientas. Un cliente paga por el esquema de herramientas en cada turno que lo lleva. SLACK_MCP_TOOLS=essentials anuncia seis herramientas—no leídos, historial, búsqueda, hilo, búsqueda de usuario, envío—costando aproximadamente 985 tokens estimados de esquema por turno frente a unos 3,600 por las 21. SLACK_MCP_TOOLS=read anuncia las 12 operaciones de Slack de solo lectura listadas abajo, cerca de 1,690. --tools=slack_x,slack_y toma un conjunto explícito. El predeterminado sigue siendo las 21. Filtrar cambia lo que se anuncia, no lo que se puede llamar. Reproduce los números con node scripts/measure-tool-schema.js (una estimación de ~4 caracteres por token).

Flujos de trabajo tipados: Slack entra, JSON sale

Vincula un tipo de flujo de trabajo a canales, personas prioritarias, retención y cadencia. slack_catch_me_up luego lee ese alcance localmente y entrega a tu agente la evidencia: qué hilos quedaron sin respuesta y por cuánto tiempo, qué dijeron o en qué se fijaron tus personas prioritarias, qué conversaciones realmente avanzaron. Él hace la recopilación; tu agente escribe el resumen según el contrato a continuación.

No hay un modelo del lado del servidor en esa ruta, porque no es necesario — el cliente que llama a este servidor ya es un modelo de lenguaje. Hosted agrega lo que genuinamente necesita infraestructura: recuperación semántica indexada y ejecutar la misma puesta al día en un horario mientras tu laptop está cerrada.

npx -y @jtalk22/slack-mcp --apply-template oncall-handoff --channels C012345,C067890

Dónde viven las credenciales

La resolución es determinista; la primera coincidencia gana:

1. SLACK_TOKEN + SLACK_COOKIE
2. archivo de token (chmod 600)
3. Llavero de macOS
4. Extracción de Chrome en macOS

Las credenciales de sesión comúnmente rotan después de una o dos semanas. Cuando Slack devuelve invalid_auth, not_authed, token_expired, token_revoked, account_inactive o HTTP 401, ejecuta npx -y @jtalk22/slack-mcp --setup para recuperarte localmente. En macOS, slack_refresh_tokens o --refresh-tokens se actualiza sin salir del cliente; el LaunchAgent opcional en docs/SETUP.md mantiene saludables instalaciones de larga inactividad.

{
  "mcpServers": {
    "slack-work": {
      "command": "npx",
      "args": ["-y", "@jtalk22/slack-mcp"],
      "env": { "SLACK_MCP_PROFILE": "work" }
    },
    "slack-personal": {
      "command": "npx",
      "args": ["-y", "@jtalk22/slack-mcp"],
      "env": { "SLACK_MCP_PROFILE": "personal" }
    }
  }
}

Local gratuito cuando tú conduces. Alojado cuando debe conducirse solo.

Cuando el control local es suficiente, detente aquí—todo lo anterior tiene licencia MIT y se ejecuta en tu máquina. El producto local está completo, no es una prueba limitada: alojado gana la actualización por continuidad, inteligencia y colaboración, no por retener el acceso ordinario a Slack como rehén. Alojado existe para trabajar que debe sobrevivir a una sesión rotatoria de navegador:

• OAuth permanente;
• búsqueda semántica indexada;
• puesta al día y triaje programados;
• informes de flujo de trabajo validados por contrato;
• perfiles compartidos y continuidad administrada del espacio de trabajo.

El modo local nunca nos contacta; se ejecuta en tu máquina y solo habla con Slack. Alojado nunca recibe una cookie del navegador; se ejecuta con OAuth permanente, para trabajos que deben sobrevivir a una sesión rotatoria — programaciones no supervisadas, Enterprise Grid. Todo lo anterior tiene licencia MIT y está completo por sí mismo.

Ver precios de alojado en vivo →

Seguridad y procedencia

• Los archivos de credenciales son solo para el propietario; el modo solo Llavero mantiene credenciales en texto plano fuera del disco.
• La configuración falla de forma segura para modos de almacenamiento desconocidos y perfiles inválidos.
• Las escrituras son atómicas y el estado de credenciales compartido está bloqueado por proceso.
• El servidor web local se vincula a localhost; las herramientas de escritura del espacio de trabajo llevan anotaciones destructivas.
• Cada versión se publica desde CI con procedencia npm.

Procedencia: no confíes solo en mi palabra

npm audit signatures

Un resultado limpio verifica que las firmas y atestaciones del paquete se rastrean a través de la cadena de publicación. Inspecciona el paquete antes de entregarle una sesión de Slack en vivo. Política completa: SECURITY.md.

Documentación

Configuración · API · Arquitectura · Compatibilidad · Modos de despliegue · Recetas · Solución de problemas · Hoja de ruta

Contribuciones

Se aceptan PRs. Lee CONTRIBUTING.md y ejecuta node --check en el JavaScript modificado antes de enviarlo.

Licencia

MIT — ver LICENSE.

Aviso legal

No está afiliado con Slack Technologies, Inc. Este servidor usa credenciales de sesión del navegador. Revisa la política de uso aceptable de tu espacio de trabajo antes de ejecutarlo.

npx -y @jtalk22/slack-mcp --setup