# D5 Works MCP: Setup, Usage & Troubleshooting Connect D5 Works to your AI Agent to find furniture and creative assets, compare options, and keep source links with your shortlist. This guide covers MCP and Skill installation, API key setup, example prompts, and troubleshooting. ## Quick start and supported resources Search for furniture products, 3D models, 2D assets, HDRI lighting, and PBR materials. Check the returned resource type, dimensions, format, license, and access requirements before using an asset. Search results do not guarantee a matching downloadable model or automatic import into your design software. - Copy the instruction below into your supported AI Agent and follow its setup prompts. - Create a Works API key and enter it only through the protected configuration flow. Never include the key in a shared prompt, screenshot, or log. - Reload your Agent if requested, verify that the Works MCP tools are available, then run a small search and inspect the returned source link. ### Installation and connection - [Download the installation package (ZIP)](https://usa.works.d5cdn.com/mcp/d5-works-skill.zip): Get D5 Works Skill and its supporting installation files. - [Read the installation instructions](https://usa.works.d5cdn.com/mcp/d5-works-mcp-install.md): Follow the setup steps, or share the link with your AI Agent for help installing. - [Create an API key](https://d5works.com/users/mcp-api-keys): Sign in to your D5 account and create a key to connect to D5 Works. **MCP service endpoint (manual setup)** If your client asks for an MCP service endpoint, copy this address: ```text https://usa.api.d5render.com/works/mcp ``` Copy the instruction below into an AI Agent that supports MCP, then follow its setup prompts. D5 Works Skill is optional and requires a client that supports Agent Skills. A missing skill or unavailable version check does not prevent normal use of MCP tools. **Installation instruction** ```text Follow https://usa.works.d5cdn.com/mcp/d5-works-mcp-install.md to configure D5 Works MCP. If my client supports Agent Skills, ask whether I want to install the optional D5 Works Skill. Do not require skill installation or a version check before using MCP. ``` ## Troubleshoot with your AI Agent Share the [Works documentation index (llms.txt)](https://docs.d5render.com/works/llms.txt) with your Agent and ask it to follow the “D5 Works MCP” entry to read this guide. Include the failed step, exact error message, Agent name and version, operating system, and whether a basic Works search succeeds. Remove API keys, tokens, and personal data before sending the prompt below. **Troubleshooting prompt** ```text Open https://docs.d5render.com/works/llms.txt and follow the “D5 Works MCP” entry to read the setup, usage, and troubleshooting guide. Help troubleshoot my D5 Works setup. First ask for my Agent, operating system, failed step, and redacted error. Check installation, authentication, tool availability, and resource access separately. Explain the evidence before proposing a fix. Ask before changing configuration; never ask me to paste an API key here. ``` - Tools missing: check that the MCP server is installed and enabled in this Agent, then reload it as required by the Agent. - Authentication error: check key validity and the configured account. Update credentials through the protected configuration flow. - No suitable results: simplify the brief, check the resource type, and relax one filter at a time. - Download or import fails: check entitlement, license, link validity, file format, and supported tools. A successful search does not confirm download or import permission. ## 1. Installation Complete the following steps in the AI agent you use: ### 1.1 Set up D5 Works MCP and the optional skill Open the [D5 Works MCP page](https://d5works.com/mcp) and copy the installation instruction using Copy instruction. Paste it into a conversation with your AI agent and send it. ![install with ai agent cursor](/images/works/mcp/install-with-ai-agent-cursor.png) The agent reads the installation guide, identifies the current client, and inspects the package. It then explains the installation location and settings that will change. Review those details and confirm that it can proceed. It then configures D5 Works MCP, preserving your existing configuration. If your client supports Agent Skills, you can also choose to install D5 Works Skill. Restart or reload the agent if prompted. ### 1.2 Create an API key and connect To connect, open [Create a D5 Works MCP API key](https://d5works.com/users/mcp-api-keys), sign in, and create a key. If you do not have a D5 account, complete registration first. Keep the key private. When it is ready, return to the conversation and reply API key ready. Do not paste the key into the chat. Follow the agent's directions to its protected credential or plugin-configuration interface. Enter the key yourself in the Works API key field. When the client confirms the connection, return to the conversation and reply connected. Enter the key only through the protected interface. Keep it out of messages, commands, URLs, screenshots, and plaintext files. ### 1.3 Verify the installation After you confirm the connection, the agent checks that MCP tools are available and runs a search to verify the connection. If you chose to install the skill, check its loading status separately. If you installed D5 Works Skill in Codex, use the screens below to check that it is installed and enabled. ![verify skill installed](/images/works/mcp/verify-skill-installed.png) D5 Works Skill appears in the Installed list. ![verify skill enabled](/images/works/mcp/verify-skill-enabled.png) D5 Works Skill is enabled, with the toggle switched on. You can start using MCP tools once the MCP search test passes. A missing or unloaded skill, or a failed skill version check, does not prevent normal MCP use. The agent should report MCP connection and optional skill checks separately. For troubleshooting, see section 3. ## 2. Use cases This guide provides a brief demonstration of how to use D5 Works MCP and its skill. Use them at the design stages below by copying the corresponding prompt into your agent. | Your design stage | Required input | Use case | | --- | --- | --- | | Furniture sourcing | Furniture type, style, color, and material | [2.1 Find real-brand sofas](#section-2-1) | | Developing a room scheme | A reference image showing the design direction | [2.2 Find a coordinated furniture set](#section-2-2) | | Exploring alternatives | An image that clearly shows a single furniture item | [2.3 Find similar furniture from a product image](#section-2-3) | | Visualization | Asset category, style, and file format | [2.4 Get free 3D models](#section-2-4) | ### 2.1 Find real-brand sofas from your requirements {#section-2-1} Describe the sofa type, style, color, and material to receive a comparison of three real-brand options. **PROMPT** ```text Help me find three Scandinavian-style two-seater sofas from real brands, with off-white fabric upholstery. Include each sofa's brand, product name, dimensions, material, and source link, and compare the three options in a table. Mark any information you cannot verify as “To be confirmed.” ``` ![case 1 codex result](/images/works/mcp/case-1-codex-result.png) Case 1: Codex conversation and result preview ### 2.2 Find a coordinated furniture set from a reference {#section-2-2} Attach a living-room reference image to receive a coordinated list of a sofa, armchair, coffee table, and floor lamp. **PROMPT** ```text Use D5 Works Skill to find a coordinated set of a two-seater sofa, armchair, coffee table, and floor lamp from real furniture brands that matches the living-room design style in the attached image. Provide a furniture list. ``` ![case 2 attached image](/images/works/mcp/case-2-attached-image.png) ![case 2 codex result](/images/works/mcp/case-2-codex-result.png) Case 2: Codex conversation and result preview Review the combination as a whole, including its colors, shapes, and materials. Use the furniture list to compare individual products and follow up on their sources. ### 2.3 Find similar furniture from a product image {#section-2-3} Attach a clear armchair image to receive three real-brand alternatives with similar forms and styles. **PROMPT** ```text Use D5 Works Skill to find three armchairs from real furniture brands with a similar form and style to the armchair in the attached image. Include product images, brands, product names, and source links, and explain the similarities and main differences from the reference. ``` ![case 3 attached image](/images/works/mcp/case-3-attached-image.png) ![case 3 codex result](/images/works/mcp/case-3-codex-result.png) Case 3: Codex conversation and result preview ### 2.4 Get free 3D models for visualization {#section-2-4} Specify the model category, style, and file formats to receive free 3D model options and their available access methods. **PROMPT** ```text Find three free lounge-chair models in SKP or D5A format on Works, in a simple, modern style, and provide download links. ``` ![case 4 codex result](/images/works/mcp/case-4-codex-result.png) Case 4: Codex conversation and result preview Check the returned format and listed license, then use the available download links. If an asset provides a D5 Launcher action instead, follow that route. After obtaining the model, open or import it in your target software and check scale, materials, and textures. ## 3. FAQ ### 3.1 What should I check if installation fails? | Problem | What to do | | --- | --- | | Authentication fails | Reopen the protected Works API key field, check the key, and replace it if it has expired or been revoked. Reconnect afterward. | | Works tools do not appear | Check that the package is installed and enabled. Restart or reload the agent, then repeat the installation verification. | | MCP works but the skill is missing | Continue using MCP tools. If you want to use the optional skill, ask the agent to check its supporting files and reload if required. | | The agent cannot load the package or securely store the key | MCP requires a client with MCP support and protected credential configuration. Agent Skills support is only needed for the optional skill; a skill package loading failure does not affect an already configured MCP connection. | ### 3.2 Can D5 Works MCP automatically place furniture or render a room? Furniture sourcing and asset access do not automatically place items in a scene. Scene import, placement, and rendering require the appropriate additional tools. Confirm their availability and the result of the requested action. ### 3.3 How do I view a furniture list with images? When using D5 Works Skill, results containing product images are organized into a separate HTML list. Open the file link in the reply to view images, details, and sources. Some images require an internet connection. If an image does not load, ask the agent to check whether its source is still available. ### 3.4 Does every furniture product have a corresponding 3D model? Not necessarily. Real furniture and 3D assets are searched separately, and visual similarity does not establish an exact product match. To find a corresponding model, provide the brand, product name, or source link and ask the agent to verify the relationship. ### 3.5 Why do some assets provide a D5 opening action instead of a download link? Available access methods can differ by asset; follow the returned result. If it provides a D5 Launcher action, use that route or ask the agent to explain the next step. Receiving an opening action does not confirm that the model has loaded; check the result in the target application. ### 3.6 Does a free model mean I can use it for any project? Check the selected asset's listed license and your account access. A FREE catalog label alone does not establish all usage rights. ### 3.7 What if a download link expires or access is denied? Ask the agent to re-check access for the same product and file. For an access restriction, confirm that the connected account has the required entitlement.