clio mcp for creatio

Introducción

La interfaz de línea de comandos clio es la utilidad para integrar la plataforma Creatio con herramientas de desarrollo y CI/CD.

Pruebe clio-explorer, una extensión de Visual Studio Code para clio! Esta extensión proporciona una interfaz de usuario sobre los comandos de clio.

Instalación y características

Requisito previo: clio requiere el .NET SDK (o, como mínimo, tanto el runtime de .NET como el runtime compartido de ASP.NET Core — Microsoft.AspNetCore.App). El SDK incluye el framework compartido de ASP.NET Core, por lo que las instalaciones basadas en SDK no necesitan nada adicional. Las instalaciones solo con runtime que incluyen solo el runtime base de .NET (Microsoft.NETCore.App) sin ASP.NET Core — por ejemplo, agentes CI mínimos — no son compatibles: clio hace referencia al framework compartido de ASP.NET Core (usado por clio mcp-http) para todos los comandos, por lo que fallará al iniciar con un error de "framework no encontrado" cuando ASP.NET Core esté ausente.

Windows

Para registrar clio como herramienta global, ejecute el comando:

dotnet tool install clio

puede registrar clio para todos los usuarios:

dotnet tool install clio -g

Para anular el registro de clio como herramienta global, ejecute el comando:

dotnet tool uninstall clio

o para todos los usuarios:

dotnet tool uninstall clio -g

Puede ver más información en Resumen de herramientas globales de .NET Core.

Menú contextual

clio register

https://user-images.githubusercontent.com/26967647/169416137-351674ca-0bd2-44f1-83af-df4557bd02fd.mp4

clio unregister

MacOS / Linux

1. Descargue .net 8 para Mac/Linux

2. Registre clio como herramienta global, con el comando:

dotnet tool install clio

Puede ver más información en Resumen de herramientas globales de .NET Core.

Ejecute el comando en la terminal para verificar el éxito

clio help

Ayuda y ejemplos

Para mostrar los comandos disponibles use:

clio help

Para mostrar la ayuda de un comando use:

clio <COMMAND_NAME> --help

Ejecutar con Docker

Compilar

docker build -f ./install/Dockerfile -t clio .

Ejecutar

docker run -it --rm clio help
docker run -it --rm clio reg-web-app -help

Referencia de comandos

Explorar comandos de clio

Contribuciones

Consulte CONTRIBUTING.md para la configuración de compilación, objetivos de prueba, estilo de código y flujo de trabajo de PR.

Servidor MCP

Clio admite el Protocolo de Contexto de Modelo (MCP) para la integración con agentes de código de IA.

Requisitos previos

Instale clio como una herramienta global de .NET (consulte Instalación arriba), luego verifique:

clio mcp-server --help

Registro en agentes de código de IA

Todos los agentes usan transporte stdio con el mismo comando: clio mcp-server.

Claude Code

claude mcp add clio -- clio mcp-server

O agregue a .claude/settings.json en su proyecto (o ~/.claude/settings.json globalmente):

{
  "mcpServers": {
    "clio": {
      "command": "clio",
      "args": ["mcp-server"],
      "type": "stdio"
    }
  }
}

GitHub Copilot (VS Code)

Abra la Paleta de Comandos (Ctrl+Shift+P / Cmd+Shift+P) y ejecute MCP: Add Server, luego siga el flujo guiado.

Alternativamente, agregue a .vscode/mcp.json manualmente:

{
  "servers": {
    "clio": {
      "type": "stdio",
      "command": "clio",
      "args": ["mcp-server"]
    }
  }
}

GitHub Copilot CLI

Dentro de una sesión de Copilot CLI, ejecute el comando interactivo:

/mcp add

Luego siga el flujo guiado para registrar un servidor stdio con el comando clio y el argumento mcp-server.

Alternativamente, agregue a ~/.copilot/mcp-config.json (global) o .mcp.json (raíz del proyecto) manualmente:

{
  "servers": {
    "clio": {
      "type": "stdio",
      "command": "clio",
      "args": ["mcp-server"]
    }
  }
}

Codex CLI

codex mcp add clio -- clio mcp-server

Alternativamente, agregue a ~/.codex/config.toml manualmente:

[mcp_servers.clio]
command = "clio"
args = ["mcp-server"]

Pruebas con MCP Inspector

npx @modelcontextprotocol/inspector dotnet run --project ~/Projects/clio/clio mcp-server

O configure manualmente:

• Comando: dotnet
• Argumentos: run --project /path/to/clio/clio mcp-server
• Tipo de transporte: STDIO

Esto abre una interfaz de navegador para probar las herramientas MCP.

Herramientas MCP disponibles

list-pages - Listar páginas de Freedom UI

• packageName (opcional) - Filtrar por paquete
• searchPattern (opcional) - Filtrar por patrón de nombre
• limit (opcional) - Resultados máximos (predeterminado: 50)
• environmentName / uri+login+password - Conexión

get-page - Obtener el cuerpo del esquema de la página

• schemaName (obligatorio) - Nombre del esquema de la página
• environmentName / uri+login+password - Conexión

update-page - Actualizar el cuerpo de la página (Destructivo)

• schemaName (obligatorio) - Nombre del esquema de la página
• body (obligatorio) - Nuevo cuerpo JSON
• dryRun (opcional) - Solo validar
• environmentName / uri+login+password - Conexión

install-application - Instalar paquete de aplicación

Generación de solución de espacio de trabajo (.slnx)

A partir de septiembre de 2025, el comando createw genera un archivo de solución en formato .slnx. Todos los proyectos se agregan en orden ordenado por su ruta relativa, asegurando una estructura de solución estable y repetible.

• Archivo de solución: .solution/CreatioPackages.slnx
• Proyectos: siempre ordenados por ruta
• Comando: clio createw

Este cambio mejora la consistencia para CI/CD y control de versiones.