AI 튜토리얼

Muse4AI로 AI 에이전트를 Muse에 연결하기

Windows에 Muse4AI를 설치하고 MCP, OAuth 또는 REST를 통해 AI 에이전트를 연결한 후 로컬 컴퓨터에서 Muse 이미지 및 동영상 작업을 제출하는 방법을 알아보세요. 이 가이드에서는 작업 관리, 보안 제어, 개발 명령어 및 실용적인 사용 팁도 다룹니다.

2026년 11월 4일약 11분 소요

Muse4AI란 무엇인가요?

Muse4AI는 로그인된 Muse 세션을 AI 에이전트가 조작할 수 있도록 해 주는 Windows용 로컬 애플리케이션입니다. ChatGPT, Claude, Cursor, Codex, n8n 및 사용자 지정 스크립트와 같은 도구를 REST, MCP 또는 OAuth를 통해 Muse에 연결합니다.

이 애플리케이션은 사용자의 PC에서 실행되며 로컬 API를 http://127.0.0.1:47821에서 제공합니다. 요청은 Muse4AI 클라우드 서비스를 통해 중계되지 않습니다. 결과, API 키, OAuth 토큰, 기록 및 로컬 라이브러리는 %APPDATA%\MuseStudio에 보관됩니다.

주요 기능

이미지 및 동영상 생성: 텍스트 프롬프트를 제출하고 필요에 따라 참조 사진을 포함하며 계정을 선택한 후 대기열에서 작업을 모니터링할 수 있습니다.
대화 이어가기: 채팅 작업은 대화 ID를 반환하므로 에이전트가 맥락을 유지하고 아이디어를 반복해서 발전시키며 파일을 첨부할 수 있습니다.
완성된 동영상 확장: 생성된 클립을 최대 6단계까지, 체인당 약 60초까지 이어서 확장할 수 있습니다.
자연어로 동영상 편집: MP4 파일을 첨부하고 기존 편집 타임라인을 설정하지 않아도 원하는 변경 사항을 설명할 수 있습니다.
REST 또는 MCP 사용: MCP 도구를 통해 에이전트 소프트웨어를 연결하거나 로컬 REST API를 직접 호출할 수 있습니다.
안전한 인증: 범위가 지정된 API 키를 사용하거나 6자리 승인 코드로 OAuth 절차를 완료할 수 있습니다.
로컬에서 작업 관리: 데스크톱 애플리케이션에서 대기 중인 작업, 미리 보기, 생성된 에셋, 연결 설정 및 검색 가능한 기록을 검토할 수 있습니다.

요구 사항 및 주요 제한 사항

패키지 애플리케이션은 Windows 10 또는 Windows 11용입니다. 소스에서 프로젝트를 실행하는 경우 Node.js 22 이상도 필요합니다.

Muse4AI는 공식 제품과 무관한 독립 프로젝트이며 Meta Platforms, Inc.와 제휴하거나 공식 승인 또는 후원을 받지 않습니다. 자체 Muse 세션을 자동화하므로 사용하기 전에 관련 서비스 약관을 확인하세요. Muse의 변경 사항은 자동화에도 영향을 줄 수 있습니다.

패키지된 macOS 및 Linux 버전은 현재 테스트되거나 제공되지 않습니다. Muse4AI에는 클라우드 계정, 원격 측정 서버 또는 구독이 없습니다.

Windows에 Muse4AI 설치

옵션 1: 설치 프로그램 사용

Muse4AI 다운로드 페이지를 엽니다.
Windows 설치 프로그램을 다운로드하고 실행합니다.
Windows에서 애플리케이션이 서명되지 않았다고 경고하면 추가 정보를 선택한 다음 실행을 선택합니다.
Muse4AI를 열고 계정으로 이동합니다.
Muse 계정을 추가하고 해당 세션에 로그인되어 있는지 확인합니다.

옵션 2: 소스에서 실행

저장소를 복제하거나 다운로드하고 루트 디렉터리에서 터미널을 연 다음 다음 명령을 실행합니다.

cd desktop
npm install
npm run build
npm start

시작되면 데스크톱 인터페이스가 열리고 로컬 API를 http://127.0.0.1:47821에서 사용할 수 있습니다.

