qontinui-web-mcp

Servidor MCP (Model Context Protocol) para la plataforma web Qontinui. Permite a los asistentes de IA crear y gestionar configuraciones de automatización visual a través de la API de Qontinui.

Características

• Gestión de proyectos: Crear, leer, actualizar y eliminar proyectos

• Desarrollo de flujos de trabajo: Construir y modificar flujos de trabajo de automatización

• Gestión de estados: Definir estados de la interfaz de usuario con imágenes identificativas

• Importación/Exportación de configuración: Gestión completa de la configuración

• Sesiones de captura: Registrar acciones del usuario para el aprendizaje de flujos de trabajo

• Control de ejecución: Activar y supervisar ejecuciones de automatización

Related MCP server: Automatisch MCP Server

Instalación

cd qontinui-web-mcp
poetry install

Configuración

Establezca las variables de entorno para la API de Qontinui:

# Development (local)
export QONTINUI_API_URL="http://localhost:8000"

# Production (AWS)
export QONTINUI_API_URL="http://qontinui-prod-py.eba-km2u4s23.eu-central-1.elasticbeanstalk.com"

# Authentication (obtain from Qontinui web app)
export QONTINUI_ACCESS_TOKEN="your-jwt-token"
# OR use credentials
export QONTINUI_EMAIL="your-email@example.com"
export QONTINUI_PASSWORD="your-password"

Uso

Con Claude Desktop

Añada a su configuración de Claude Desktop (~/.claude/claude_desktop_config.json):

{
  "mcpServers": {
    "qontinui-web": {
      "command": "poetry",
      "args": ["run", "qontinui-web-mcp"],
      "cwd": "/path/to/qontinui-web-mcp",
      "env": {
        "QONTINUI_API_URL": "http://localhost:8000",
        "QONTINUI_EMAIL": "your-email@example.com",
        "QONTINUI_PASSWORD": "your-password"
      }
    }
  }
}

Con Claude Code

Añada al archivo .mcp.json de su proyecto:

{
  "mcpServers": {
    "qontinui-web": {
      "command": "poetry",
      "args": ["run", "qontinui-web-mcp"],
      "cwd": "/path/to/qontinui-web-mcp",
      "env": {
        "QONTINUI_API_URL": "http://localhost:8000"
      }
    }
  }
}

Herramientas disponibles

Autenticación

• auth_login - Autenticarse con correo electrónico/contraseña

• auth_status - Comprobar el estado de autenticación actual

• auth_logout - Borrar las credenciales almacenadas

Proyectos

• list_projects - Listar todos los proyectos accesibles

• create_project - Crear un nuevo proyecto

• get_project - Obtener detalles del proyecto

• update_project - Actualizar metadatos/configuración del proyecto

• delete_project - Eliminar un proyecto

Configuración

• export_configuration - Exportar la configuración del proyecto como JSON

• import_configuration - Importar configuración al proyecto

• validate_configuration - Validar la configuración sin importar

Flujos de trabajo

• create_workflow - Añadir flujo de trabajo al proyecto

• update_workflow - Modificar flujo de trabajo existente

• delete_workflow - Eliminar flujo de trabajo del proyecto

• list_workflows - Listar flujos de trabajo en el proyecto

Estados

• create_state - Definir estado de la interfaz de usuario con imágenes identificativas

• update_state - Modificar definición de estado

• delete_state - Eliminar estado del proyecto

• list_states - Listar estados en el proyecto

Imágenes

• add_image - Añadir imagen de patrón al proyecto

• list_images - Listar imágenes en el proyecto

• delete_image - Eliminar imagen del proyecto

Ejecución

• execute_workflow - Ejecutar flujo de trabajo en el ejecutor conectado

• get_execution_status - Comprobar el progreso de la ejecución

• cancel_execution - Detener el flujo de trabajo en ejecución

Desarrollo

# Install dependencies
poetry install

# Run tests
poetry run pytest

# Format code
poetry run ruff format src/

# Lint (includes import sorting via the `I` rule)
poetry run ruff check src/

# Type check
poetry run mypy src/

Puntos finales de la API

Este servidor MCP se comunica con la API de backend de Qontinui:

Licencia

Bajo la licencia GNU Affero General Public License v3.0 o posterior (AGPL-3.0-or-later). Consulte LICENSE para conocer los términos completos.