La CLI de Decision Gate es la interfaz de comandos orientada al usuario para la operación del servidor MCP, herramientas del cliente MCP, flujos de trabajo de runpack, utilidades de autoría y ayudantes de registro/documentación. Es parte del repositorio OSS de Decision Gate y se envía junto con los crates principales.
Lo que cubre
- Ejecutando el servidor MCP con una configuración local.
- Validando la configuración, los insumos de autoría y los artefactos de runpack.
- Acceso de cliente MCP a herramientas y recursos a través de HTTP, SSE o stdio.
- Flujos de trabajo de descubrimiento de proveedores y registro de esquemas.
- Búsqueda de documentación y lectura de recursos a través de MCP.
- Evaluación de interoperabilidad para comprobaciones de herramientas de extremo a extremo.
- Envolturas para la generación/verificación de contratos y SDK.
Forma actual (a partir del 1 de febrero de 2026)
Los nombres y grupos de comandos son estables y cubren toda la superficie de la herramienta MCP, además de los envoltorios de contrato y SDK. Utilice decision-gate --help para ver las banderas autorizadas y específicas de la versión.
Flujos de trabajo de inicio rápido
Servir con una configuración preestablecida
decision-gate serve --config configs/presets/default-recommended.toml
Para el desarrollo local sin un binario preconstruido:
cargo run -p decision-gate-cli -- serve --config configs/presets/default-recommended.toml
Validar o normalizar la entrada de autoría
decision-gate authoring validate --input examples/scenario.ron --format ron
decision-gate authoring normalize --input examples/scenario.ron --format ron \
--output examples/scenario.json
Exportación y verificación de Runpack
decision-gate runpack export --help
decision-gate runpack verify --help
Inspeccionar herramientas y documentos de MCP
decision-gate mcp tools list --transport http --endpoint http://127.0.0.1:8080/rpc
decision-gate docs search --transport http --endpoint http://127.0.0.1:8080/rpc --query "runpack"
Superficie de comando (resumen)
Esta referencia relaciona cada área de la CLI con su familia estable de comandos y su propósito operativo.
| Área | Comando | Propósito |
|---|---|---|
| Servidor | serve | Ejecutar el servidor MCP de Decision Gate a partir de una configuración. |
| Configuración | config validate | Validar decision-gate.toml y salir con estado. |
| Autorización | authoring validate | Validar la entrada de ScenarioSpec (RON/JSON). |
| Autorización | authoring normalize | Normalizar a JSON canónico (RFC 8785). |
| Paquetes de ejecución | runpack export | Exportar un paquete de ejecución para uso fuera de línea. |
| Paquetes de ejecución | runpack verify | Verificar la integridad del paquete de ejecución fuera de línea. |
| Proveedores | provider list | Listar proveedores y verificaciones configurados. |
| Proveedores | provider contract get | Obtener el JSON del contrato del proveedor. |
| Proveedores | provider check-schema get | Obtener los metadatos del esquema de verificación del proveedor. |
| Esquemas | schema register | Registrar un registro de esquema. |
| Esquemas | schema list | Listar esquemas para un inquilino/espacio de nombres. |
| Esquemas | schema get | Obtener esquema por id/version. |
| Documentación | docs search | Buscar secciones de documentación. |
| Documentación | docs list | Listar recursos de documentación. |
| Documentación | docs read | Leer un recurso de documentación URI. |
| Interoperabilidad | interop eval | Evaluar una ejecución de interoperabilidad contra un servidor MCP. |
| Herramientas MCP | mcp tools list | Listar definiciones de herramientas MCP. |
| Herramientas MCP | mcp tools call | Llamar a una herramienta MCP por nombre. |
| Recursos MCP | mcp resources list | Listar recursos MCP. |
| Recursos MCP | mcp resources read | Leer un recurso MCP por URI. |
| Herramientas tipadas MCP | mcp tool <tool> | Envoltura tipada para cada herramienta MCP. |
| Contrato | contract generate | Generar artefactos de contrato. |
| Contrato | contract check | Verificar artefactos de contrato. |
| SDK | sdk generate | Generar artefactos SDK/OpenAPI. |
| SDK | sdk check | Verificar artefactos SDK/OpenAPI. |
Opciones del cliente MCP
--transport http|sse|stdioselecciona el transporte MCP.--endpointestablece la URL HTTP/SSE;--stdio-commandmás args/env configura stdio.--bearer-token,--client-subject,--auth-profiley--auth-configcontrolan la autenticación.--jsono--inputsuministra cargas útiles de la herramienta;--no-validateomite las comprobaciones de esquema.
Envoltorios de herramientas MCP tipadas
Utilice decision-gate mcp tool <name> para envolturas tipadas en toda la superficie de la herramienta:
- Ciclo de vida del escenario:
scenario-define,scenario-start,scenario-status,scenario-next,scenario-submit,scenario-trigger,scenarios-list - Evidencia y runpacks:
evidence-query,runpack-export,runpack-verify,precheck - Proveedores y esquemas:
providers-list,provider-contract-get,provider-check-schema-get,schemas-register,schemas-list,schemas-get - Documentación:
decision-gate-docs-search
Selección de idioma
Los catálogos actuales de la CLI se envían para EN (inglés) y CA (catalán), con idiomas adicionales planeados. Utilice --lang en|ca o configure DECISION_GATE_LANG. La salida en idiomas distintos del inglés incluye un aviso de traducción automática.
Modelo de seguridad y límites
- Las entradas son validadas y fallan de manera controlada en caso de errores.
- Las lecturas de archivos y las cargas útiles de MCP están limitadas en tamaño para evitar el agotamiento de cargas útiles no confiables.
- Las entradas de la herramienta MCP están validadas por esquema de forma predeterminada (utilice
--no-validatesolo cuando sea necesario). - Las vinculaciones HTTP/SSE que no son de bucle inverso requieren una aceptación explícita en la CLI, además de TLS y autenticación no local.
- Las salidas legibles por máquina se configuran por defecto en JSON canónico; los comandos seleccionados ofrecen formatos de texto/markdown.