Guía de configuración del servidor MCP
El servidor MCP (Model Context Protocol) de ISO Mate permite a los asistentes de IA y a las herramientas de IDE gestionar toda tu plataforma directamente. Con 15 proveedores de herramientas que cubren DevOps, QA, tareas, incidentes, cumplimiento, mesa de ayuda, notas, objetos personalizados, flujos de trabajo, informes, IA del editor, contactos y facturación, puedes operar ISO Mate sin salir de tu entorno de desarrollo.
Paso 1: Crear un Token de API
- Ve a Perfil > Tokens de API en la barra de navegación superior.
- Haz clic en Crear Token.
- Dale al token un nombre descriptivo (por ejemplo, “Token MCP del IDE”).
- Selecciona los ámbitos que necesita tu herramienta. Los ámbitos están organizados por módulo:
- issue.*, sprint.*, release.*, userstory.*, feature.* para DevOps
- testcase.*, testcycle.*, testenvironment.* para QA
- task.*, recurringtask.* para la Gestión de Tareas
- incident.* para Incidentes
- compliance.* para Cumplimiento (marcos, requisitos, controles, políticas, procedimientos, evidencia, certificaciones)
- compliance_ai.search, compliance_ai.generate para las herramientas de IA de Cumplimiento (buscar, generar plantilla, completar sección)
- ticket.*, cannedresponse.* para la Mesa de Ayuda
- note.*, notefolder.*, notetag.* para Notas
- objecttype.*, entry.* para Objetos Personalizados
- workflow.* para Flujos de Trabajo (incluyendo métricas, plantillas, versiones e importación/exportación)
- compliance.reports, sales.reports, feedback.reports, calendar.reports para las herramientas de Informes
- editor_ai.assist para las herramientas de IA del Editor
- contact.* para Contactos
- billing.view para Facturación (solo lectura, excluido de los ámbitos de token por defecto)
- Haz clic en Guardar y copia el token. No se mostrará de nuevo.
Paso 2: Configurar 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: El endpoint de tu API MCP de ISO Mate
- Token de API: El token que creaste en el Paso 1
Proveedores de herramientas disponibles
Una vez conectado, los siguientes 15 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 ágil: incidencias (listar, obtener, crear, actualizar, eliminar, añadir/listar comentarios), sprints (CRUD, iniciar, cerrar), lanzamientos (CRUD, lanzar, 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 finalización) 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 del registro 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 certificación), procedimientos (CRUD, publicar, versionar, alternar activo), evidencia (listar, obtener, actualizar, eliminar, vincular a controles), certificaciones (listar, progreso) e IA de Cumplimiento (buscar en políticas y procedimientos publicados, generar plantillas, completar secciones).
6. Mesa de Ayuda
Gestiona el 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 la 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
Crea y gobierna automatizaciones: flujos de trabajo (CRUD, alternar, activar/desactivar/eliminar en lote, rotar secreto de webhook, prueba (dry-run), descubrir y despachar ejecuciones manuales, auditorías), ejecuciones (listar, obtener, estadísticas, reintentar), métricas (por flujo y visión general de la cuenta), plantillas (explorar la galería, instanciar), versiones (historial, restaurar), importación y exportación (JSON portátil) y descubrimiento de configuración (entidades de activación, eventos, fuentes, tipos de acción, esquemas de campos, listas de relaciones permitidas, tipos de objeto, buzones, formularios y validación de marcadores de posición).
10. Informes
Obtén datos de informes listos para gráficos que reflejan las páginas de informes de la consola. Informes de cumplimiento (distribución y tendencias), informes de ventas (distribución y tendencias), informes de comentarios (distribución y tendencias) e informes de calendario (distribución y tendencias). Cada uno acepta filtros de rango de fechas, y las tendencias aceptan un intervalo de agrupación de día, semana, mes o año. Cada informe requiere su permiso de informes correspondiente.
11. IA del Editor
Genera y refina contenido de texto enriquecido para los contextos de editor compatibles, como políticas, procedimientos, incidencias, notas, tickets y correos.
12. Contactos
Gestiona tu directorio de contactos: CRUD completo con búsqueda por correo, nombre o empresa.
13. Facturación (Solo Lectura)
Consulta el estado de la suscripción, los detalles del plan, la información de prueba y el historial de facturas. Los ámbitos de gestión de facturación se excluyen de los tokens de API por diseño por seguridad.
Herramientas heredadas de incidencias
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 la compatibilidad con clientes MCP más antiguos.
Uso de claves de proyecto
Puedes referenciar incidencias por su clave de proyecto en lugar de la UUID. Por ejemplo, pasa BUG-7 a la operación get para obtener ese error directamente. Usa el filtro project_key para encontrar todas las incidencias con un prefijo determinado.
Notas de seguridad
- Cada token está limitado a una sola cuenta. Los datos de otras cuentas nunca son accesibles.
- Otorga solo los ámbitos que tu herramienta necesita (principio de mínimo privilegio).
- Los ámbitos de gestión de facturación se excluyen de los tokens de API por diseño.
- Revoca los tokens de inmediato si se ven comprometidos.