MCP
通过 MCP 将 Hi3D 工具接入 Agent 客户端,提交 3D 任务、查询异步状态并获取结果。客户端需要支持 Streamable HTTP 和自定义请求头。
| 配置项 | 值 |
|---|---|
| URL | https://mcp.hitem3d.ai/mcp |
| 传输方式 | Streamable HTTP |
| Authorization | Basic <BASE64_OF_CLIENT_ID_COLON_CLIENT_SECRET> |
client_id 为 Access Key,client_secret 为 Secret Key,均在 Platform 获取。将 client_id:client_secret 编码为 Base64;占位符必须替换为编码结果。
准备鉴权
在启动客户端的环境中设置 HI3D_MCP_AUTH,值为完整请求头 Basic <编码结果>。客户端需继承此环境变量;桌面应用可能需要单独配置启动环境。不要将完整凭据放入对话或共享配置。
配置客户端
以下示例均连接同一 Hi3D MCP 服务,选择你使用的客户端即可。
toml
# ~/.codex/config.toml
[mcp_servers.hi3d]
url = "https://mcp.hitem3d.ai/mcp"
env_http_headers = { Authorization = "HI3D_MCP_AUTH" }json
{
"mcpServers": {
"hi3d": {
"url": "https://mcp.hitem3d.ai/mcp",
"headers": {
"Authorization": "${env:HI3D_MCP_AUTH}"
}
}
}
}bash
claude mcp add --transport http --scope user hi3d \
https://mcp.hitem3d.ai/mcp \
--header "Authorization: $HI3D_MCP_AUTH"yaml
# 将此插件条目加入所用 profile 的插件配置
- id: mcp-hi3d
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: hi3d
transport: streamable-http
url: https://mcp.hitem3d.ai/mcp
headers:
Authorization: !!js process.env.HI3D_MCP_AUTH- Codex:保存后通过
codex mcp list查看配置。env_http_headers读取环境变量的完整值;不要改用 Bearer Token 配置。配置说明 - Cursor:写入
~/.cursor/mcp.json(全局)或.cursor/mcp.json(项目),在 MCP 设置中确认工具已加载。配置说明 - Claude Code:执行命令后通过
/mcp检查连接;命令适用于 Bash/Zsh。配置说明 - DeepSeek Harness:示例为插件配置片段,合并到当前 profile;按所用版本的官方说明加载配置。MCP 插件说明
开始使用
连接并加载工具后,可以向 Agent 提供图片地址和生成要求,例如:
使用 https://example.com/character.png 生成带纹理的 3D 模型,查询任务状态,完成后返回模型和封面链接。
示例图片地址需替换为可访问的实际地址。任务为异步执行,排队或生成中不代表失败;不要为轮询而重复提交任务。生成消耗 API 积分,提交前确认参数与可用余额;MCP 不是免费试用通道。结果链接有时效,请及时下载。
连接失败先检查环境变量是否被客户端读取、URL 和 Basic 请求头。任务错误见 错误处理。
技术支持:apicontact@hi3d.ai