MCP 및 OAuth로 AI 에이전트 연결

MCP는 호환되는 에이전트 클라이언트에 연결하는 가장 직접적인 방법입니다. Muse4AI에서 설정 → API 및 에이전트를 엽니다. 애플리케이션에서 바로 사용할 수 있는 연결 스니펫을 제공합니다. 기본 MCP 구성은 클라이언트를 다음 로컬 엔드포인트로 지정합니다.

{
  "mcpServers": {
    "muse4ai": {
      "url": "http://127.0.0.1:47821/mcp"
    }
  }
}

이 구성을 에이전트에서 사용하는 MCP 클라이언트에 추가합니다. OAuth 인증 중 Muse4AI는 6자리 코드를 표시합니다. 연결을 승인하고 토큰을 발급하려면 동의 페이지에 해당 코드를 입력합니다.

OAuth 서버는 인증 메타데이터를 게시하고 동적 클라이언트 등록을 지원하며 자체 토큰에 서명합니다. 로컬 MCP URL만 알고 있어서는 액세스를 승인할 수 없습니다. 사용자가 데스크톱 애플리케이션에 표시된 코드도 입력해야 하기 때문입니다.

나중에 액세스 권한을 제거하려면 설정 → API 및 에이전트 → 연결된 앱을 열고 관련 애플리케이션을 취소합니다.

REST API를 통한 연결

HTTP를 직접 사용하는 스크립트와 서비스의 경우 설정 → API 및 에이전트에서 API 키를 생성합니다. Muse4AI 키는 msk_로 시작합니다. Authorization 헤더에 키를 bearer 토큰으로 전송합니다.

동영상 생성 작업 제출

다음 요청은 텍스트 프롬프트를 사용해 동영상 작업을 생성합니다.

curl -X POST http://127.0.0.1:47821/v1/jobs \
  -H "Authorization: Bearer msk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"video","prompt":"a coffee cup on an oak desk, warm morning light"}'

msk_YOUR_KEY를 데스크톱 애플리케이션에서 생성한 키로 바꿉니다. 제출한 작업은 앱 내 대기열에 표시되며, 여기서 상태를 확인하고 결과를 살펴볼 수 있습니다.

사용 가능한 REST 작업 및 MCP 도구

POST /v1/jobs는 이미지 또는 동영상 작업을 생성합니다. 이에 해당하는 MCP 도구는 muse_generate입니다.
kind: "chat"과 함께 POST /v1/jobs를 사용하면 채팅 작업을 생성합니다. 이에 해당하는 MCP 도구는 muse_chat입니다.
GET /v1/jobs는 REST를 통해 작업 목록을 표시합니다. MCP 클라이언트에서는 muse_list_jobs를 사용할 수 있습니다.
GET /v1/jobs/{id}는 특정 작업을 조회합니다. MCP에서는 muse_get_job이 이에 해당합니다.
POST /v1/jobs/{id}/cancel은 작업을 취소합니다. MCP 도구는 muse_cancel_job입니다.
POST /v1/assets/{id}/extend 및 POST /v1/conversations/{id}/extend는 동영상 확장을 지원합니다. 관련 MCP 도구로는 muse_extend_video와 muse_get_extend가 있습니다.
GET /v1/status 및 GET /v1/health는 서비스 정보를 보고합니다. MCP 클라이언트에서는 muse_status를 사용할 수 있습니다.

완전한 기계 판독용 API 계약은 실행 중인 애플리케이션의 GET /v1/openapi.json에서 확인할 수 있습니다. Markdown 문서를 선호하는 에이전트는 llms.txt를 읽을 수 있습니다.

기본 에이전트 워크플로

이미지 또는 동영상 생성

Muse4AI가 실행 중이고 Muse 계정을 Accounts에서 사용할 수 있는지 확인합니다.
연결된 에이전트에 이미지 또는 동영상 생성을 요청하고 명확한 프롬프트를 제공합니다.
필요한 경우 참조 사진을 포함하고 사용할 구성 계정을 지정합니다.
대기열을 열어 작업을 추적하고 상태를 확인한 뒤 결과를 미리 봅니다.
완료된 작업은 로컬 라이브러리에서 확인합니다.

채팅 이어가기

