fattly

---

MCP（Claude、Cursor、VS Code）

このパッケージはMCP サーバーです。お使いのFATTLYアカウントを通じて、AIアシスタントがメディアを生成できるようにします。

オプションA — ホスト型（インストール不要、OAuthでサインイン）

クライアントをホスト型サーバーに接続します。npmもキーの貼り付けも不要です。ブラウザーでアクセスを承認するだけです。

https://fattly.app/api/mcp

Claudeでは、Settings → Connectors → Add custom connectorに進み、URLを貼り付けます。詳しいセットアップガイド：https://fattly.app/claude-mcp

オプションB — ローカル（npx、APIキーを使用）

1. fattly.appを開き、Dashboard → API keysからキーを作成します。
2. クライアントのMCP設定に以下を追加します。

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

AIエージェント（Cline、Claude Code、Cursor）を使ってインストールする場合は、llms-install.mdを指定してください。

ツール

21個のツールを利用できます。ホスト型サーバーと同じセットです（ローカルサーバーはキーを使ってすべての呼び出しをfattly.appに転送するため、パッケージを更新しなくても新しいツールが追加されます）。

ツール	機能	クレジット消費
広告スタジオ
fattly_generate_ad_video	UGC 動画広告：本物のようなAIクリエイターが、実際の音声付きでカメラに向かって商品を紹介します（手元だけのPOV／開封動画にも対応）	はい（約150）
fattly_generate_ad	商品写真から広告画像を作成します。スタイリングした商品シーン、または商品を持つクリエイターを生成します	はい（20）
fattly_create_avatar	広告用の、一貫性のある独自のAIクリエイターを作成します	はい（20）
fattly_list_ad_presets	広告のプリセット、シーン、クリエイターのアバター	いいえ（読み取り専用）
画像
fattly_generate_image	テキストからの画像生成と画像編集（複数画像の編集）	はい
fattly_upscale	画像をアップスケールします	はい
fattly_remove_background	背景のないきれいな切り抜きを作成します	はい
fattly_inpaint	プロンプトに合わせてマスクした領域を描き直します	はい
fattly_face_swap	顔を入れ替えます（SFW、使用する権利のある顔のみ）	はい
動画
fattly_generate_video	テキストからの動画生成、画像からの動画生成（Veo、Kling、Seedance…）	はい
fattly_video_status	レンダリング中の動画の状態を確認します	いいえ（読み取り専用）
fattly_animate_photo	静止写真に動きを付けます	はい
fattly_trend_video	写真とプリセットからトレンド風の動画を作成します	はい
fattly_edit_video	Draw-to-Edit：動画のマスクした領域をテキストで変更します	はい
fattly_actor_swap	既存の動画のクリエイターを入れ替えます	はい
音声
fattly_generate_audio	ナレーション（テキスト読み上げ）または音楽	はい
fattly_clone_voice	同意を得た音声を複製するか、保存済みの音声を再利用します	はい
fattly_transcribe	音声をタイムコード付きのセグメントでテキストに変換します	はい
アカウント
fattly_credits	現在のクレジット残高	いいえ（読み取り専用）
fattly_list_models	モデルとクレジットでの料金	いいえ（読み取り専用）
fattly_upload_image	写真（URL、base64、またはローカルファイル）を、編集／広告／画像からの動画生成ツール用のURLに変換します	いいえ

すべてのツールにMCPアノテーション（readOnlyHint、destructiveHint、idempotentHint）が付いているため、有料の呼び出しの前にクライアントが確認できます。生成に失敗した場合、クレジットは自動的に返金されます。コンテンツは職場で閲覧できる内容にしてください。

CLI

npm install -g fattly   # Node.js 18+
fattly login            # paste your gpx_live_… key

fattly credits
fattly models video

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

設定

変数	用途
FATTLY_API_KEY	API キー（fattly login の代替）
FATTLY_API_URL	API アドレスの上書き（デフォルトは https://fattly.app）

fattly login で保存されたキーは、所有者のみがアクセスできる権限で ~/.fattly/config.json に保存されます。

詳細

• ウェブサイト：https://fattly.app
• ウェブアプリではさらに多くの機能を利用できます：5 言語のリップシンク付き AI 吹き替え、バーチャル試着、Cinema Studio。
• 課題：https://github.com/industriesfatty-spec/fattly-mcp/issues

MIT © Fattly