Cinema 4D MCP 服务器

MCP（模型上下文协议）是一项开放标准，它允许大型语言模型（LLM）（也称为 AI 应用或助手）连接到外部应用程序并使用该应用程序的工具。 Cinema 4D MCP 服务器利用此标准将您的 AI 应用与 Cinema 4D 连接起来，因此您可以使用自然语言描述任务，并看到结果在 Cinema 4D 中呈现。

该 AI 应用（例如 Claude Desktop 或 ChatGPT Desktop）被称为客户端。 客户端通过一组预定义的工具（如“创建对象”或“渲染预览”）与 MCP 服务器进行交互，而 Cinema 4D 则会在您打开的场景中执行每个工具调用。 

Cinema 4D MCP 服务器最适合处理定义明确且耗时的任务，例如：

• 重命名并重新组织层级结构
• 将场景中以其他语言命名的 对象的名称
• 根据客户的电子表格，将对象和材质的变体作为不同版本创建
• 为合成设置对象ID和命名蒙版AOV
• 调试骨骼绑定或表达式
• 编写小型脚本或插件
• 基础建模

这些程序化且往往重复性很强的工作，正是你会乐意交给助理处理的。 像调试和搭建骨骼系统这样的任务，与其花整个下午手动完成，不如让AI助手在几分钟内搞定。同样，例行维护也只需一两分钟。 

不会。你继续按现在的方式工作，由你决定何时将工作移交。Cinema 4D MCP 服务器默认处于关闭状态，启用后仅处理你指定的特定任务。项目要求、视觉风格以及所有创意决策仍由你全权负责。 

不是。Cinema 4D MCP 服务器已内置于 Cinema 4D 中，无需单独安装。Maxon 支持该服务器用于 Cinema 4D 与您的 AI 应用程序之间的连接。

如果您在同一款 AI 应用中设置了第三方服务器，请在使用内置服务器时禁用该第三方服务器。这样，模型将只能看到一套 Cinema 4D 工具。 

不需要，Maxon 不对随 Cinema 4D 附带的 Cinema 4D MCP Server 收取费用。

您需要自行提供 AI 应用程序以及该应用程序调用的模型。如果模型在云端运行，您需要拥有该服务的账户。 任何相关费用均由您与 AI 服务提供商（例如 Anthropic 或 OpenAI）之间结算。通过 LM Studio 等应用在您自己的计算机上运行的模型，则无需注册 AI 服务账户。 

目前，Maxon 官方支持 Claude Desktop 和 ChatGPT Desktop，您可以直接在 Cinema 4D 的首选项中设置其中任意一款。其他支持 MCP 的 AI 应用也应该可以使用，不过 Maxon 尚未对其进行测试，也不提供官方支持。

每个 AI 应用都会保存一个设置文件，其中列出了该应用可能连接的服务器。对于列表中的应用，Cinema 4D 会自动将相应条目写入该文件。 对于其他应用程序，请在 MCP 客户端列表中选择“其他”，然后点击“复制配置”。Cinema 4D 会将相应的条目复制到剪贴板，以便您将其粘贴到目标应用程序中。 

可以。在您自己的计算机上运行模型的应用程序（例如 LM Studio）同样适用。几乎所有较新的计算机都能处理 Cinema 4D 的基本任务，而配置更强的计算机通常能获得更好的效果。

注意：本地模型会与Cinema 4D以及您的渲染器共享显卡资源。如果模型几乎占满显存，就无法为渲染留出空间；而运行缓慢的模型甚至可能需要一分钟才能生成一个立方体。

您需要在同一台计算机上安装完整的 Cinema 4D 应用程序（2026.4 版或更高版本）以及您所选 AI 应用程序的桌面客户端。无需其他任何软件。

模型本身、您让模型投入的精力以及请求的清晰度，通常决定了结果的质量。

• 模型本身。 重命名等基础任务几乎适用于任何当前的模型。但需要对场景进行推理的任务则不然，此时小型模型与强大模型之间的差距会迅速拉大。
• 投入程度或推理级别，如果您的应用提供了投入设置。快速重命名时，低投入设置即可。处理骨骼绑定或渲染设置时，则应提高投入。不过，有时中等设置的效果反而优于高设置，因为某些模型会过度思考。 请据此进行测试。
• 请求内容。 请描述对象、帧范围、渲染器，以及您计划如何后续编辑结果。

注意： 您在网上看到的演示很少会展示演示背后的提示词，也不会显示结果是经过多少次尝试才得出的。 第一次尝试就成功完成的任务属于例外。请做好沟通的准备，通常在第二次或第三次提示时，结果会显著改善。 

这段时间的大部分都花在AI的思考上，而不是Cinema 4D的运算上。Cinema 4D每次只忙上不到一秒的时间。

补充说明一下，一个任务其实是一个循环。模型读取你的请求，然后选择一条指令。 Cinema 4D 执行该命令（通常只需一瞬间），然后返回结果。模型读取结果，进行思考，并选择下一个命令。这个循环通常会重复数十次，而耗费数分钟的时间主要源于思考过程。 Cinema 4D 中的状态栏会显示当前正在执行的命令。如果任务执行缓慢，请先查看 AI 应用程序。

