用途：这是官方 Remix MCP 服务器的快速上手资料，用于配置或操作 @remix-gg/mcp、接入 MCP 认证，以及选择合适的 Remix MCP 工具。
安装与认证：如需浏览器认证和可复用凭据，先安装面向用户的 CLI： curl -fsSL https://remix.gg/install.sh | bash remix login remix whoami
然后配置 MCP： claude mcp add remix-mcp -- npx -y @remix-gg/mcp
MCP 服务器从以下位置读取认证：环境变量 REMIX_API_KEY，或保存在 ~/.config/remix/credentials.json 的 CLI 凭据。
项目设置查找顺序：打包的 MCP 技能在调用 createGame 之前，按此顺序查找：任务上下文或先前的工具结果、最近的 .remix-cli.json、旧的 .remix-mcp.json。上游 MCP 文档在部分内容上仍不一致，可能提到 .remix-settings.json，除非具体项目已在使用，否则应视为过时指引。安全规则：如果已有 gameId 和 versionId，就复用它们，不要调用 createGame。
核心工具集：createGame、updateGame、uploadVersion、generateImage、generateShopImage、uploadGameAsset、generateSpriteSheet、listShopItems、createShopItem、updateShopItem、deleteShopItem。
技能资源：服务器在 skills://... 下暴露技能资源，包括 skills://overview、skills://game-creation、skills://upload-game、skills://implement-multiplayer、skills://integrate-save-game、skills://add-image-to-game、skills://manage-shop-items、skills://add-sprite-to-game、skills://migrate-mobile-fullscreen、skills://open-game。执行多步操作前应先加载对应技能资源。
推荐流程：先读任务上下文，再读 .remix-cli.json，然后读旧的 .remix-mcp.json；若不存在 ID，则调用 createGame；按 window.RemixSDK 要求构建或修复游戏；按需用 uploadGameAsset、generateImage、generateShopImage 或 generateSpriteSheet 上传资源；用 uploadVersion 上传代码；若涉及变现，先运行 listShopItems 再创建或更新条目；继续前使用对应工作流资源了解详细规则。
限制与护栏：当任务上下文、.remix-cli.json 或旧的 .remix-mcp.json 已提供 ID 时，不要调用 createGame；在调用基于文件路径的 MCP 工具之前，不要自行读取 HTML 或资源文件；使用 CLI 登录或 REMIX_API_KEY，不要另造仅 MCP 的认证方案；若包文档有分歧，以 packages/mcp/src 中的当前包源码为准。