Raylight MCP Server

Raylight MCP Server とは？

Raylight MCP Server は Raylight 公式のホスト型 MCP エンドポイントで、Claude、ChatGPT、Cursor などの MCP クライアントが、開いている Raylight プロジェクト内でモーショングラフィックスの製品動画を読み取り、編集し、レンダリングできるようにします。

Raylight は Frames of Motion Inc. が開発したブラウザベースのエディターで、ローンチ動画、アプリのプロモーション動画、3D 製品モックアップを制作できます。キャンバスにショットを配置し、タイムラインにアニメーションブロックを置き、カメラワークやシーンエフェクトを加えます。Raylight MCP はこのエディターに AI アシスタントを接続します。アシスタントはショットを読み取り、編集をまとめて適用し、実際のフレームをレンダリングして結果を確認し、気になる点を修正します。すべての変更はキャンバスにリアルタイムで反映され、自分の操作と同じように元に戻せます。

Raylight MCP Server の使い方

Raylight アカウントが必要です（無料で登録でき、初回接続時の同意画面からも作成できます）。編集とレンダリングには、raylight.app でプロジェクトをブラウザのタブで開いたままにしてください（タブはバックグラウンドでも構いません）。プロジェクトやテンプレートの一覧、デザインガイドの参照、メディアのアップロード、エクスポートの確認は、タブを開いていなくても動作します。

サーバー URL：

https://api.raylight.app/mcp

トランスポートは Streamable HTTP、認証は PKCE 付きの OAuth 2.0 です。貼り付けるキーはありません。クライアントが初めて接続すると、ブラウザで Raylight のページが開くので、ログインして Approve をクリックします。Raylight の REST API 用に作成した API キーは MCP サーバーでは使えません。

Claude Code

claude mcp add --transport http raylight https://api.raylight.app/mcp

その後、Claude Code で /mcp を実行し、ブラウザでサインインを完了します。

Claude Desktop と claude.ai

Settings > Connectors を開きます。ディレクトリに Raylight があればそこから選び、なければ Add custom connector を選んで https://api.raylight.app/mcp を貼り付け、Add、続いて Connect をクリックし、Raylight のサインインを承認します。

Cursor

~/.cursor/mcp.json（またはプロジェクトの .cursor/mcp.json）にサーバーを追加します。初回接続時に Cursor が Raylight のサインインを開きます。

{
  "mcpServers": {
    "raylight": {
      "url": "https://api.raylight.app/mcp"
    }
  }
}

VS Code

.vscode/mcp.json に追加します。

{
  "servers": {
    "raylight": {
      "type": "http",
      "url": "https://api.raylight.app/mcp"
    }
  }
}

ChatGPT と Codex

Raylight は ChatGPT の手順も公開しています。Developer mode をオンにし、サーバー URL と OAuth 認証でカスタムコネクターを作成し、サインインを承認します。Codex などのクライアントでは、同じ URL で raylight という名前の Streamable HTTP サーバーを追加します。

Raylight MCP Server の主な機能

• Raylight 公式のホスト型サーバーで、ローカルへのインストールは不要。
• PKCE 付き OAuth 2.0：クライアントがパスワードを見ることはなく、トークンは自動で更新されます。
• get_editor_status、list_projects、get_project_overview、get_shot_details などの読み取りツールで、編集前にプロジェクトを把握できます。
• プレビューではなく実際のレンダリング：render_stills、render_filmstrip、render_waveform でフレーム、テンポ、ミックスを確認し、check_sync で音と映像のビートのずれを測定します。
• apply_edits は 1 回の呼び出しで最大 200 件の編集（レイヤー、アニメーション、カメラ、ライト、サウンド、エフェクト）を適用します。
• upload_media と start_from_template でスクリーンショットを取り込み、公式テンプレートから始められます。
• 破壊的なツールは 1 つだけ（discard_import_session）。すべての編集は開いているエディターに反映され、元に戻せます。
• プランごとの週あたりツール呼び出し上限：Free 50 回、Hobby 1,000 回、Pro 5,000 回、Max 無制限。新しい Free と Hobby アカウントには 1 回限りの 1,000 回分のトライアル枠もあります。

Raylight MCP Server のユースケース

• ショットにアニメーションを付ける：「見出しを 0.5 秒でスライドアップさせ、ゆっくりしたプッシュインを加えて、最初のショットをレンダリングして確認して。」
• テンプレートから始める：「アプリのスクリーンショットが 3 枚あります。ローンチ用テンプレートから始めて差し替えて。」
• サウンドデザイン：「すべてのカットに重厚なシネマティックな whoosh を付けて、波形を見せて。」
• テンポの調整：「2 つ目のショットが遅く感じます。詰めてからフィルムストリップをレンダリングして。」
• プロジェクトの統一：「最初のショットの色とフォントをプロジェクト全体に揃えて。」

Raylight MCP Server のトラブルシューティング

• 編集やレンダリングがタイムアウトする：ほとんどの場合、エディターのタブが閉じられたか PC がスリープしています。raylight.app でプロジェクトを開き直して再試行してください。
• エディターが接続されていないと言われる：アシスタントに list_projects を呼ばせ、返された editUrl を開いてから編集を依頼してください。
• API キーが拒否される：MCP サーバーは OAuth のみ対応です。キーを外し、ブラウザでサインインしてください。
• 週の途中で呼び出しが止まる：プランの週間上限に達した可能性があります。上限を超えると 1 回の呼び出しごとにクレジットが 2 つ消費され、クレジットパックを購入するとすぐに再開できます。