Ssemble AI Clipping

Ssemble MCP Server

Ssemble AI Clipping 用の MCP サーバーです。あらゆる AI アシスタントから、バズるショート動画を作成できます。

Claude Desktop、Claude Code、Cursor、VS Code、Windsurf、および MCP 対応のあらゆるクライアントで動作します。

できること

この MCP サーバーを使うと、AI アシスタントが Ssemble の AI クリッピングエンジンを使用して、YouTube 動画からショート動画クリップを作成できます。AI は次のことができます。

• YouTube URL またはアップロードしたファイルからショート動画を作成
• Webhook コールバック — 処理が完了したときに通知を受け取ります（n8n、Zapier、Make で動作します）
• アセットを閲覧 — キャプションテンプレート、BGM、ゲームプレイのオーバーレイ、ミーム用フック
• 処理状況を追跡 — 進捗を確認し、完成したクリップを取得します
• リクエストを管理 — 履歴の一覧表示、結果の取得、古いリクエストの削除

前提条件

• 有効なサブスクリプションがある Ssemble アカウント
• API キー（Ssemble ダッシュボードの「Settings」→「API Keys」から取得できます）
• Node.js >= 18

クイックスタート

Claude Desktop

設定ファイルを編集します。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ssemble": {
      "command": "npx",
      "args": ["@ssemble/mcp-server"],
      "env": {
        "SSEMBLE_API_KEY": "sk_ssemble_your_key_here"
      }
    }
  }
}

保存した後、Claude Desktop を再起動します。

Claude Code

claude mcp add ssemble -- npx @ssemble/mcp-server

次に、環境変数を設定します。

export SSEMBLE_API_KEY="sk_ssemble_your_key_here"

Cursor / VS Code / Windsurf

MCP 設定に追加します。

{
  "mcpServers": {
    "ssemble": {
      "command": "npx",
      "args": ["@ssemble/mcp-server"],
      "env": {
        "SSEMBLE_API_KEY": "sk_ssemble_your_key_here"
      }
    }
  }
}

利用可能なツール

ツール	説明
create_short	動画から AI 生成のショートクリップを作成します。リクエスト ID をすぐに返します。
get_status	処理の進捗（0～100%）と現在のステップを確認します
get_shorts	動画 URL、タイトル、バイラルスコアとともに、完成したクリップを取得します
list_requests	ページネーションとステータスによる絞り込みで、すべてのリクエストを一覧表示します
delete_request	リクエストとその動画を完全に削除します
list_templates	キャプションスタイルのテンプレートを閲覧します
list_music	BGM トラックを閲覧します
list_game_videos	ゲームプレイのオーバーレイ動画を閲覧します
list_meme_hooks	注目を集めるミーム用フッククリップを閲覧します

処理の仕組み

動画の処理には 5～30 分かかります。次の 2 つのワークフローを利用できます。

オプション A：ポーリング（手動確認）

1. create_short — ジョブを送信し、リクエスト ID をすぐに返します
2. get_status — いつでも進捗を確認できます（キュー待ち → 処理中 → 完了）
3. get_shorts — 完了後に生成されたクリップを取得します

オプション B：Webhook（自動化）

1. webhookUrl を指定して create_short を実行 — コールバック URL とともにジョブを送信します
2. 処理が完了または失敗すると、API が結果を含む HTTP POST を指定した URL に送信します
3. ポーリングは不要です — n8n、Zapier、Make、およびカスタムバックエンドとの連携に最適です

Webhook ペイロードの例：

{
  "event": "shorts.completed",
  "requestId": "507f1f77bcf86cd799439011",
  "status": "completed",
  "timestamp": "2026-03-30T12:00:00.000Z",
  "data": {
    "shorts": [
      {
        "id": "...",
        "title": "AI-Generated Title",
        "video_url": "https://...",
        "duration": 45,
        "viral_score": 8.5
      }
    ]
  }
}

使用例

YouTube 動画からショート動画を作成する：

「https://youtube.com/watch?v=abc123 からショート動画を作成して。最初の 10 分を使い、落ち着いた BGM を付けて」

利用可能なアセットを閲覧する：

「キャプションテンプレートをすべて表示して」／「どんな BGM がある？」

進捗を確認する：

「動画リクエストの状況は？」

結果を取得する：

「リクエスト 507f1f77bcf86cd799439011 のクリップを、バイラルスコア順に表示して」

環境変数

変数	必須	説明
SSEMBLE_API_KEY	はい	Ssemble API キー（sk_ssemble_ で始まります）
SSEMBLE_API_BASE_URL	いいえ	API ベース URL を上書きします（デフォルト：https://aiclipping.ssemble.com/api/v1）

開発

git clone https://gitlab.com/vlogr/ssemble-mcp-server.git
cd ssemble-mcp-server
npm install
SSEMBLE_API_KEY=sk_ssemble_your_key npm start

ライセンス

MIT