Problem: You connected an AI app, such as the Claude desktop app or the ChatGPT/Codex desktop app, to Cinema 4D through the built-in MCP server, but the app does not offer any Cinema 4D tools. It may say it cannot reach Cinema 4D, report that its connection was refused, or simply act as if Cinema 4D is not there.
This article walks through the checks in the order we recommend, starting with the most common cause.
Where to find the MCP settings
All the settings mentioned in this article are on one page in the Cinema 4D preferences:
- Open Edit > Preferences. On macOS, you can also use Cinema 4D > Preferences.
- The Preferences window opens with a list of categories in the column on the left. Click MCP, which is the last item at the bottom of that list.
- The MCP page opens on the right. It is split into sections, each with a heading in capital letters: SERVER, CLIENTS, SECURITY, TOOLSET, REMOTE ACCESS and LOGGING.
Click each section below to expand it and see the steps. Work through them in order, starting from the top.
1. Start Cinema 4D before the AI app
This is the most common reason the Cinema 4D tools don't show up.
The MCP server runs inside Cinema 4D, so it only exists while Cinema 4D is open. When your AI app starts, it waits about 20 seconds for Cinema 4D. If Cinema 4D is not running by then, the app gives up and does not try again on its own. Once a connection has worked, the app does reconnect automatically if you quit and restart Cinema 4D later.
This is easy to miss, because many AI apps start when you log in and keep running in the background after you close their window. The app you think you are opening may have been running for hours.
Follow these steps in this order:
- Quit the AI app completely. Closing its window is not enough, because many apps keep running in the background.
- Windows: right-click the app's icon in the system tray (the bottom right of the taskbar) and choose Quit. Then open Task Manager (Ctrl+Shift+Esc) and end any processes with the app's name, for example Claude, that are still running.
- macOS: click the app's icon in the menu bar at the top of the screen and choose Quit, or press Cmd+Q while the app is in front. Then open Activity Monitor and quit any processes with the app's name that are still running.
- Start Cinema 4D and make sure the MCP server is turned on. The server is off by default after installation. On the MCP page in the preferences, look at the SERVER section and make sure Allow MCP Server is checked. You can also open the Commander (Shift+C), type Start MCP Server and run it.
- Start the AI app.
2. Check the error message in the AI app
Depending on the app, it may show an error message that points to the cause:
- "cannot reach the Cinema 4D MCP server": Cinema 4D is not running, Allow MCP Server is turned off, or the Port in the SERVER section was changed after the app was set up. If you changed the Port, either change it back, or click Update Selected Client in the CLIENTS section and then restart the app. The MCP server may also have failed to start, even if Allow MCP Server is checked. If the settings look correct, check Cinema 4D's Python Console as described in section 5.
- "the Cinema 4D MCP server rejected this token (401)": the token was changed with Regenerate Token after the app was set up. Quit the app completely and start it again. If it is still refused, click Update Selected Client in the CLIENTS section, then restart the app again.
3. Check the app's status in Cinema 4D
On the MCP page, look at the CLIENTS section and click the MCP Client drop-down list. Each AI app shows its status in brackets after its name:
- (configured): Cinema 4D has set up this app and nothing has changed since.
- (not set up): Cinema 4D has not set up this app yet.
- (needs updating): something changed since the app was set up, for example the token was regenerated, or Cinema 4D was updated or reinstalled.
- (not installed): Cinema 4D cannot find this app on your computer. Install the app and start it once, then try again.
For "not set up" or "needs updating", select the app in the list, click Update Selected Client, then quit the app completely and start it again as described in section 1.
The status is checked when the Preferences window opens. If you just changed a setting, close the Preferences window and open it again to see the current status.
4. Check your antivirus or security software
If everything above looks fine, but the AI app still does not offer any Cinema 4D tools, or it reports that the server disconnected right after it connects, your security software may be blocking the connection.
Your AI app and Cinema 4D both run on your computer and talk to each other through the local address 127.0.0.1. Some security software checks this local traffic as if it were a website, and can cut off the list of Cinema 4D tools before the AI app receives it. The feature that does this is usually called something like Web Protection, Web Shield, Web Filtering or HTTPS scanning.
To test whether your security software is the cause:
- Quit the AI app completely, as described in section 1.
- Open your security software, find its web protection feature, and turn it off for a few minutes. Many security apps let you choose how long it stays off, and turn it back on automatically after that.
- Make sure Cinema 4D is running with the MCP server turned on, then start the AI app and check whether the Cinema 4D tools appear.
If the tools appear, turn web protection back on and add this address as an exception, so your security software stops checking this one connection:
http://127.0.0.1:5556
The exception settings are usually in the web protection settings, under a name like Exceptions, Exclusions or Allowed websites. Quit the AI app completely and start it again after you add the exception.
http://127.0.0.1:5556. Don't use a wildcard such as http://127.0.0.1/* or http://127.0.0.1:*. A wildcard stops your security software from checking every local connection on your computer, including connections from other programs.Steps for specific security software
We'll add steps here for other security software as we confirm them.
Avast
- Quit the AI app completely, as described in section 1.
- Open Avast and turn off Web Shield:
- Avast One: go to Explore > Web Shield, click Open Web Shield, click the green ON slider, then click Continue.
- Avast Antivirus: go to Protection > Core Shields and switch off Web Shield.
- When Avast asks how long, choose 10 minutes. Web Shield turns itself back on after that.
- Make sure Cinema 4D is running with the MCP server turned on, then start the AI app and check whether the Cinema 4D tools appear.
- If the tools appear, turn Web Shield back on and add
http://127.0.0.1:5556as an exception. In most Avast versions, you'll find exceptions under Menu > Settings > General > Exceptions. If you changed the Port in the SERVER section of the MCP preferences, replace 5556 with your number. Don't use a wildcard such ashttp://127.0.0.1/*. - Quit the AI app completely and start it again.
5. Check Cinema 4D's Python Console for server errors
If Cinema 4D is running and Allow MCP Server is checked, but your AI app still cannot connect, the MCP server may have run into an error while starting.
Third-party plugins can sometimes load Python libraries that conflict with the ones the MCP server uses. When this happens, the server may fail to start even though Allow MCP Server is still checked. The error output helps Maxon Support find the cause.
To copy the Console output for us:
- In Cinema 4D, open Extensions > Console. This is Cinema 4D's own Console, not Windows PowerShell, the macOS Terminal, or a console in your AI app.
- In the Console, select the Python entry.
- Leave the Console open, go to the MCP page in the preferences, and turn Allow MCP Server off and back on. This makes sure any startup error shows up in the Console.
- Click inside the Console text. Press Ctrl+A (Windows) or Cmd+A (macOS) to select everything, then press Ctrl+C or Cmd+C to copy it. You can also right-click in the Console and choose Copy.
- Paste the text into a text file, for example in Notepad on Windows or TextEdit on macOS.
- Submit a support ticket and attach the text file.
In your ticket, also include your Cinema 4D version, your operating system, the name of your AI app, and a list of the third-party plugins you have installed.
Keep your token private
Still not working?
If you have worked through everything above and your AI app still does not offer the Cinema 4D tools, send us a log package collected with the Maxon Support Tool. If Cinema 4D's Python Console shows an error, attach the Console text from section 5 as well. Include your Cinema 4D version, your operating system, the name of your AI app, and any troubleshooting steps you have already tried.
Here's how to gather and send them: How to use the Maxon Support Tool to gather logs for Maxon Technical Support.
If you are still experiencing issues after following these steps, please submit a support ticket, and our team will be happy to assist you further.
Comments
0 comments
Article is closed for comments.