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

此插件将其 Dev MCP 连接打包为 runway-dev 服务器。MCP 使用浏览器 OAuth。应用 SDK 使用单独的项目 API 密钥；切勿将该密钥放入 MCP 配置中。

如果捆绑的服务器需要身份验证，请使用 Claude 的 MCP 连接流程（例如，在 Claude Code 中使用 /mcp），而不是添加另一个服务器条目。凭据与已配置的连接相关联，因此通过另一个命名条目登录并不会验证捆绑的服务器。若连接缺失，请参阅连接 Runway Dev。

出现提示时，让用户在常用浏览器中完成 Runway OAuth，然后返回同一个 Agent 会话并重试 MCP 检查。切勿索要他们的 Runway 密码、OAuth 代码或 API 密钥。

3. 确认账户和项目

OAuth 完成后，调用 whoami 并报告工具显示的已连接 Developer Portal 邮箱或身份。如果用户有要连接的应用，请调用 list_projects，让他们从可访问的项目中选择。如果有多个候选项目，不要猜测或悄悄替用户选择。

如果用户没有项目，请引导他们在 Developer Portal 中创建或选择一个项目，然后再次调用 list_projects。不要编造项目创建 MCP 工具，也不要用 REST 端点替代。

4. 修复账户设置错误

如果 MCP 返回 HTTP 403，并明确提示 developer_not_found 错误，说明 OAuth 身份有效，但 Developer Portal 设置尚未完成。新账户请使用错误响应中的 signup_url，现有账户请使用 login_url。较旧的服务器版本可能只返回 login_url；请使用该链接以及当前账户设置指南。显示适用的链接，让用户在浏览器中完成设置。随后让他们在同一个编码客户端中重试或重新连接 Runway Dev，再次调用 whoami；如果任务需要项目，则调用 list_projects。

不要将错误中提供的注册或登录 URL 替换为猜测的账户路径，不要根据其他工具的输出推断缺失的账户状态，不要创建凭据、修改 OAuth 作用域或尝试其他身份端点。如果用户重新连接后仍出现相同错误，请停止依赖 MCP 的操作，并报告确切的阻碍。继续处理可根据公开文档和现有应用配置完成的工作。

5. 仅在需要时配置应用密钥

对于 SDK 集成工作，请检查是否已配置 RUNWAYML_API_SECRET，但不要打印其值。如果未配置，请引导用户前往 Developer Portal 创建项目密钥，并将其存储在应用服务器的环境变量或密钥管理器中。密钥应仅保留在服务器端，不要放入浏览器包、聊天内容、源代码管理或 MCP 配置中。仅连接 MCP 并不需要密钥。

链接

• Runway Dev 账户和 MCP 设置
• 项目和 API 密钥设置
• Runway Dev API 安全指南