Guía de Configuración del Servidor MCP
El servidor MCP (Model Context Protocol) de ISO Mate permite a los asistentes de IA y herramientas IDE gestionar toda la plataforma directamente. Con 12 proveedores de herramientas que cubren DevOps, QA, tareas, incidentes, cumplimiento, mesa de ayuda, notas, objetos personalizados, flujos de trabajo, contactos y facturación, puedes operar ISO Mate sin salir de tu entorno de desarrollo.
Paso 1: Crear un Token API
- Navega a Perfil > Tokens API en la barra de navegación superior.
- Haz clic en Crear Token.
- Dale al token un nombre descriptivo (por ejemplo, “Token MCP IDE”).
- Selecciona los alcances que tu herramienta necesita. Los alcances están organizados por módulo:
- issue.*, sprint.*, release.*, userstory.*, feature.* para DevOps
- testcase.*, testcycle.*, testenvironment.* para QA
- task.*, recurringtask.* para Gestión de Tareas
- incident.* para Incidentes
- compliance.* para Cumplimiento (marcos, requisitos, controles, políticas, procedimientos, evidencia, atestaciones)
- ticket.*, cannedresponse.* para Mesa de Ayuda
- note.*, notefolder.*, notetag.* para Notas
- objecttype.*, entry.* para Objetos Personalizados
- workflow.* para Flujos de Trabajo
- contact.* para Contactos
- billing.view para Facturación (solo lectura, excluido de los alcances de token por defecto)
- Haz clic en Guardar y copia el token. No se mostrará de nuevo.
Paso 2: Configura tu Cliente MCP
Añade el servidor MCP de ISO Mate a la configuración de tu cliente. El formato exacto depende de tu herramienta, pero necesitarás:
- URL del Servidor: Tu endpoint de la API MCP de ISO Mate
- Token API: El token que creaste en el Paso 1
Proveedores de Herramientas Disponibles
Una vez conectado, los siguientes 12 proveedores de herramientas están disponibles. Cada proveedor usa un patrón de recurso/operación (por ejemplo, recurso: “issues”, operación: “create”).
1. DevOps
Gestiona tu flujo de trabajo ágil: incidencias (listar, obtener, crear, actualizar, eliminar, añadir/listar comentarios), sprints (CRUD, iniciar, cerrar), versiones (CRUD, publicar, archivar), historias de usuario (CRUD) y funcionalidades (CRUD).
2. Aseguramiento de Calidad
Ejecuta tu proceso de QA: casos de prueba (CRUD con filtros de carpeta, prioridad y tipo), ciclos de prueba (CRUD, cerrar), ejecuciones de prueba (listar, obtener, iniciar, completar, bloquear con motivo) y entornos de prueba (CRUD).
3. Gestión de Tareas
Gestiona elementos de trabajo: tareas (CRUD, alternar completado) con prioridad, fechas de vencimiento y responsables. Tareas recurrentes (CRUD) con patrones de recurrencia diarios, semanales, mensuales, anuales o personalizados.
4. Gestión de Incidentes
Rastrea incidentes a lo largo de su ciclo de vida: operaciones CRUD, transiciones de estado (Abierto, Investigando, Contenido, Resuelto, Cerrado), asignación de usuarios con roles, vinculación de tareas y notas, y visualización de registros de auditoría.
5. Cumplimiento
Gestiona tu programa de cumplimiento: marcos (CRUD, archivar), requisitos (CRUD con seguimiento de estado), controles (CRUD, mapear a requisitos/políticas, vincular procedimientos), políticas (CRUD, publicar, versionar, asignar para atestación), procedimientos (CRUD, publicar, versionar, alternar activo), evidencia (listar, obtener, actualizar, eliminar, vincular a controles) y atestaciones (listar, progreso).
6. Mesa de Ayuda
Gestiona soporte: tickets (CRUD, añadir respuestas/notas, listar respuestas, fusionar, gestionar observadores, vincular entidades, gestionar etiquetas) y respuestas predefinidas (CRUD, listar categorías).
7. Notas
Organiza documentación: notas (CRUD, mover entre carpetas), carpetas de notas (CRUD para organización jerárquica) y etiquetas de notas (CRUD para categorización).
8. Objetos Personalizados
Trabaja con datos personalizados: tipos de objeto (CRUD para definiciones de esquema) y entradas (CRUD con validación automática de esquema).
9. Automatización de Flujos de Trabajo
Construye automatizaciones: flujos de trabajo (CRUD, alternar habilitado/deshabilitado), ejecuciones de flujos de trabajo (listar, obtener, estadísticas) y configuración de flujos de trabajo (descubrir entidades de activación, eventos, tipos de acción y esquemas de campos).
10. Contactos
Gestiona tu directorio de contactos: CRUD completo con búsqueda por correo electrónico, nombre o empresa.
11. Facturación (Solo Lectura)
Consulta el estado de suscripción, detalles del plan, información de prueba e historial de facturas. Los alcances de gestión de facturación están excluidos de los tokens API por diseño por seguridad.
12. Herramientas de Incidencias Heredadas
Las herramientas independientes de incidencias (list_issues, get_issue, create_issue, update_issue, delete_issue, add_issue_comment, list_issue_comments) también están disponibles para compatibilidad con clientes MCP anteriores.
Uso de Claves de Proyecto
Puedes referenciar incidencias por su clave de proyecto en lugar de UUID. Por ejemplo, pasa BUG-7 a la operación get para obtener ese bug directamente. Usa el filtro project_key para encontrar todas las incidencias con un prefijo dado.
Notas de Seguridad
- Cada token está limitado a una sola cuenta. Los datos de otras cuentas nunca son accesibles.
- Otorga solo los alcances que tu herramienta necesita (principio de mínimo privilegio).
- Los alcances de gestión de facturación están excluidos de los tokens API por diseño.
- Revoca los tokens inmediatamente si se ven comprometidos.