# 在 Claude Code 中使用 Hyper3D Rodin MCP

通过 Hyper3D Rodin MCP，可以直接在 Claude Code 中创建 3D 模型、查询生成进度，并获取模型下载链接。

## 一、安装

MCP 地址：`https://api.hyper3d.com/api/mcp`

推荐名称：`hyper3d-rodin`

名称可以自定义，但后续授权时需要使用你实际设置的名称。

### 方法一：使用 Claude Code CLI 安装

在 PowerShell 中运行：

```powershell
claude mcp add --transport http hyper3d-rodin --scope user https://api.hyper3d.com/api/mcp
```

安装完成后，开启新会话或重启 Claude Code，让配置生效。

### 方法二：手动配置

Windows 用户级配置文件通常位于：

```text
C:\Users\<你的用户名>\.claude.json
```

添加以下配置：

```json
{
  "mcpServers": {
    "hyper3d-rodin": {
      "type": "http",
      "url": "https://api.hyper3d.com/api/mcp"
    }
  }
}
```

如果文件中已经有其他 MCP，请把 `hyper3d-rodin` 合并到现有的 `mcpServers` 中，不要覆盖原有配置。

保存后开启新会话，或者重启 Claude Code。

> `type` 必须设置为 `http`。只有 `url` 而缺少 `type` 时，Claude Code 无法正确加载该服务器。

> 本 MCP 使用浏览器 OAuth 授权，不需要填写 API Key。

## 二、授权

在 PowerShell 中运行：

```powershell
claude mcp login hyper3d-rodin
```

Claude Code 会打开浏览器。登录 Hyper3D 账号、检查客户端身份、选择计费工作空间，并确认授权即可。

也可以先打开 Claude Code：

```powershell
claude
```

然后输入 `/mcp`，选择 `hyper3d-rodin` 并开始认证。

### 当前 Windows 授权注意事项

如果浏览器没有自动打开，请保持当前 Claude Code 终端窗口开启，并复制终端中显示的完整授权链接到浏览器打开。

请注意：

- 不要修改、分享或重复使用旧的授权链接。
- 如果授权页提示无法验证客户端身份，请核对客户端名称和回调地址，只授权你刚刚从 Claude Code 发起的请求。
- 如果授权请求已过期或已处理，请重新运行登录命令生成新链接。
- 创建 3D 模型可能会消耗所选 Hyper3D 工作空间的额度，请确认账号和工作空间无误。
- 授权包括读取 Rodin 生成结果、创建 Rodin 或 BANG 模型，以及保持连接所需的刷新权限。

授权完成后，可以输入以下命令检查连接状态：

```text
/mcp
```

也可以在 PowerShell 中运行：

```powershell
claude mcp list
```

看到 `hyper3d-rodin` 显示为 `Connected` 后即可使用。

## 三、使用

直接在 Claude Code 中描述需要完成的任务即可。建议在请求中明确指定使用 `hyper3d-rodin`。

### 例

```text
请使用 hyper3d-rodin 创建一个低多边形风格的机器人 3D 模型。
提交前先告诉我将使用的参数和计费工作空间，等我确认后再开始生成。
```