mcpField
A
aip-setup

aip-setup

github.com/opus-proクリエイティブ・メディア7126 回インストール4 日前に更新
リポジトリ

aip-setup について

aip-setupは、AI Producerへの初回接続から最初のプロジェクト開始までを案内する、動画編集を始めるユーザー向けのセットアップスキルです。接続を確認して動画と目的を受け取り、プロジェクト開始後に引き継ぎます。編集作業は別のスキルが担当します。

主な機能

  1. 01AI Producerへの接続確認
  2. 02クライアント別の接続手順案内
  3. 03動画と編集目的の確認
  4. 04添付送信前の料金確認
  5. 05プロジェクト開始後の引き継ぎ

活用シーン

  1. 01AI Producerへの初回接続
  2. 02チャット添付からの動画プロジェクト作成
  3. 03新しい会話でのセットアップ再開

MCP 対応

get_pricingやstart_project_from_attachmentなどのAI Producerツールを使います。AI ProducerサーバーはMCP経由で接続します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/opus-pro/ai-producer-plugin --skill aip-setup

インストール後、Claude Code で/aip-setupを入力して読み込まれたか確認します。

同梱ファイルagents/openai.yaml

詳細

AI Producer をセットアップする

このスキルは、インストール直後の状態から、実際に使える AI Producer プロジェクトを 1 つ作成するところまで進め、その時点で終了します。最初の成功とは、AI Producer が受け付けて準備を開始したプロジェクトであり、編集済みの動画ではありません。その後のカット、字幕、モーショングラフィックスはすべて、aip スキルの担当です。

再実行しても安全です。実行するたびにステップ 1 から始め、完了済みの項目はスキップします。新しいチャットで「AI Producer のセットアップを続けて」と伝えると、前回の続きから再開します。すでに接続が機能している場合はステップ 1 と 2 をスキップし、この会話ですでにプロジェクトを開始している場合は、ステップ 6 からそのプロジェクトで続行します。

ユーザーへの話し方は、aip スキルの「ユーザーへの話し方」セクションに従ってください。ユーザーの言語で、ユーザーのアカウントや動画について話し、ツール、サーバー、コード、このスキルについては話しません。

現在の会話の種類

ステップ 1 の前に、一度だけ判断してください。コマンドを実行したり、ファイルを書き込んだりできる場合、その会話にはコンピューター環境があります。ChatGPT Work、Codex、Claude Code には常にあります。Cursor では、コマンドツールまたはファイルツールを利用できる場合にあります。ChatGPT Chat にはありません。ユーザーがそこで添付する動画は、ホスト側が保持しているものであり、あなたが利用できるファイルではありません。

  • **コンピューター環境がある場合:**ステップ 1 から 3 を記載どおりに実行します。その後、ユーザーの動画と目標をそのまま aip スキルの新規プロジェクトフローに引き継ぎます。新規プロジェクトフローでは動画をアップロードしてプロジェクトを開始し、編集を続けます。以下のステップ 4 から 6 は適用されません。この環境では添付ファイルツールを使わないでください。
  • **コマンドまたはファイルにアクセスできない Cursor の場合:**このチャットからユーザーの動画ファイルと編集ワークスペースにアクセスする必要があることを伝えます。コマンドとファイルへのアクセスを有効にした Agent モードに切り替えてから、セットアップを再開するよう依頼します。アクセスが可能になるまでここで中断してください。ChatGPT の添付ファイルのみを使うフローや、Cursor での start_project_from_attachment は使わないでください。
  • **コンピューター環境のない ChatGPT Chat の場合:**6 つのステップすべてが適用されます。動画が AI Producer に届くのは、サーバーが start_project_from_attachment を通じてダウンロードする添付ファイルとしてのみです。ユーザーにコマンドの実行、ターミナルの起動、あなたのコンピューターからのアップロードを依頼しないでください。また、アップロードの署名も行わないでください。

1. AI Producer はすでに接続されていますか?

引数なしで get_pricing を呼び出します。これは無料で、どのプロジェクトからも何も読み取らず、サインイン済みの接続が必要なため、確認に使えます。その応答を保持してください。ステップ 4 で参照します。

  • **価格表が返る場合:**接続は機能しています。そのことを一文で伝え、ステップ 3 に進みます。
  • AI Producer のツールがツール一覧にない場合、またはサインインを求められて呼び出しが拒否された場合(応答またはホストが、接続にはサインインが必要だと示している、認証情報がない、または認証情報の有効期限が切れている、取り消されている、認識されない場合):アカウントは接続されていません。以下の接続手順に進みます。
  • それ以外の理由で呼び出しに失敗した場合(サービスに接続できない、ネットワークエラー、タイムアウト、サーバー障害など):これはサインインの問題ではなく、再度サインインしても解決しません。AI Producer に今は接続できないことと、アカウントや動画に問題があるわけではないことをユーザーに伝えます。再確認は最大でも一度にしてください。それでも失敗する場合は、数分後にもう一度セットアップを試すよう依頼します。サインインを案内しないでください。
