tella

Tella 動画エディター

Tella MCP を使って、動画を把握、編集、確認します。ユーザーの依頼範囲に従ってください。分析の依頼は、編集の許可を意味するものではありません。

開始前に：Tella MCP に接続する

このスキルは、https://api.tella.com/mcp（Streamable HTTP、OAuth）の MCP サーバー経由で Tella を操作します。get_timeline などの Tella MCP ツールが利用できない場合は、まずサーバーに接続してください。

• Claude Code：claude mcp add --transport http --scope user tella https://api.tella.com/mcp
• Codex：codex mcp add tella --url https://api.tella.com/mcp
• Cursor、Claude Desktop：npx mcp-remote https://api.tella.com/mcp を実行する mcpServers エントリを追加します
• その他：任意の Streamable HTTP MCP クライアントを使用します。個人用 API キー（Tella の Settings → API Keys で作成した tella_pk_…）をベアラートークンとして使用できます

初回接続時はブラウザーで Tella が開き、サインインしてワークスペースを選択します。ツールの完全なリファレンスは https://www.tella.com/docs/mcp-server にあります。

アプローチ

動画全体を把握するには、まず get_timeline と 1 回以上の get_storyboard 呼び出しから始めます。正確な静止画には get_video_frame を、動き、音声、トランジション、カットのつながりには get_video_preview を使用します。GIF のフレームはサムネイル用であり、分析には使用しません。返されたプレビュー URL は、MP4 を実際に開いて確認した場合にのみ検証済みとみなされます。タスクと残る不確実性に応じて、必要な範囲だけを確認してください。

くだけた編集用語は、固定プリセットとしてではなく、意図された仕上がりに沿って解釈してください。「完全に編集」「自動編集」「ラフ編集」などの依頼で、実質的に異なる仕上げ方が考えられる場合は、動画を確認し、推奨する編集プランと関連する選択肢を提示してください。選択肢には、テンポとカットできる範囲、レイアウト、ズーム、クロップ、B ロール、テキスト、メディアオーバーレイ、音声、字幕、チャプター、必要に応じてアスペクト比などの形式を含めます。プランでは、何をしないかではなく、何をするかを説明してください。メタデータ、サムネイル、字幕の納品、書き出しなどの公開に関する詳細は、希望されていると思われる場合に選択肢として提示し、免責事項として述べないでください。「オーバーレイ」などの曖昧な用語は明確にし、最初の変更を加える前に、ユーザーに適用範囲の承認または調整を求めてください。編集方法をユーザーに考えさせるのではなく、ユーザーの選択をツール操作に反映します。承認された編集プランを適用範囲として扱い、意図されたテンポ、長さ、仕上げ方から大きく外れる場合は、再度確認してください。

適用範囲が明確になったら、動画の意味を保ちながら、まとまりのある視聴可能な初稿を作成します。検出されたフィラーや無音部分は、自動的に削除せず、編集候補として扱ってください。間は、思考、反応、待ち時間、または画面に見えるシステムの動作を伝えることがあります。撮り直し、言い出しの失敗、その他の収録ミスを見つけて削除するには、tella-remove-mistakes スキルを使用します。録画全体を一度に自動カットまたはテンポよく短縮するよう求められた場合は、tella-auto-cut スキルを使用します。このスキルは確認を求めずにミス、フィラー、無音部分をカットし、その後つなぎ目を整えます。「YouTube 用」は、視聴者向けのテンポと見せ方を意味し、固定の編集方式を意味するものではありません。

各クリップには、layoutId: "base" として指定される基本レイアウトがあります。update_layout で変更し、クリップの一部だけを変更するには、時間範囲を指定して add_layout を使用します。ユーザーは「Split Right Overlap」など、エディターの選択欄に表示されるラベルでレイアウトを指定します。そのラベルには、最も近いデフォルトのバリエーションではなく、ツールの説明にある種類とスタイルを使用してください。クリップのレイアウトを自動的に設定するには、tella-auto-layouts スキルを使用します。

モーショングラフィックス（アニメーションテキスト、タイトル、図解、数値の吹き出し、画面注釈）を作成する場合は、共通ルールを確認するために tella-motion-design スキルを読み込み、次にグラフィックに対応するスキルを読み込みます。対象は tella-kinetic-type、tella-title-cards、tella-explainer-graphics、tella-data-callouts、tella-screen-callouts です。

「B ロール」は通常、メディアを含むレイアウトで使用し、メインの映像領域を置き換えるか、共有する補助メディアとして扱います。メディアをメインのシーンに重ねて表示する意図がある場合は、オーバーレイを使用します。 別の形式が指定されている場合、または対象プラットフォームに明らかに適している場合は、update_video の寸法を変更して出力キャンバスとアスペクト比を調整できます。たとえば、9:16 のモバイル動画なら 1080×1920 にできます。Tella の自動比率など、一般的でない寸法が意図的に使われている場合もあるため、ユーザーから依頼された場合、または対象形式で必要な場合を除き、標準化しないでください。寸法を変更すると、元の映像が変わるのではなく、既存のレイアウトが再マッピングされるため、その後にレイアウトを確認して調整してください。

イベントに基づいて編集する場合は、利用可能であればマウスイベントやトランスクリプトのタイミングなど、記録済みのメタデータを優先し、エフェクトを配置する前に周辺の動画を確認してください。元の動画を転用するのではなく、複製から派生クリップやリールを作成してください。動画を縦型の Short、Reel、TikTok にするには、tella-short スキルを使用してください。

編集する前に時間軸を把握してください。動画レベルの確認では動画の累積再生時間を使用し、ほとんどのクリップ編集ではカット適用後のクリップ内再生時間を使用します。update_clip のカット定義では録画時の生の時間を使用します。同じ再生状態から測定したカット範囲はまとめて適用し、カット後に追加の範囲を計算する前にタイムラインを読み直してください。

タイミングや構成に影響する構造変更を行った後は、それに依存するズーム、オーバーレイ、チャプター、サムネイルを配置する前に、結果を読み直して確認してください。

動画とクリップの両方に設定が存在する場合、クリップの値は動画のデフォルト設定を上書きするか、適用対象から除外する設定として機能します。既存の値を確認し、反射的に両方へ書き込むのではなく、意図した最小範囲の設定だけを更新してください。

書き込みの結果が不明確な場合は、再試行する前に現在の状態を読み直してください。追加やカットを行う操作を、状況を確認せずに繰り返してはいけません。変更の中には非同期で処理されるものもあるため、評価する前にレンダリング結果が生成されるまで待ってください。

編集後はタイムラインを読み直し、適切なツールを使って影響を受けた範囲を確認してください。依頼された結果が得られ、明らかな問題が残らなくなるまで調整を続けてください。変更内容、確認によって実際に検証できたこと、残る不確実性を報告してください。