runway-dev-setup

Runway Dev のセットアップ

プラグインのインストールから、Developer Portal アカウントへの接続までをユーザーに案内します。このスキルはプラグインに含まれているため、そのまま使用し、重複するコピーをインストールしたり取得したりしないでください。

まず、バンドルされている Runway Dev MCP がすでに接続されているか確認します。whoami が成功した場合は、サインインを省略してプロジェクトの選択に進みます。サーバーが設定済みで認証が必要な場合は、別のサーバーエントリを追加するのではなく、ホストの接続フローを使用します。

1. サインインまたはアカウントの作成

会話からユーザーが Runway Dev アカウントをすでに持っているか明らかでない場合に限り、アカウントの有無を尋ねます。Runway Dev Developer Portal に案内します。既存のアカウントでサインインするか、そこでアカウントを作成できます。サインアップ、認証、同意の手続きは、ユーザー自身がブラウザーで完了できるようにします。ブラウザー認証を自動化したり、ユーザーに代わってアカウントを作成したりしないでください。

アプリケーション連携を構築している場合は、Developer Portal へのアクセスだけではアプリケーションの設定は完了しないことを説明します。ポータルでプロジェクトを選択または作成し、プロジェクト API キーを作成する必要がある場合があります。最新のプロジェクトおよびキーの手順については、API のセットアップに従ってください。ユーザーにキーをチャットに貼り付けるよう求めないでください。

2. Dev MCP に接続する

このプラグインには、runway-dev サーバーとして Dev MCP 接続がバンドルされています。MCP はブラウザー OAuth を使用します。アプリケーション SDK では別のプロジェクト API キーを使用します。このキーを MCP の設定に含めないでください。

バンドルされているサーバーで認証が必要な場合は、別のサーバーエントリを追加するのではなく、Claude の MCP 接続フロー（たとえば Claude Code の /mcp）を使用します。認証情報は設定済みの接続に関連付けられるため、別の名前のエントリからサインインしても、バンドルされているサーバーは認証されません。接続が見つからない場合は、Runway Dev に接続するを参照してください。

プロンプトが表示されたら、ユーザーに通常使用しているブラウザーで Runway OAuth を完了し、同じエージェントセッションに戻ってから MCP のチェックを再試行してもらいます。Runway のパスワード、OAuth コード、API キーを尋ねないでください。

3. アカウントとプロジェクトを確認する

OAuth の完了後、whoami を呼び出し、ツールに表示された接続済みの Developer Portal のメールアドレスまたは ID を伝えます。接続するアプリがある場合は、list_projects を呼び出し、アクセス可能なプロジェクトから選んでもらいます。候補が複数ある場合、プロジェクトを推測したり、黙って選択したりしないでください。

ユーザーにプロジェクトがない場合は、Developer Portal でプロジェクトを作成または選択するよう案内し、その後もう一度 list_projects を呼び出します。プロジェクト作成用の MCP ツールをでっち上げたり、代わりに REST エンドポイントを呼び出したりしないでください。

4. アカウント設定エラーから復旧する

MCP が明示的な developer_not_found エラーを伴う HTTP 403 を返した場合、OAuth ID は有効ですが、Developer Portal の設定が未完了です。新規アカウントにはエラーレスポンスの signup_url を、既存アカウントには login_url を使用します。古いサーバーバージョンでは login_url のみが返されることがあります。そのリンクと最新のアカウント設定ガイドを使用してください。該当するリンクを表示し、ユーザー自身がブラウザーで設定を完了できるようにします。その後、同じコーディングクライアントで Runway Dev を再試行または再接続してもらい、再度 whoami を呼び出します。タスクでプロジェクトが必要な場合は、list_projects も呼び出します。

エラーに含まれるサインアップ／ログイン URL を推測したアカウントパスに置き換えたり、別のツールの出力から不足しているアカウント状態を推測したり、認証情報を作成したり、OAuth スコープを変更したり、別の ID エンドポイントを試したりしないでください。ユーザーが再接続した後も同じエラーが続く場合は、MCP に依存する操作を中止し、正確な阻害要因を報告します。公開ドキュメントと既存のアプリケーション設定に基づいて進められる作業は続行します。

5. 必要な場合にのみアプリケーションキーを設定する

SDK の統合作業では、値を表示せずに RUNWAYML_API_SECRET が設定されているか確認します。設定されていない場合は、Developer Portal でプロジェクトキーを作成し、アプリサーバーの環境変数またはシークレットマネージャーに保存するようユーザーに案内します。キーはサーバー側で管理し、ブラウザーのバンドル、チャット、ソース管理、MCP 設定には含めないでください。MCP に接続するだけであれば、キーは必要ありません。

リンク

• Runway Dev アカウントと MCP の設定
• プロジェクトと API キーの設定
• Runway Dev API のセキュリティガイダンス