アカウントを接続する

このクライアントを AI Producer に接続する作業は、独立した手順です。AI Producer のウェブサイトにサインインしていても、ChatGPT、Codex、Claude Code、Cursor は接続されません。また、これらを接続するためにウェブサイトへのサインインが先に必要というわけでもありません。接続すると、専用の AI Producer サインインページが開きます。すでにアカウントをお持ちのユーザーはそこでサインインし、新しいユーザーはそこでアカウントを作成します。

接続を完了できるのは、ユーザー自身のクライアント上でユーザー本人だけです。使用中のクライアントに合わせて手順を案内してください。

  • ChatGPT(Chat または Work): ChatGPT で AI Producer への接続が案内されたら、Connect を選び、サインインを完了してもらいます。案内されない場合は、Settings > Apps & Connectors から AI Producer に接続するか再接続し、そこでサインインを完了してもらいます。
  • Codex: ユーザー自身のターミナルで codex mcp login ai-producer を実行し、サインインを完了してもらいます。Codex デスクトップアプリでも同じ手順です。プラグインの接続には独自のサインイン操作がなく、実行するコマンドはネットワークにアクセスしないため、こちらで代わりに接続することはできません。
  • Claude Code: /mcp を実行し、plugin:aip:ai-producer を選択して、サインインを完了してもらいます。
  • Cursor: Customize > MCPs > ai-producer > Authenticate を開き、サインインを完了してもらいます。Codex や Claude Code のコマンドではなく、Cursor 独自の接続操作を使用してください。

npx skills add などでスキルだけをインストールした場合、ai-producer サーバーは追加されないため、サインインする先はありません。上記の手順で指定された場所に AI Producer サーバーが見つからない場合は、ユーザー自身のターミナルで一度だけ追加してもらいます。Claude Code の場合は claude mcp add --transport http --scope user ai-producer https://producer.opus.pro/api/mcp を実行します。すると /mcp の一覧に ai-producer として表示されます。Codex の場合は codex mcp add ai-producer --url https://producer.opus.pro/api/mcp を実行します。その他のクライアントでは、各自の MCP 設定で、その URL を指定した ai-producer という名前の HTTP MCP サーバーを追加してもらいます。その後、新しいチャットを開始し、上記の手順でサインインしてから、「AI Producer のセットアップを続けて」と伝えてもらいます。

拒否メッセージに復旧方法が記載されている場合、その意味をこの手順に添えて、平易な言葉で伝えてください。クライアント側に向けた説明だからです。認証リンクを作成したり、プラグインの再インストールを提案したり、既存の MCP 設定を変更したりしないでください。これらではアカウントは接続されず、動作中のインストールを壊す可能性があります。その後、完了したら知らせてもらい、返答を待ってください。

2. 接続を確認する

ユーザーが接続したと伝えたら、もう一度 get_pricing を呼び出してください。判断基準はその応答だけです。ユーザーがサインインしたと言っても接続されたとは限らず、ウェブサイトにサインイン済みと表示されていても同様です。

  • 料金表が返される場合: AI Producer に接続されたことを一行で伝え、ステップ 3 に進みます。
  • サインインを求める拒否が続く場合: サインインが完了していません。同じ手順をもう一度案内し、期限切れのサインインや、AI Producer を利用できないアカウントなど、拒否メッセージに記載された変更点だけを伝えてください。再度の確認は多くても一回までとし、その後は接続の手順でセットアップを一時停止し、「AI Producer のセットアップを続けて」と伝えれば再開できると案内してください。
  • ツールが引き続きツール一覧にない場合: この会話では新しい接続が反映されていません。新しいチャットを開始し、そこで「AI Producer のセットアップを続けて」と伝えてもらいます。
  • その他の失敗の場合: ステップ 1 と同様に対処してください。サインイン後に失敗したからといって、再度サインインするよう案内してはいけません。

3. 動画と目的

短いメッセージ一つで、動画一つを会話に添付することと、その動画で何をしたいかを一文で伝えることの二点を依頼してください。たとえば、「字幕付きの60秒のハイライト」のように伝えてもらいます。会話に動画と目的の両方がすでに含まれている場合は、それらを使い、何も尋ねません。どちらか一方だけが含まれている場合は、もう一方だけを尋ねます。

聞き取りはこれで完了です。ここではスタイル、字幕、音楽、ブランディング、参考画像について尋ねないでください。編集を開始すると、aip スキルがそれらを確認します。プロジェクトごとに動画は一つです。ユーザーが複数の動画を添付した場合は、どの動画から始めるか尋ねてください。

4. 送信前

