@tyconsa/bizuit-bpmn-mcp

Servidor MCP para generar y validar procesos BPMN de BIZUIT desde tu cliente de IA (por ejemplo Claude Code). Instala además un skill de dominio que guía el recorrido de punta a punta.

Se corre siempre con npx, sin instalación global.

Requisitos

• Node.js ≥ 20 (LTS vigente). El paquete declara engines: node >=20.1.0; usá la LTS para soporte a largo plazo.
• Credenciales de tu ambiente BIZUIT (usuario + password), que te da el operador del curso o tu administrador. Se configuran en tu cliente MCP (config de usuario), no en la terminal.

Dónde vive la configuración de ambientes

El archivo bizuit.config.json (qué ambientes existen, su URL y de qué variables de entorno salen sus credenciales) se busca en dos ubicaciones fijas, en este orden:

1. <carpeta que abriste>/bizuit.config.json — el del proyecto. Si existe, es el que vale.
2. ~/.bizuit/bizuit.config.json — el de tu usuario, para cuando trabajás en cualquier carpeta. En Windows es C:\Users\<tu-usuario>\.bizuit\bizuit.config.json.

El del proyecto siempre le gana al de usuario. Si el del proyecto existe pero tiene un error, vas a ver ese error: no se usa el de usuario en su lugar — el archivo que editaste es el que te responde. doctor te dice cuál de los dos está usando.

Instalación (resumen)

# 1. Instalá y configurá todo (te hace 3 preguntas)
npx -y @tyconsa/[email protected] setup

# 2. Verificá que todo esté en orden (diagnóstico local, offline)
npx -y @tyconsa/[email protected] doctor

setup instala el skill, te pregunta la dirección de tu ambiente y tus credenciales, guarda el ambiente en ~/.bizuit/bizuit.config.json y registra el servidor en los clientes que encuentre instalados (Claude Code y Claude Desktop). La contraseña no se ve al tipearla y no se puede pasar por parámetro, para que no quede en el historial de la terminal.

Si tu cliente no es ninguno de esos dos, setup imprime el bloque de configuración para pegar a mano en la config de usuario de tu cliente MCP — nunca en el .mcp.json del proyecto, donde las credenciales terminarían commiteadas.

Un operador puede pre-cargar todo salvo la contraseña: setup --env-name qa --url https://mi-ambiente.example.com --username sofia

Tu contraseña queda guardada en texto plano en la configuración de usuario de tu cliente de IA: es la única forma en que el servidor puede usarla.

doctor en verde (exit 0) confirma la salud de la instalación: Node soportado, paquete íntegro y skill instalado. Que las credenciales aparezcan como "no configurada" es sólo informativo y no afecta el verde (viven en la config MCP de usuario, no en la terminal).

Guías completas por sistema operativo

Cada guía te lleva de una máquina limpia a doctor verde, con troubleshooting real (proxy corporativo, Node desactualizado, cache de npx). Viajan dentro del paquete, en dist/docs/:

• Windows — docs/instalacion-windows.md (incluye PowerShell execution policy)
• macOS — docs/instalacion-macos.md
• Linux — docs/instalacion-linux.md

Licencia

PolyForm Internal Use License 1.0.0 — Copyright 2026 TYCON S.A. Podés usar este software para las operaciones internas de tu empresa y adaptarlo para ese mismo uso; no podés distribuirlo, sublicenciarlo ni transferirlo. El texto completo, que es el que rige, está en LICENSE.md.