Skip to main content
Glama
Qontinui Web MCP Server

Qontinui Web MCP Server

by qontinui

qontinui-web-mcp

Qontinui 웹 플랫폼을 위한 MCP(Model Context Protocol) 서버입니다. AI 어시스턴트가 Qontinui API를 통해 시각적 자동화 구성을 생성하고 관리할 수 있도록 합니다.

기능

  • 프로젝트 관리: 프로젝트 생성, 읽기, 업데이트, 삭제

  • 워크플로우 개발: 자동화 워크플로우 구축 및 수정

  • 상태 관리: 식별 이미지를 사용하여 UI 상태 정의

  • 구성 가져오기/내보내기: 전체 구성 관리

  • 캡처 세션: 워크플로우 학습을 위한 사용자 작업 기록

  • 실행 제어: 자동화 실행 트리거 및 모니터링

Related MCP server: Automatisch MCP Server

설치

cd qontinui-web-mcp
poetry install

구성

Qontinui API에 대한 환경 변수를 설정합니다:

# 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"

사용법

Claude Desktop 사용 시

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"
      }
    }
  }
}

Claude Code 사용 시

프로젝트의 .mcp.json에 추가합니다:

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

사용 가능한 도구

인증

  • auth_login - 이메일/비밀번호로 인증

  • auth_status - 현재 인증 상태 확인

  • auth_logout - 저장된 자격 증명 삭제

프로젝트

  • list_projects - 액세스 가능한 모든 프로젝트 나열

  • create_project - 새 프로젝트 생성

  • get_project - 프로젝트 세부 정보 가져오기

  • update_project - 프로젝트 메타데이터/구성 업데이트

  • delete_project - 프로젝트 삭제

구성

  • export_configuration - 프로젝트 구성을 JSON으로 내보내기

  • import_configuration - 프로젝트로 구성 가져오기

  • validate_configuration - 가져오기 없이 구성 유효성 검사

워크플로우

  • create_workflow - 프로젝트에 워크플로우 추가

  • update_workflow - 기존 워크플로우 수정

  • delete_workflow - 프로젝트에서 워크플로우 제거

  • list_workflows - 프로젝트의 워크플로우 나열

상태

  • create_state - 식별 이미지를 사용하여 UI 상태 정의

  • update_state - 상태 정의 수정

  • delete_state - 프로젝트에서 상태 제거

  • list_states - 프로젝트의 상태 나열

이미지

  • add_image - 프로젝트에 패턴 이미지 추가

  • list_images - 프로젝트의 이미지 나열

  • delete_image - 프로젝트에서 이미지 제거

실행

  • execute_workflow - 연결된 러너에서 워크플로우 실행

  • get_execution_status - 실행 진행 상황 확인

  • cancel_execution - 실행 중인 워크플로우 중지

개발

# 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/

API 엔드포인트

이 MCP 서버는 Qontinui 백엔드 API와 통신합니다:

환경

URL

개발

http://localhost:8000

프로덕션

http://qontinui-prod-py.eba-km2u4s23.eu-central-1.elasticbeanstalk.com

라이선스

GNU Affero General Public License v3.0 이상(AGPL-3.0-or-later)에 따라 라이선스가 부여됩니다. 전체 약관은 LICENSE를 참조하십시오.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers