Configurer Runway Dev
Guidez l'utilisateur de l'installation du plugin à un compte Developer Portal connecté. Cette compétence est incluse avec le plugin ; utilisez-la directement et ne pas installer ou récupérer une copie dupliquée.
Vérifiez d'abord si le MCP Runway Dev fourni est déjà connecté. Si whoami réussit, ignorez la connexion et passez à la sélection du projet. Si le serveur est configuré mais nécessite une authentification, utilisez le flux de connexion de l'hôte plutôt que d'ajouter une autre entrée de serveur.
1. Se connecter ou créer un compte
Demandez à l'utilisateur s'il a déjà un compte Runway Dev uniquement si ce n'est pas clair d'après la conversation. Dirigez-le vers le Runway Dev Developer Portal : il peut se connecter avec un compte existant ou en créer un là. Laissez l'utilisateur terminer les étapes d'inscription, de vérification et de consentement lui-même dans son navigateur. N'automatisez pas l'authentification du navigateur ni ne créez de compte au nom de l'utilisateur.
S'il construit une intégration d'application, expliquez que l'accès au Developer Portal seul ne configure pas l'application. Il peut avoir besoin de sélectionner ou créer un projet et de créer une clé API de projet dans le portail. Consultez API setup pour les étapes actuelles de projet et clé. Ne demandez pas à l'utilisateur de coller la clé dans le chat.
2. Connecter Dev MCP
Connectez l'hôte à https://dev.runwayml.com/mcp en utilisant la configuration MCP documentée de l'hôte à Connect Runway Dev. MCP utilise OAuth du navigateur. Le SDK d'application utilise une clé API de projet séparée ; ne jamais mettre cette clé dans la configuration MCP.
Si le serveur MCP n'est pas configuré, aidez à l'ajouter en utilisant le format de configuration exact documenté pour l'hôte de l'utilisateur. Ne supposez pas que tous les hôtes supportent le même flux d'installation de plugin ou la même commande. Si l'hôte est inconnu, liez le guide de connexion et demandez quel hôte ils utilisent avant de modifier la configuration spécifique à l'hôte.
Lorsque vous êtes invité, faites en sorte que l'utilisateur complète Runway OAuth dans son navigateur normal, revienne à la même session d'agent et réessaye la vérification MCP. Ne demandez jamais son mot de passe Runway, son code OAuth ou sa clé API.
Pour Codex CLI, exécutez codex mcp login runway-dev après l'installation du plugin pour authentifier sa connexion fournie. Les identifiants sont associés à la connexion MCP configurée, donc se connecter via une entrée de test nommée séparément n'authentifie pas le serveur fourni.
3. Confirmer le compte et le projet
Après qu'OAuth soit terminé, appelez whoami et signalez le courriel ou l'identité du Developer Portal connecté affiché par l'outil. Si l'utilisateur a une application à connecter, appelez list_projects et laissez-le choisir parmi les projets accessibles. Ne devinez pas et ne sélectionnez pas silencieusement un projet s'il y a plusieurs candidats.
Si l'utilisateur n'a pas de projet, dirigez-le pour en créer ou en sélectionner un dans le Developer Portal, puis appelez list_projects à nouveau. N'inventez pas d'outil MCP de création de projet ni n'appelez un endpoint REST en tant que substitut.
4. Récupérer les erreurs de configuration du compte
Si MCP retourne HTTP 403 avec l'erreur explicite developer_not_found, l'identité OAuth est valide mais sa configuration du Developer Portal est incomplète. Utilisez signup_url de la réponse d'erreur pour un nouveau compte et login_url pour un compte existant. Les versions de serveur plus anciennes peuvent retourner uniquement login_url ; utilisez ce lien et le guide de configuration de compte actuel. Affichez le lien applicable et laissez l'utilisateur terminer la configuration dans son navigateur. Ensuite, faites-le réessayer ou reconnecter Runway Dev dans le même client de codage, appelez whoami à nouveau, et appelez list_projects si la tâche nécessite un projet.
Ne remplacez pas l'URL d'inscription/connexion fournie par l'erreur par un chemin de compte deviné, n'inférez l'état du compte manquant à partir du résultat d'un autre outil, ne créez pas d'identifiants, ne modifiez pas les portées OAuth, ni n'essayez d'autres endpoints d'identité. Si la même erreur persiste après que l'utilisateur se reconnecte, arrêtez l'action dépendante de MCP et signalez le blocker exact. Continuez tout travail qui peut procéder à partir de docs publiques et de configuration d'application existante.
5. Configurer la clé d'application uniquement si nécessaire
Pour le travail d'intégration SDK, vérifiez si RUNWAYML_API_SECRET est configuré sans imprimer sa valeur. Si ce n'est pas le cas, dirigez l'utilisateur pour créer une clé de projet dans Developer Portal et la stocker dans l'environnement ou le gestionnaire de secrets du serveur d'application. Gardez la clé du côté serveur et hors des bundles du navigateur, du chat, du contrôle de source et de la configuration MCP. Une clé n'est pas requise simplement pour connecter MCP.