当 MCP 服务器正在处理任务时，最好监控 AI 的活动和进度，但此时请勿同时使用计算机和 C4D。 在许多情况下，您的操作可能会与MCP服务器的任务发生冲突，或阻止LLM客户端完成处理。如果您希望接管控制权，最好等待任务完成，或者暂停该任务。 

模型从训练数据中获取答案，而这些数据可能早于该功能推出，甚至有些模型声称并不存在官方的 Cinema 4D MCP 服务器。不妨将这种情况视为“薛定谔的 MCP”。只有当 AI 观察到它时，支持才存在。

当应用程序连接时，服务器会告知模型 Cinema 4D 手册和 SDK 文档的存储位置。 对训练数据充满信心的模型可能会忽略这一提示，因此您可能需要直接要求 AI 参考最新的文档。该模型需要通过 AI 应用访问网络才能检查该网站。 

AI 对自身工作的描述可能比实际应有的更显自信。在确认某个问题已修复或工作已完成之前，请先检查“对象管理器”和视口。 

只有您设置的 AI 应用才能连接到 Cinema 4D。除非您启用远程连接，否则 MCP 连接的两端都必须在同一台计算机上运行。

想象一把锁和一把数字钥匙。首次启动时，Cinema 4D 会为自己生成一把锁和一把匹配的钥匙。您设置的每个 AI 应用都会获得该钥匙的副本，而任何没有钥匙的应用都会被阻止。Cinema 4D 会自动为您分发钥匙，您无需进行任何复制或粘贴操作。 请务必妥善保管密钥。切勿将密钥记录下来，也不要将 AI 应用的设置或 Cinema 4D 的首选项文件夹存放在他人可访问的地方。

不过，一旦 AI 应用连接成功，它对您的场景进行何种操作则完全取决于该应用及其提供商——如果您想了解它们如何处理您的数据，请查看其设置。

是您的 AI 应用在提问，而不是 Cinema 4D。每个应用都会自行决定提问的频率，以及您是否可以关闭提示功能。例如，Claude Desktop 在提示框的左下角设有“自动”模式。

Cinema 4D 控制的是另一项功能。在“编辑”>“首选项”>“MCP”中，您可以选择向 AI 提供哪些工具，以及是否允许 AI 运行 Python。

在“工具集”部分，位于“编辑”>“首选项”>“MCP”下。 每个复选框控制一组工具。  

详细信息：工具的完整列表及其各自的功能，可在 Cinema 4D 首选项文件夹（“编辑” > “首选项” > “打开首选项文件夹…”）中的 MCP 文件夹内找到的参考文件中查看。 出于审计和安全考虑，AI 发送的每条命令都会写入同一文件夹中的日志文件，状态栏会显示每次调用的运行情况。 

其中一个设置允许 AI 在 Cinema 4D 中运行 Python 代码。另一个设置允许 AI 创建和编辑包含 Python 的对象，例如 Python 标签、生成器和效果器。

这些设置分别称为“允许 exec_python 命令”和“允许包含 Python 的操作”。如果 AI 尝试执行某项被设置阻止的操作，系统会明确指出需要启用的设置名称。在交换场景文件时，请务必注意“允许包含 Python 的操作”这一设置。写入场景中的 Python 代码会在该场景下次被打开时自动运行。

启用任一设置都会允许已连接的 AI 应用在未经您事先审查的情况下编写和运行 Python 代码，因此您需对您账户下运行的内容负责——在信任某个场景之前，请先检查其内容，尤其是您未亲自制作的场景。 将 AI 应用连接到 Cinema 4D 是您的选择，这仅涉及您与该 AI 提供商之间——Maxon 不对此提供任何担保或支持。当您启用 MCP 时，系统会显示相关警告。

是的。每批更改都可以通过 Cinema 4D 的撤销功能撤销。

如果批处理在执行过程中失败，已执行的步骤会保留在场景中，其余步骤将被跳过。

是的。您可以随时禁用 Cinema 4D MCP 服务器。只需在“编辑”>“首选项”>“MCP”下取消勾选“启用 MCP 服务器”，或者从“扩展”菜单或“命令行”中运行“停止 MCP 服务器”即可。已连接的应用程序将立即断开连接，而运行“启动 MCP 服务器”则可恢复连接。

只有在允许远程连接的情况下才行。默认情况下，服务器仅接受来自您自己计算机的连接。  

要向其他计算机开放服务器，需要在“远程访问”下进行三项设置。 启用“允许远程连接”并确认警告，将“主机”设置为其他机器可以访问的地址，并将该机器的 IP 地址（或地址范围，例如 192.168.1.0/24）添加到“白名单 IP”中。 不要在完成第一个设置后就停止。仅开启远程连接并不能让任何人进入，因为来自列表中未包含的地址的请求会被拒绝。基于浏览器的应用程序也需要将其地址列入“浏览器客户端源”中。远程连接未加密，因此请仅在您信任的网络上使用远程访问。 

