MCP로 AI 도우미에서 KwaFlux 다루기

시작하기 전에

• 같은 컴퓨터에 KwaFlux 1.0.8 이상이 설치되어 실행 중이어야 합니다.
• Node.js 18 이상이 설치되어 PATH에 있어야 합니다. 설치 파일에는 MCP 스크립트만 있고 Node.js 런타임은 없습니다.
• MCP를 지원하는 도우미 앱: Codex, Claude Code 또는 Claude Desktop, OpenClaw, DeepSeek(DSH), Hermes, Cursor 중 하나.

도우미 연결하기

1. KwaFlux에서 설정 → Agent(MCP)를 엽니다.
2. 해당 도우미용 스니펫을 그 MCP 설정에 복사합니다. kwaflux 항목만 추가하고 파일 전체를 바꾸지 마세요.
3. 도우미에서 MCP를 다시 불러오고, 쓰는 동안 KwaFlux를 켜 두세요.

도우미가 할 수 있는 일

• 앱 상태와 작업 목록을 읽고, 작업 진행 상황을 따라가며 완료를 기다립니다.
• 영상에 16개 모듈로 향상 내보내기를 등록합니다: 화질 복구, AI 색보정, 흔들림 보정, AI 슬로 모션, 디인터레이스, 스마트 크롭, 카툰화, 스케치 생성, 고정 스타일 변환, 얼굴 리라이팅, AI 뷰티 모듈 6개.
• 파일 포맷 변환, 미디어 파일 손상 점검과 복구.
• 링크를 조회하고 내려받습니다. 에이전트 다운로드는 설정에서 허용하기 전까지 꺼져 있고, 다운로드마다 채팅에서 본인 확인이 필요합니다.
• 작업 일시 정지, 재개, 취소, 재시도.

로그인과 플랜

• 상태 읽기, 파일 손상 점검, 작업 일시 정지·취소는 로그인 없이 됩니다.
• 앱과 마찬가지로 내보내기(향상 작업 포함), 변환, 파일 복구, 링크에서 파일 다운로드에는 로그인과 유료 플랜이 필요합니다. 이런 작업을 재개하거나 재시도할 때도 같습니다.
• 무료 1초, 3초, 5초 미리보기는 데스크톱 앱에 있으며 도우미가 만들지 않습니다.

파일과 연결

• 내보내기, 변환, 복구 결과는 원본 파일 옆에 저장됩니다. 다운로드는 지정한 기존 폴더에 저장됩니다.
• 이 컴퓨터의 경로만 받습니다. 네트워크 경로는 파일에 접근하기 전에 거부됩니다.
• 연결은 로컬 stdio입니다. 원격 URL도, OAuth도, Authenticate 버튼도 없습니다. Windows에서는 현재 사용자 전용 명명된 파이프를, Mac에서는 내 계정만 열 수 있는 소켓을 씁니다.
• 새 작업 등록은 분당 약 10개로 제한됩니다.