fattly — FATTLY CLI

터미널에서 AI 이미지, 비디오, 보이스오버, 아바타 및 UGC 광고를 생성하세요 — 또는 MCP를 통해 Claude 및 Cursor 같은 AI 어시스턴트에서도 생성할 수 있습니다.

30개 이상의 AI 모델 · fattly.app 계정의 크레딧을 사용합니다.

설치

npm install -g fattly

(Node.js 18+ 필요.)

Related MCP server: mcp-media-engine

시작하기

1. 사이트를 엽니다 → Dashboard → API keys → 키를 생성합니다.

2. 터미널에서 로그인합니다:

fattly login
# paste your gpx_live_… key

예제

fattly credits
fattly models

fattly generate "astronaut cat on Mars" --model nano-banana-2 --out cat.png
fattly video "ocean waves at sunset" --model kling-3-standard --out waves.mp4
fattly audio "Welcome to FATTLY" --voice Rachel --out voice.mp3
fattly audio "calm ambient" --music --seconds 30 --out music.mp3

MCP (Claude, Cursor)

이 패키지는 MCP 서버이기도 합니다 — AI 어시스턴트가 FATTLY를 통해 생성할 수 있게 해줍니다. 연결 방법은 두 가지입니다.

옵션 A — 호스팅 (설치 불필요, OAuth로 로그인)

가장 빠른 방법: Claude를 호스팅된 FATTLY MCP에 직접 연결하세요. npm도, 붙여넣을 키도 필요 없습니다 — 브라우저에서 액세스 승인만 하면 됩니다.

Claude에서 → Settings → Connectors → Add custom connector로 이동하여 이 URL을 사용하세요:

https://fattly.app/api/mcp

Claude가 로그인을 자동으로 감지하고 fattly.app에서 동의 페이지를 엽니다. 이를 승인하면 도구가 준비됩니다. fattly.app 계정과 크레딧을 사용합니다.

옵션 B — 로컬 (npx, API 키 사용)

클라이언트의 MCP 구성에 다음을 추가하세요:

{
  "mcpServers": {
    "fattly": {
      "command": "npx",
      "args": ["-y", "fattly", "mcp"],
      "env": {
        "FATTLY_API_KEY": "gpx_live_YOUR_KEY"
      }
    }
  }
}

사용 가능한 도구: fattly_credits, fattly_list_models, fattly_generate_image, fattly_generate_video, fattly_generate_audio.

API 주소

기본적으로 CLI/MCP는 로그인 시 설정된 주소(또는 기본 주소)에 연결됩니다. 로그인 시(fattly login --url https://your-domain) 또는 FATTLY_API_URL 환경 변수로 재정의할 수 있습니다.