cib7-mcp

Herramienta MCP para investigar instancias de procesos de CIB Seven. Proporciona a Claude un conocimiento exhaustivo de las API REST de CIB Seven con ejecución en tiempo real y autenticación Keycloak.

Características

7 herramientas de investigación — instancias de procesos, incidentes, historial de actividades, variables, XML BPMN, trabajos
Descripciones semánticas — Claude entiende lo que significa cada campo a nivel operativo, no solo datos brutos de los endpoints
Introspección BPMN — obtenga el XML de definición de procesos, Claude razona sobre la ruta de ejecución esperada frente a la real
Autenticación Keycloak — flujo de credenciales de cliente OIDC con actualización automática de tokens
Redacción de variables — patrones regex configurables para ocultar datos sensibles
Prompts de diagnóstico — flujos de trabajo diagnose_stuck_process e incident_report

Instalación

Claude Desktop

Añada a su claude_desktop_config.json:

{
  "mcpServers": {
    "cib7": {
      "command": "npx",
      "args": ["cib7-mcp"],
      "env": {
        "CIB7_URL": "http://localhost:6009/rest"
      }
    }
  }
}

Claude Code

claude mcp add cib7-mcp -- npx cib7-mcp

Luego, establezca la variable de entorno CIB7_URL en su instancia de CIB Seven.

Configuración

Toda la configuración se realiza a través de variables de entorno.

Variable	Requerido	Descripción
`CIB7_URL`	Sí	URL de la API REST de CIB Seven (ej. `http://localhost:6009/rest`)
`KEYCLOAK_URL`	No	URL del servidor Keycloak (ej. `https://keycloak.example.com`)
`KEYCLOAK_REALM`	No	Nombre del reino de Keycloak
`KEYCLOAK_CLIENT_ID`	No	ID de cliente de Keycloak
`KEYCLOAK_CLIENT_SECRET`	No	Secreto de cliente de Keycloak
`CIB7_REDACT_PATTERNS`	No	Patrones regex delimitados por comas para la redacción de variables (ej. `password.,secret.,token.*`)

Si se establece alguna variable KEYCLOAK_*, se deben proporcionar las cuatro. Si no se establece ninguna, la herramienta se ejecuta en modo no autenticado.

Con Keycloak

{
  "mcpServers": {
    "cib7": {
      "command": "npx",
      "args": ["cib7-mcp"],
      "env": {
        "CIB7_URL": "https://your-instance.com/rest",
        "KEYCLOAK_URL": "https://your-keycloak.com",
        "KEYCLOAK_REALM": "your-realm",
        "KEYCLOAK_CLIENT_ID": "mcp-client",
        "KEYCLOAK_CLIENT_SECRET": "your-secret",
        "CIB7_REDACT_PATTERNS": "password.*,secret.*,token.*,creditCard.*"
      }
    }
  }
}

Herramientas

Herramienta	Descripción
`get_process_instance`	Buscar una instancia de proceso por ID — estado, definición, clave de negocio
`list_process_instances`	Buscar instancias de proceso por clave de definición, clave de negocio o estado
`list_incidents`	Listar incidentes abiertos, opcionalmente filtrados por instancia de proceso
`get_activity_history`	Seguimiento de ejecución — cada actividad que se ejecutó, en orden
`get_process_variables`	Todas las variables para una instancia de proceso (con redacción)
`get_process_definition_xml`	Modelo XML BPMN (elementos de diagrama eliminados para facilitar la lectura)
`get_job_details`	Detalles de ejecución del trabajo — reintentos, mensajes de excepción

Prompts

Prompt	Descripción
`diagnose_stuck_process`	Diagnóstico paso a paso para una instancia de proceso bloqueada
`incident_report`	Informe exhaustivo de todos los incidentes abiertos con análisis de causa raíz

Ejemplo de uso

Pregunte a Claude:

"¿Está bloqueado el proceso abc-123?"
"Muéstrame todos los incidentes abiertos"
"¿Cuál es la definición BPMN para la definición de proceso orderProcess:1:456?"
"Genera un informe de incidentes"

Desarrollo

npm install
npm run build
npm test

Requiere Node.js 18+.

Licencia

MIT

Install Server

A

security – no known vulnerabilities

F

license - not found

A

quality - A tier

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

CIB Seven MCP Server