動画を使用できるかどうかはサービスが判断します。形式、長さ、サイズの上限は送信時に確認され、拒否された場合はどの条件に該当したかが示されます。動画を自分で測定、変換したり、判断し直したりしないでください。また、上限を記憶に頼って伝えないでください。

開始費用は、保存しておいた get_pricing の回答から読み取ってください。記憶から答えてはいけません。start_project_from_attachment の行と請求の詳細を確認し、aip スキルの料金ルールに従ってください。開始時にこのユーザーへの請求が発生する場合は、送信前に動画の準備にかかる費用をわかりやすく伝え、料金算出のためサービスが動画の長さを測定することも伝えてください。1日の上限で先にカバーできる可能性がある場合は、そのことも伝えてください。無料の場合は、料金について何も伝えないでください。

5. 送信

start_project_from_attachment を1回呼び出してください。

  • file:この会話でユーザーが添付した動画です。ホストが設定します。ファイルオブジェクトを自分で記述したり、以前の試行で使用したものを再利用したりしてはいけません。
  • prompt:ユーザーの目的を、ユーザー自身の言葉で記述します。
  • aspect_ratio:ユーザーが指定した場合に限り設定します。

呼び出しでは、応答する前に動画全体をダウンロードするため、時間がかかることがあります。完了するまで待ってください。project_id と task_id の両方を含む応答が返った場合にのみ、プロジェクトが作成されています。それまでは、プロジェクトについて何も伝えないでください。

拒否された場合は、拒否の内容に従って一度だけ対応し、同じ呼び出しを変更せずに繰り返してはいけません。

  • 添付ファイルをダウンロードできなかった場合(ファイルが届かなかった、またはアドレスが拒否された場合):同じ呼び出しを再送しても、同じように失敗します。ユーザーには、ChatGPT のウェブ版から動画を再度添付する方法と、AI Producer のウェブサイトにアップロードしてそこで続行する方法の両方を案内してください。
  • 対応していない動画、長すぎる動画、またはサイズが大きすぎる動画の場合:拒否に記載された理由を伝え、条件に合う動画を依頼してください。
  • クレジット、無料利用、またはその日のプロジェクト上限に達した場合:使い切ったものとリセット時刻を伝え、拒否にチャージまたはアップグレードのリンクが含まれていれば、併せて案内してください。料金は請求されていません。
  • 混雑中、または再試行可能と示されたダウンロードの中断の場合:拒否に記載された時間だけ待ってから、もう一度だけ試してください。2回目も失敗した場合は、添付ファイルをダウンロードできなかった場合と同じ2つの方法を案内してください。
  • 接続で再度サインインが必要な場合:ステップ1の接続手順に戻ってください。
  • その他の拒否の場合:拒否に別の記載がない限り、プロジェクトは開始されず、料金も請求されていないことを伝え、後でもう一度試すことを提案してください。

タイムアウトや接続の切断により、応答がまったくないまま呼び出しが終了した場合は、拒否ではありません。プロジェクトが開始されている可能性があります。再度呼び出してはいけません。また、失敗した、または料金が請求されていないとも伝えてはいけません。list_projects で確認してください。送信後に作成された、この動画のプロジェクトが見つかった場合はそれが該当するプロジェクトです。そのリンクを使ってステップ6に進んでください。まだ見つからない場合は、開始処理がまだ進行中の可能性があり、プロジェクトが作成されると AI Producer のウェブサイトに表示されることをユーザーに伝えてください。再試行を求められた場合は、もう一度 list_projects で確認してください。それでも見つからなければ、開始処理が実際に完了していた場合は2つ目のプロジェクトが作成され、再度請求される可能性があることを伝えてください。そのリスクを理解したうえでユーザーが進めるよう指示した場合に限り、再度送信してください。

6. 引き継ぎ

回答にプロジェクトが含まれている場合は、次の順序でユーザーに伝えます。

  1. プロジェクトは AI Producer にあり、動画の準備中です。まだ編集はされていません。カットの前に、映像素材を準備する必要があります。
  2. 回答に含まれる page_url のプロジェクトリンクを、そのまま正確に伝えます。これはユーザー自身が保持するリンクで、どのブラウザーからでも開けます。agent_page_url は絶対に伝えないでください。
  3. 続きの作業を行う場所を伝えます。カット、字幕、モーショングラフィックスには、コンピューターを操作できる環境での会話が必要です。ChatGPT Work チャット、Codex タスク、またはコマンドとファイルを扱える Claude Code や Cursor のチャットを利用できます。ユーザー自身で開始し、AI Producer に言及したうえで、プロジェクトリンクを貼り付けてもらいます。映像素材はすでに AI Producer にあるため、再度添付する必要はありません。

これでセットアップは完了です。この会話中にこのスキルを再度呼び出さないでください。準備の進捗について尋ねられた場合は、get_task で確認し、そこに記載されている内容をもとに回答してください。

コメント