MCP de Integraciones de Trabajo

Este es un pequeño servidor MCP que expone herramientas para múltiples sistemas de trabajo (Jira actualmente, con Slack/GitHub y otros planificados).

Herramientas actuales

• jira_get_issue - Obtener una incidencia de Jira por clave

• jira_search - Buscar en Jira usando JQL

• slack_get_message_by_url - Obtener un mensaje de Slack por URL

• slack_get_channel_history - Obtener mensajes recientes de Slack

• slack_find_channel - Resolver el nombre de un canal a ID

• slack_find_user - Resolver un usuario por correo electrónico o nombre de usuario

• confluence_get_page - Obtener una página de Confluence por ID (incluye pie de página + comentarios en línea con respuestas anidadas)

• confluence_get_page_by_url - Obtener una página de Confluence por URL (incluye pie de página + comentarios en línea con respuestas anidadas)

• confluence_search - Buscar en Confluence usando CQL

Configuración

1. Instalar dependencias:

   • npm install

2. Configurar variables de entorno (ejemplos):

   • JIRA_BASE=https://company.atlassian.net

   • JIRA_EMAIL=you@company.com

   • JIRA_TOKEN=your_api_token

   • JIRA_API_VERSION=3

   • SLACK_TOKEN=xoxb-your-slack-bot-token

   • CONFLUENCE_BASE=https://company.atlassian.net/wiki

   • CONFLUENCE_EMAIL=you@company.com

   • CONFLUENCE_TOKEN=your_api_token

3. Registrar el servidor MCP en Cursor (~/.cursor/mcp.json):

   {
     "mcpServers": {
       "work-integrations-mcp": {
         "command": "npx",
         "args": [
           "tsx",
           "/ABS/PATH/jira-mcp/server.ts"
         ],
         "env": {
           "JIRA_BASE": "https://company.atlassian.net",
           "JIRA_EMAIL": "you@company.com",
           "JIRA_TOKEN": "your_api_token",
           "JIRA_API_VERSION": "3",
          "SLACK_TOKEN": "xoxb-your-slack-bot-token",
          "CONFLUENCE_BASE": "https://company.atlassian.net/wiki",
          "CONFLUENCE_EMAIL": "you@company.com",
          "CONFLUENCE_TOKEN": "your_api_token"
         }
       }
     }
   }

4. Reiniciar Cursor.

Ejemplos de uso

• "Usa jira_get_issue con la clave CVR-248"

• "Busca en Jira con JQL: project = CVR ORDER BY updated DESC"

• "Usa slack_get_message_by_url con la URL https://..."

• "Usa slack_get_channel_history con el canal general"

• "Usa slack_find_user con el correo user@company.com"

• "Usa confluence_get_page con el ID 123456"

• "Usa confluence_get_page_by_url con la URL https://.../wiki/..."

• "Usa confluence_search con CQL space = DOCS and type = page"

Notas de configuración de Slack

Crea una aplicación de Slack e instálala en tu espacio de trabajo. Los alcances (scopes) mínimos para canales públicos son:

• channels:read

• channels:history

• users:read

• users:read.email

Para canales privados, añade:

• groups:read

• groups:history

Extensión

Añade nuevas herramientas para Slack, GitHub u otros servicios creando una nueva carpeta bajo services/ y registrando el módulo en server.ts:

1. Crea services/<service>/client.ts para la autenticación y llamadas a la API

2. Crea services/<service>/tools.ts exportando un ToolModule

3. Importa el módulo en server.ts y pásalo a mergeToolModules

4. Añade cualquier variable de entorno nueva en la configuración MCP de Cursor si es necesario

Mantén los nombres de las herramientas estables para que los prompts existentes sigan funcionando.