🎯 Arkiphere Jira MCP Server

A powerful MCP (Model Context Protocol) server for complete Jira project automation through Arkiphere Cloud platform. Manage tasks, track progress, and automate workflows with natural language conversations.

🚀 Features

📋 Complete Task Management

• ✅ Create Tasks: Full task creation with all optional fields (assignee, labels, priority, parent)
• 💬 Smart Comments: Add comments with automatic @mentions and watcher integration
• 🔄 Update Issues: Modify assignees, labels, priorities, and parent relationships
• 📊 Status Management: Change task status (To Do, In Progress, Done) with optional comments
• 🔍 Issue Details: Get comprehensive issue information including changelog and comments

👥 Advanced Project Management

• 📋 List Project Issues: Browse all project tasks with pagination support
• 👥 User Management: Get complete list of project users and watchers
• ✅ Status Verification: Verify current status of any issue
• 🔗 Parent-Child Relations: Create and manage subtasks with parent assignments

🌐 Global Integration

• 🔗 Arkiphere Cloud: Direct integration with enterprise-grade platform
• 🌍 Multi-language: Support for international teams and projects
• ⚡ Real-time: Instant synchronization with Jira Cloud
• 🔒 Secure: Enterprise-level security and authentication

📦 Installation

Global Installation (Recommended)

npm install -g arkiphere-jira-mcp

Direct Usage with npx

npx arkiphere-jira-mcp@latest

Local Development

npm install arkiphere-jira-mcp

Configuración en Cursor MCP

Agrega esto a tu ~/.cursor/mcp.json:

{
  "mcpServers": {
    "arkiphere-jira": {
      "command": "node",
      "args": ["/Users/codesystemsco/Documents/MCPs/mcp_jira/jira-mcp-server.js"],
      "env": {
        "PLATFORM_HOST": "https://arkiphere.cloud",
        "CONTACT_IDENTIFIER": "0a45e5d4-225e-439a-9d04-60f54b8b839b",
        "PROJECT_KEY": "GOTTA"
      }
    }
  }
}

🛠️ Herramientas Disponibles

1. create_jira_task - Crear Tarea

Crea una nueva tarea en Jira con campos opcionales.

Parámetros:

• summary (requerido): Título de la tarea
• description (opcional): Descripción con soporte markdown
• issue_type (opcional): Task, Story, Bug, Epic, Subtask
• assignee (opcional): Usuario a asignar
• labels (opcional): Array de etiquetas
• priority (opcional): Highest, High, Medium, Low, Lowest

Ejemplo de uso:

Crear una tarea urgente llamada "Fix login bug" asignada a alex con etiquetas bug y urgent

2. add_jira_comment - Agregar Comentario

Agrega comentarios a tareas existentes con soporte para @menciones.

Parámetros:

• issue_key (requerido): Clave de la tarea (ej: GOTTA-300)
• comment (requerido): Texto del comentario
• watchers (opcional): Array de usuarios a agregar como watchers

Ejemplo de uso:

Agregar comentario a GOTTA-300: "@alex @miguel Por favor revisar el progreso del bug fix"

3. update_jira_issue - Actualizar Issue

Actualiza campos de una tarea existente.

Parámetros:

• issue_key (requerido): Clave de la tarea
• assignee (opcional): Nuevo asignado
• labels (opcional): Etiquetas a agregar
• priority (opcional): Nueva prioridad

Ejemplo de uso:

Actualizar GOTTA-300 para asignar a miguel y cambiar prioridad a High

4. add_jira_watchers - Agregar Watchers

Agrega observadores a una tarea sin comentario.

Parámetros:

• issue_key (requerido): Clave de la tarea
• watchers (requerido): Array de usuarios

Ejemplo de uso:

Agregar a alex y miguel como watchers de GOTTA-300

5. get_jira_watchers - Obtener Watchers

Consulta los observadores actuales de una tarea.

Parámetros:

• issue_key (requerido): Clave de la tarea

Ejemplo de uso:

¿Quiénes son los watchers de GOTTA-300?

6. get_jira_project_users - Usuarios del Proyecto

Obtiene todos los usuarios disponibles en el proyecto.

Parámetros:

• project_key (opcional): Clave del proyecto

Ejemplo de uso:

Mostrar todos los usuarios disponibles en el proyecto

7. list_jira_project_issues - Listar Issues del Proyecto

Lista todas las issues del proyecto con soporte de paginación.