Maxon Capsules 提供高品质的模型、材质等资源，可大幅提升您的项目质量。Cinema 4D MCP 包含相关功能，可帮助您在项目中搜索并引入 Maxon Capsules 资源库中的资产。

请注意，虽然 Maxon Capsules 授权最终用户将其用于商业项目，但不得将其用于训练 AI。为确保您的场景数据不会被用于训练 AI 模型，您通常可以在 AI 工具的偏好设置中禁用相关选项。 在连接 AI 提供商之前，您应仔细查阅该 AI 提供商的数据使用和训练政策。

更多详情，请参阅 Maxon 的 《最终用户许可协议》。

通常情况下，LLM 在 MCP 中为您完成的工作会生成可完全编辑的 Cinema 4D 项目，但 LLM 构建的内容未必总是便于编辑的。

如果您计划自行调整生成的结果，在请求中说明这一点有助于在某些任务中简化操作。例如，生成的动画可能每隔一帧就设置一个采用线性插值的关键帧，这会使后续手动调整变得困难。

答案取决于AI是如何生成该结果的。由生成的Python代码驱动的场景设置，如果没有生成该设置的对话记录，任何人都很难进行修改。在需要交接的情况下，请让AI提供一个使用Cinema 4D标准功能而非Python的设置方案。 

请让您的 AI 应用在 Cinema 4D 中创建一个简单形状，例如一个立方体。如果该形状出现，说明已成功连接。

详细信息：大多数应用也会将 Cinema 4D 列在其支持连接的服务器中。在 Claude Desktop 中，请前往“设置”>“连接器”，查找“cinema4d”，并确保“状态”列中带有勾选标记。该服务器也会显示在聊天框中的“+”按钮下方。连接状态和日志位于“设置”>“开发者”中。

这通常是因为在启动 AI 应用时，Cinema 4D 尚未运行。 请退出 AI 应用并重新启动它。

如果重新启动后问题仍未解决，请检查以下两点。Cinema 4D MCP 服务器默认处于关闭状态，因此请确保已勾选“启用 MCP 服务器”设置（或从“扩展”菜单或 Commander 中运行“启动 MCP 服务器”）。 此外，如果您点击了“重新生成令牌”，大多数应用程序将停止工作，直到您在“客户端”部分中分别选中每个应用程序并再次点击“更新所选客户端”，因为这些应用程序会保留旧密钥的副本。

大多数应用程序在启动时会尝试连接，并等待长达 20 秒以等待 Cinema 4D 响应。 一旦连接成功，如果您稍后重新启动 Cinema 4D，应用程序会自动重新连接，但如果首次连接失败，应用程序将不会重试。某些应用程序会在登录时启动，并在您关闭其窗口后继续在后台运行。再次打开窗口不会重新启动该应用程序。 

Cinema 4D 会为自身添加一条条目，并保持文件中的其他内容不变。请完全重启该应用程序，以便其读取新设置。

Cinema 4D 在写入前会保存文件的备份。如果您的应用程序不在列表中，或者 Cinema 4D 无法找到列表中某个应用程序的设置文件，请选择“其他”，点击“复制配置”，然后手动粘贴该条目。

不。Cinema 4D 仅会修改其自身创建的条目。

其他所有条目均予以保留，每次写入前都会对文件进行备份，而对于非 Cinema 4D 创建的条目，系统会进行报告并保持原样。这同时适用于“更新选定客户端”和“从客户端移除”操作。

请检查“编辑”>“首选项”>“MCP”下的“工具集”部分。如果模型无法识别某项工具，会将该功能报告为“缺失”，而非“已禁用”。选择“全选”可恢复完整工具集，且更改将在重启AI应用后生效。

反向操作同样有效。如果 AI 持续选择错误的工具，请关闭不需要的组。列表越短，模型越容易做出选择，且模型需要处理的上下文信息也越少。

请注意，MCP 使用的是 Cinema 4D 的 Python API。 Cinema 4D 的 Python API 功能全面，几乎可以访问 Cinema 4D 中的所有内容，包括场景节点和 Redshift 材质。不过，由于 API 覆盖范围存在缺口，某些内置功能或第三方插件可能无法被访问。

该 AI 应用无法识别 Cinema 4D 的对话框，可能会继续运行，仿佛什么都没发生一样。请先关闭对话框，向 AI 说明消息内容，并让 AI 检查场景后再继续。

注意：状态栏会报告调用失败。单次调用失败属于正常现象，因为模型通常会先尝试执行操作，失败后再进行修正后的调用。

创建数百个独立对象的任务可能会导致速度变慢，甚至在执行中途卡住。请让 AI 将这些工作合并为数量较少但规模更大的对象，或者分批处理。

不。Cinema 4D MCP 服务器需要 Cinema 4D 界面，且仅能在完整版应用程序中运行，不能在命令行、Team Render 客户端和服务器、c4dpy、Cineware 或 Lite 中运行。