clio mcp for creatio

Servidor MCP de código aberto e em rápido crescimento para desenvolvimento na plataforma Creatio

Documentação

Introdução

A Interface de Linha de Comando clio é o utilitário para integração da plataforma Creatio com ferramentas de desenvolvimento e CI/CD.

Experimente o clio-explorer, uma extensão do Visual Studio Code para clio! Esta extensão fornece uma interface de usuário sobre os comandos do clio.

Instalação e recursos

Pré-requisito: o clio requer o .NET SDK (ou, no mínimo, tanto o runtime .NET quanto o runtime compartilhado do ASP.NET Core — Microsoft.AspNetCore.App). O SDK inclui o framework compartilhado do ASP.NET Core, portanto, instalações baseadas em SDK não precisam de nada extra. Instalações somente com runtime que incluem apenas o runtime .NET base (Microsoft.NETCore.App) sem ASP.NET Core — por exemplo, agentes mínimos de CI — não são suportadas: o clio referencia o framework compartilhado do ASP.NET Core (usado por clio mcp-http) para todos os comandos, portanto, falhará ao iniciar com um erro de "framework não encontrado" quando o ASP.NET Core estiver ausente.

Windows

Para registrar o clio como ferramenta global, execute o comando:

dotnet tool install clio

você pode registrar o clio para todos os usuários:

dotnet tool install clio -g

Para cancelar o registro do clio como ferramenta global, execute o comando:

dotnet tool uninstall clio

ou para todos os usuários:

dotnet tool uninstall clio -g

Mais informações você pode ver em Visão geral das Ferramentas Globais do .NET Core.

Menu de contexto

clio register

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

clio unregister

MacOS / Linux

Baixe o .net 8 para Mac/Linux
Registre o clio como ferramenta global, com o comando:

dotnet tool install clio

Mais informações você pode ver em Visão geral das Ferramentas Globais do .NET Core.

Execute o comando no terminal para verificar o sucesso

clio help

Ajuda e exemplos

Para exibir os comandos disponíveis, use:

clio help

Para exibir a ajuda de um comando, use:

clio <COMMAND_NAME> --help

Executar com docker

Build

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

Executar

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

Referência de Comandos

Explore os comandos do clio

Contribuindo

Veja CONTRIBUTING.md para configuração de build, alvos de teste, estilo de código e fluxo de trabalho de PR.

Servidor MCP

O Clio suporta o Model Context Protocol (MCP) para integração com agentes de código de IA.

Pré-requisitos

Instale o clio como uma ferramenta global .NET (veja Instalação acima) e depois verifique:

clio mcp-server --help

Registro em Agentes de Código de IA

Todos os agentes usam transporte stdio com o mesmo comando: clio mcp-server.

Claude Code

claude mcp add clio -- clio mcp-server

Ou adicione ao .claude/settings.json no seu projeto (ou ~/.claude/settings.json globalmente):

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

GitHub Copilot (VS Code)

Abra a Paleta de Comandos (Ctrl+Shift+P / Cmd+Shift+P) e execute MCP: Adicionar Servidor, depois siga o fluxo guiado.

Alternativamente, adicione ao .vscode/mcp.json manualmente:

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

GitHub Copilot CLI

Dentro de uma sessão do Copilot CLI, execute o comando interativo:

/mcp add

Depois siga o fluxo guiado para registrar um servidor stdio com o comando clio e o argumento mcp-server.

Alternativamente, adicione ao ~/.copilot/mcp-config.json (global) ou .mcp.json (raiz do projeto) manualmente:

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

Codex CLI

codex mcp add clio -- clio mcp-server

Alternativamente, adicione ao ~/.codex/config.toml manualmente:

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

Testando com o MCP Inspector

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

Ou configure manualmente:

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

Isso abre uma interface de navegador para testar as ferramentas MCP.

Ferramentas MCP Disponíveis

list-pages - Lista páginas do Freedom UI

packageName (opcional) - Filtrar por pacote
searchPattern (opcional) - Filtrar por padrão de nome
limit (opcional) - Máximo de resultados (padrão: 50)
environmentName / uri+login+password - Conexão

get-page - Obtém o corpo do esquema da página

schemaName (obrigatório) - Nome do esquema da página
environmentName / uri+login+password - Conexão

update-page - Atualiza o corpo da página (Destrutivo)

schemaName (obrigatório) - Nome do esquema da página
body (obrigatório) - Novo corpo JSON
dryRun (opcional) - Somente validar
environmentName / uri+login+password - Conexão

install-application - Instala o pacote do aplicativo

Geração de Solução de Workspace (.slnx)

A partir de setembro de 2025, o comando createw gera um arquivo de solução no formato .slnx. Todos os projetos são adicionados em ordem classificada pelo seu caminho relativo, garantindo uma estrutura de solução estável e repetível.

Arquivo de solução: .solution/CreatioPackages.slnx
Projetos: sempre classificados por caminho
Comando: clio createw

Esta mudança melhora a consistência para CI/CD e controle de versão.

Login SSO

Para um site Creatio somente com SSO, registre um cliente OAuth público com authorization_code e refresh_token, exija PKCE S256, e registre um redirecionamento de loopback como http://127.0.0.1:<port>/callback (ou forneça um redirecionamento HTTPS para o modo de colar de volta). Depois execute:

clio reg-web-app work -u https://work.creatio.com --clientId <client-id> --auth-flow authorization-code --redirect-port 37319
clio login -e work

O fluxo de código de autorização carrega as permissões do próprio usuário conectado, ao contrário de client_credentials, e é destinado ao uso interativo contra sites SSO corporativos. Use clio auth-status -e work em automação; quando ele retornar não-zero, peça a um humano para executar clio login uma vez. Os tokens são armazenados fora de appsettings.json no cache de tokens do clio somente do proprietário.