Parámetros:

• project_key (opcional): Clave del proyecto
• max_results (opcional): Máximo de resultados por página (default: 50)
• next_page_token (opcional): Token para siguiente página

Ejemplo de uso:

"Mostrar las primeras 20 tareas del proyecto GOTTA"
"Mostrar la siguiente página de tareas"

8. get_jira_issue_details - Detalles Completos de Issue

Obtiene información detallada de una issue específica incluyendo historial y comentarios.

Parámetros:

• issue_key (requerido): Clave de la tarea
• fields (opcional): Campos a obtener
• expand (opcional): Datos adicionales a expandir

Ejemplo de uso:

"Mostrar todos los detalles de GOTTA-284 incluyendo historial"
"Obtener información completa de GOTTA-288"

9. update_jira_issue_status - Cambiar Estado

Cambia el estado de una issue con comentario opcional.

Parámetros:

• issue_key (requerido): Clave de la tarea
• status_name (requerido): Nuevo estado (Done, In Progress, To Do)
• comment (opcional): Comentario al cambiar estado

Ejemplo de uso:

"Cambiar GOTTA-288 a Done con comentario de aprobación"
"Marcar GOTTA-284 como Done"

10. verify_jira_issue_status - Verificar Estado

Verifica el estado actual de una issue.

Parámetros:

• issue_key (requerido): Clave de la tarea

Ejemplo de uso:

"¿Cuál es el estado actual de GOTTA-284?"
"Verificar estado de GOTTA-288"

🔧 Configuración

Variables de Entorno

| Variable | Descripción | Valor por Defecto | |----------|-------------|-------------------| | PLATFORM_HOST | URL de Arkiphere Cloud | https://arkiphere.cloud | | CONTACT_IDENTIFIER | UUID de configuración Jira | 0a45e5d4-225e-439a-9d04-60f54b8b839b | | PROJECT_KEY | Clave del proyecto Jira | GOTTA |

📋 Ejemplos de Uso Conversacional

Crear Tarea Simple

"Crear una tarea llamada 'Implementar nueva API'"

Crear Tarea Completa

"Crear un bug urgente llamado 'Error en login' asignado a alex con descripción 'Los usuarios no pueden acceder al sistema' y etiquetas bug, urgent"

Agregar Comentario con Menciones

"Comentar en GOTTA-300: '@alex el bug está solucionado, por favor hacer testing'"

Actualizar Múltiples Campos

"Actualizar GOTTA-300: asignar a miguel, agregar etiqueta 'testing' y cambiar prioridad a High"

Gestión de Watchers

"Agregar a alex y miguel como watchers de GOTTA-300"
"¿Quiénes están siguiendo GOTTA-300?"

Consultar Usuarios

"¿Qué usuarios están disponibles en el proyecto?"

🔄 Flujo de Trabajo Típico

1. Consultar usuarios disponibles para conocer los nombres correctos
2. Crear tarea con información básica
3. Actualizar campos según sea necesario (asignado, prioridad, etiquetas)
4. Agregar watchers para notificar al equipo
5. Agregar comentarios para comunicar progreso

⚠️ Manejo de Errores

El servidor maneja automáticamente:

• ✅ Validación de parámetros requeridos
• ✅ Resolución automática de nombres de usuario
• ✅ Timeouts de red (30 segundos)
• ✅ Respuestas de error descriptivas
• ✅ Logging para debugging

🔐 Seguridad

• Todas las peticiones usan HTTPS
• El contact_identifier actúa como clave de autenticación
• No se almacenan credenciales localmente
• Logs no contienen información sensible

📊 Arquitectura

Cursor IDE (MCP Client)
        ↓
Jira MCP Server (Local)
        ↓ HTTPS POST
Arkiphere Cloud Platform
        ↓ REST API v3
Jira Cloud (vunkers.atlassian.net)

🚀 Desarrollo

Ejecutar en Modo Desarrollo

npm run dev

Probar Conexión

npm test

📞 Soporte

• 🐛 Issues: Reportar problemas en el repositorio
• 📖 Documentación: Ver MCP_SERVER_GUIDE.md para detalles técnicos
• 🔧 API: Documentación completa de endpoints disponible

Desarrollado por: Arkiphere Cloud LLC
Versión: 1.0.0
Licencia: MIT

Este MCP Server automatiza completamente la gestión de Jira desde conversaciones naturales en Cursor IDE.