muse_chat을 사용하거나 kind: "chat"으로 REST 작업을 생성합니다. 반환된 대화 ID를 보관하면 별도의 대화를 시작하지 않고 에이전트가 같은 대화를 계속 진행할 수 있습니다.

완료된 클립 확장

동영상이 완료되면 에셋 또는 대화 확장 엔드포인트를 사용하거나 MCP 에이전트에 muse_extend_video 호출을 요청합니다. 확장본은 원본 클립이 생성된 대화에 유지됩니다. 하나의 체인에는 최대 6개의 확장 단계가 포함될 수 있으며 약 60초까지 늘릴 수 있습니다.

기존 동영상 편집

MP4 파일을 첨부하고 원하는 변경 사항을 자연어로 설명합니다. Muse4AI는 타임라인이나 렌더링 설정 없이 Muse 세션을 통해 요청을 처리합니다.

고급 팁

적절한 인증 방식 사용

MCP 클라이언트가 대화형 인증을 지원하고 키를 복사하고 싶지 않다면 OAuth를 선택합니다. 명령줄 도구, 로컬 자동화, bearer 토큰을 전송하는 시스템에는 API 키를 선택합니다. API 키에는 범위와 속도 제한이 적용되며 개별적으로 폐기할 수 있습니다.

로컬 자격 증명 보호

소스 제어, 스크린샷, 공유 프롬프트 또는 셸 기록에 msk_ 키를 게시하지 마세요. 가능한 경우 클라이언트마다 별도의 키를 만든 다음 액세스가 더 이상 필요하지 않을 때 영향을 받은 키만 폐기합니다.

대화 ID 보존

통합을 구축할 때 채팅 및 생성 워크플로에서 반환된 대화 ID를 저장합니다. 대화 ID를 재사용하면 에이전트가 대화를 이어가고, 맥락에 맞게 파일을 첨부하며, 원래 대화에서 동영상을 확장할 수 있습니다.

API 계약 확인

요청 및 응답 필드를 추측하는 대신 실행 중인 애플리케이션에서 http://127.0.0.1:47821/v1/openapi.json을 읽습니다. 이는 타입이 지정된 클라이언트를 생성하거나 자동화 플랫폼을 구성할 때 특히 유용합니다.

작업 제출 전 상태 모니터링

더 긴 워크플로를 시작하기 전에 GET /v1/status, GET /v1/health 또는 muse_status MCP 도구를 사용하여 로컬 서비스를 확인합니다. 목록 및 조회 작업으로 작업을 모니터링하고 더 이상 필요하지 않은 작업은 취소합니다.

프로젝트 개발 및 테스트

저장소는 데스크톱 애플리케이션, 공유 콘텐츠 및 에이전트 지침을 분리합니다.

desktop/에는 메인 프로세스, 렌더러, REST, MCP 및 OAuth API, 테스트와 설치 프로그램 코드가 포함되어 있습니다.
content/에는 애플리케이션과 웹사이트가 공유하는 가이드, 에이전트 및 사용 사례 텍스트가 포함되어 있습니다.
agent-kit/에는 에이전트가 도구 사용법을 학습하기 위해 읽을 수 있는 Muse4AI Skill이 포함되어 있습니다.

desktop 디렉터리에서 프로젝트 검사와 Windows 패키징 명령을 실행합니다.

cd desktop
npm test
npm run typecheck
npm run package:win

테스트 명령은 저장소의 테스트 스위트를 실행하고, npm run typecheck는 엄격한 TypeScript를 검사하며, npm run package:win은 Windows ZIP 및 설치 프로그램 입력 파일을 준비합니다.

결론

Muse4AI는 REST, MCP 또는 OAuth를 이해하는 AI 에이전트와 Muse를 연결하는 로컬 브리지를 제공합니다. Windows 애플리케이션을 실행하고 Muse 계정을 연결하면 Muse4AI 클라우드 중개자 없이 미디어를 생성하고, 대화를 유지하며, 동영상을 확장하고, 자연어 요청으로 MP4 파일을 편집하고, 결과를 관리할 수 있습니다.

추가 스크린샷과 안내는 공식 가이드에서 확인할 수 있습니다. Muse4AI는 MIT 라이선스로 제공됩니다.