MCP
Connect Hi3D tools to an agent client to submit 3D tasks, query asynchronous status and retrieve results. Your client must support Streamable HTTP and custom request headers.
| Setting | Value |
|---|---|
| URL | https://mcp.hitem3d.ai/mcp |
| Transport | Streamable HTTP |
| Authorization | Basic <BASE64_OF_CLIENT_ID_COLON_CLIENT_SECRET> |
client_id is your Access Key and client_secret is your Secret Key, available in Platform. Base64-encode client_id:client_secret and replace the placeholder with the encoded result.
Prepare authentication
Set HI3D_MCP_AUTH in the environment used to start your client. Its value must be the full header value, Basic <encoded result>. The client must inherit this variable; desktop apps may require a separate launch environment. Do not put credentials in conversations or shared configuration.
Configure your client
Choose the example for your client. All examples connect to the same Hi3D MCP service.
# ~/.codex/config.toml
[mcp_servers.hi3d]
url = "https://mcp.hitem3d.ai/mcp"
env_http_headers = { Authorization = "HI3D_MCP_AUTH" }{
"mcpServers": {
"hi3d": {
"url": "https://mcp.hitem3d.ai/mcp",
"headers": {
"Authorization": "${env:HI3D_MCP_AUTH}"
}
}
}
}claude mcp add --transport http --scope user hi3d \
https://mcp.hitem3d.ai/mcp \
--header "Authorization: $HI3D_MCP_AUTH"# Add this plugin entry to the profile you use
- 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: save the configuration and inspect it with
codex mcp list.env_http_headersreads the entire environment variable value; do not use Bearer Token configuration for this service. Configuration - Cursor: use
~/.cursor/mcp.jsonglobally or.cursor/mcp.jsonfor a project, then confirm that tools load in MCP settings. Configuration - Claude Code: run the command in Bash/Zsh, then check the connection with
/mcp. Configuration - DeepSeek Harness: merge the plugin snippet into your current profile and follow the configuration guide for your installed version. MCP plugin
Use the tools
After the connection loads the tools, give your agent an accessible image URL and generation requirements, for example:
Generate a textured 3D model from https://example.com/character.png, query its status, and return the model and cover links when complete.
Replace the example URL with a real, accessible image. Tasks run asynchronously: queueing or processing does not mean failure. Poll the original task rather than submitting duplicates. Generation consumes API credits; confirm parameters and balance before submission. MCP is not a free generation channel. Download results before their links expire.
For connection failures, check that the client inherits the environment variable and that the URL and Basic header are correct. See Error handling for task errors.
API support: apicontact@hi3d.ai