使用前须知
什么是 MCP？
**MCP（Model Context Protocol，模型上下文协议）**是一项开放标准，AI 应用可以通过它连接其他软件，并使用软件提供的工具执行操作。
Cinema 4D 提供 MCP 服务器和工具，您需要准备 AI 客户端及其使用的模型。连接后，您只需用自然语言说明想做什么，客户端就会选择相应的工具，由 Cinema 4D 在当前打开的文档中执行操作。
更多说明请参阅帮助指南。
这就是网上那些 Cinema 4D MCP 服务器吗？
不是。网上已有一些开源的 Cinema 4D MCP 服务器，需要单独下载安装。这里介绍的是 Cinema 4D 内置的服务器，无需额外安装，也是 Maxon 官方支持的连接方式。
如果您的客户端同时配置了第三方 Cinema 4D MCP 服务器，请在使用内置服务器时将其关闭。否则，模型会同时收到两套功能重叠的工具，容易选错。
可以使用哪些客户端？哪些经过了官方验证？
MCP 首选项中，客户端（Clients）页面的列表列出了 Maxon 已验证的客户端。
未列出的客户端也可能兼容，但尚未经过官方测试。要连接这类客户端，请选择 Other，点击 Copy Config，再将复制的内容手动粘贴到客户端的配置文件中。
这段配置只有几行文本，包含服务器 IP 地址、端口，以及身份验证令牌和令牌文件位置等连接信息。请妥善保管，不要随意共享，也不要存放在他人可以访问的位置。
Maxon 的支持范围是 Cinema 4D 与客户端之间的连接。至于模型如何使用这些工具、能否正确完成任务，则取决于您选择的模型和客户端，Maxon 无法控制。
需要注册 AI 服务账号吗？
如果使用云端模型，需要注册相应服务的账号；如果模型在您自己的电脑上运行，则不需要。
Cinema 4D 免费提供 MCP 服务器，客户端和模型由您自行准备。使用云端模型产生的费用，由您与相应的服务提供商结算。
可以使用本地模型吗？
可以。使用本地模型的客户端，连接方式与其他客户端一样。不过，使用前需要考虑硬件资源和运行速度。
如果模型几乎占满显存，就没有多少显存可供渲染使用。另外，即使是较小的模型，在消费级显卡上也可能需要一分钟才能创建一个立方体。请根据实际性能安排工作。
在本页提到的各项因素中，模型的选择对结果影响最大。重命名、整理层级等简单操作，当前的大多数模型都能胜任。但如果任务需要理解和分析场景，模型之间的能力差距就会明显体现出来，任务越复杂，差距越大。
需要安装什么？
在同一台电脑上安装完整版 Cinema 4D 和 AI 客户端即可，无需安装其他组件，也不需要 Node.js 等独立运行环境。
能在 Commandline、Team Render 或 c4dpy 中使用吗？
不能。MCP 服务器需要 Cinema 4D 的用户界面，只能在完整版应用程序中运行。
在 Commandline、Team Render 客户端和服务器、c4dpy、Cineware 以及 Lite 中，MCP 服务器不会运行，也不会显示任何提示。
--
建立连接
怎样确认连接正常？
让客户端创建一个立方体。如果立方体出现在场景中，就说明连接正常。
连接成功后，大多数客户端也会在已连接的服务器列表中显示 Cinema 4D，并提供状态指示和日志。
连接步骤请参阅快速入门。
为什么首选项中没有 MCP 页面？
MCP 服务器已经内置于完整版 Cinema 4D。如果首选项中没有 MCP 页面，通常是启动时未能正常初始化，而不是少装了某个组件。
目前发现，安全软件可能导致这种情况。服务器通过 Python 初始化，如果杀毒软件或终端防护软件对 Python 的运行进行了拦截，Cinema 4D 虽然仍能启动，但首选项中不会出现 MCP 页面。
请检查安全软件是否拦截了 Cinema 4D 中的 Python，并在必要时添加例外。如果是公司管理的电脑，请联系 IT 部门处理。
服务器（Server）帮助页面也有相关说明。
客户端没有显示 Cinema 4D 工具，该检查什么？
最常见的原因是启动顺序：客户端启动时，Cinema 4D 还没有运行。
服务器运行在 Cinema 4D 内部，因此必须先启动 Cinema 4D。客户端启动时通常只会等待一小段时间。如果首次连接失败，一般不会自动重试；而在已经连接成功的情况下，之后退出并重新启动 Cinema 4D，客户端通常可以自动重连。
许多客户端会随系统登录自动启动，关闭窗口后也会继续在后台运行。因此，您以为刚刚启动了客户端，它实际上可能早已在后台运行。
请按以下顺序操作：
- 完全退出客户端。 如果客户端仍在系统托盘或菜单栏中运行，请在任务管理器或活动监视器中结束其剩余进程。
- 启动 Cinema 4D。 确认服务器（Server）页面中的 Allow MCP Server 已启用。
- 重新启动客户端。
如果仍然没有显示工具，请再检查以下两项：
- 在 Edit > Preferences > MCP 中，确认 Allow MCP Server 已勾选。
- 如果配置客户端后重新生成过令牌，请参阅下文令牌需要保密吗？。
点击 Update Selected Client 后，为什么配置文件看起来没变？
Update Selected Client 只会写入 Cinema 4D 的配置条目，不会改动文件中的其他内容，因此变化可能不太明显。
更新后，必须完全退出并重新启动客户端，它才会读取新配置。
如果 Cinema 4D 找不到所选客户端的配置文件，请选择 Other，点击 Copy Config，然后手动将配置粘贴到客户端的配置文件中。
我已经在使用其他 MCP 服务器。Cinema 4D 会改动它们的配置吗？
不会。Update Selected Client 和 Remove from Client 只会修改或移除 Cinema 4D 自己写入的条目。
写入前，程序会先备份配置文件，并保留其他所有条目。如果遇到并非由 Cinema 4D 创建的 MCP 服务器条目，程序会提示您，并保持该条目不变。
客户端不在列表中，还能连接吗？
可以。选择 Other，点击 Copy Config，再把复制的配置粘贴到客户端自己的配置文件中即可。
如果您希望自己编辑配置文件，也可以采用这种方式，无需让 Cinema 4D 直接修改客户端配置。
怎样移除客户端配置？
点击 Remove from Client 即可。
程序会先备份配置文件，再移除 Cinema 4D 的条目。客户端本身不受影响，只是在下次启动时，不再通过这项连接提供 Cinema 4D 工具。
其他电脑上的客户端能连接吗？
可以，但需要专门设置，不会自动开放给其他电脑。
您需要调整三项设置，具体步骤请参阅远程访问（Remote Access）页面。仅开启 Allow Remote Connections，只是让服务器监听更多网络地址，并不会改变允许哪些客户端连接。
还需要检查 Whitelisted IPs。这个字段默认填有一个私有子网范围，服务器一旦开始监听网络可访问的接口，该白名单就会生效。请在设置远程连接时一并确认。
由于连接未经加密，请仅在可信网络中使用。
--
使用 AI 助手
它适合做哪些工作？
它适合处理要求明确、操作繁琐，而且您能清楚描述的任务，例如：
- 重命名对象、整理层级。
- 将外部场景中的对象名称翻译成另一种语言。
- 根据电子表格，通过 Take 系统建立不同版本。
- 为合成设置对象 ID 和命名遮罩 AOV。
- 查找绑定在某一帧失效的原因。
- 编写小型脚本。
这类工作主要依赖明确的步骤和重复操作，而不是创意判断。
不同任务也应有不同的时间预期。排查场景问题或搭建绑定，手动处理可能要花一个下午，等待几分钟通常值得。日常整理则应在一两分钟内完成；如果迟迟没有结果，自己操作可能更快。
怎样才能达到演示中的效果？
主要看三点：使用的模型、客户端提供的推理或投入等级，以及您如何描述任务。
简单的重命名操作，使用较低等级即可。搭建绑定或设置渲染时，可以选择较高等级，但要考虑自己能接受多长的等待时间。最高等级也不一定最好，有些模型思考得更多，表现反而更差，实际测试比直接选最高档更可靠。
提出任务时，请说明对象名称、帧范围、渲染器，以及之后准备如何修改结果。尽量与助手进行沟通，并让它在开始前先询问不清楚的地方。
演示很少展示完整的提示词和尝试次数。实际使用中，一次就得到理想结果并不常见。
助手能看到场景吗？
通常，AI 客户端与 Cinema 4D 之间只交换文本、命令，以及获准执行的脚本。它并不会自动看到屏幕画面，因此可能误解场景，例如判断错对象的旋转方向。
您可以允许客户端进行渲染，让助手通过视口内容，或专门为它设置的摄像机视图，检查场景和操作结果。除此之外，常规通信不会传输屏幕画面。
如果助手对场景的理解不对，很可能是它没有查看您所指的那部分内容。
可以相信它对场景的描述吗？
请先检查实际结果。
助手通过工具读取和修改场景，但即使结果不够可靠，它也可能说得很肯定。在接受“已完成”或“已修复”的结论前，请查看对象管理器和视口，确认是否符合要求。
助手工作时，为什么 Cinema 4D 像是卡住了？
大部分等待时间来自模型的思考，而不是 Cinema 4D 执行操作。一项任务通常按以下过程进行：
- 您提出要求，模型理解任务并选择工具。此时 Cinema 4D 没有执行操作。
- 客户端发送命令，Cinema 4D 在主线程中执行。执行期间无法响应用户输入，但大多数命令只需不到一秒。
- Cinema 4D 返回结果，模型分析结果并决定下一步。此时 Cinema 4D 再次处于空闲状态。
- 重复步骤 2 和 3，往往需要数十次调用，直到任务完成。
只有步骤 2 的执行时间由 Cinema 4D 控制。服务器（Server）页面中的 Request Timeout 限制的是单条命令的运行时间，超时后该命令会被放弃。
这项设置不会限制模型在步骤 1 和 3 中花费的思考时间，而较长的等待通常发生在这两个阶段。
状态栏会显示正在执行的工具。如果任务比预期慢，请先查看客户端窗口，了解模型当前在做什么。
助手说 Cinema 4D 不支持某项功能，但明明支持，怎么办？
模型可能依据旧的训练数据作答。这些数据可能早于某项功能，甚至早于 MCP 服务器的推出，因此有些模型会声称这个服务器根本不存在。
建立连接时，服务器会向模型提供 Cinema 4D 手册和 SDK 文档的位置，但不会强制它查阅。模型如果过于相信已有知识，就可能忽略这些资料。
您可以直接告诉它功能名称和所在菜单，并要求它先查阅文档再回答。为此，客户端需要允许模型访问网页。
为什么找不到某个工具？
通常有两种原因：
- 工具所属的组在工具集（Toolset）页面中没有开启。点击 Select All 可以启用全部工具。之后需要重启客户端，让它重新读取工具列表。
- 工具需要运行 Python，但安全（Security）页面中的相应选项已关闭。调用被拒绝时，提示会指出需要启用哪项设置。
模型看不到某个工具时，可能会说该功能不存在，而不会意识到它只是被关闭了。因此，不要仅凭模型的回答就认定 Cinema 4D 无法完成某项操作。
如果助手总是选错工具，也可以关闭用不到的工具组。可选工具减少后，模型往往更容易选对。
创建大量小对象时，为什么执行到一半就停了？
逐个创建数百个对象，例如为每个元素建立一条样条，可能使任务明显变慢，甚至中途停止。
可以让助手减少对象数量，将内容合并为一个网格或一条样条，也可以分批完成。
能撤销助手的修改吗？
可以。每一批修改都会记录为一个撤销步骤。
如果某一批操作中途失败，已完成的修改会留在场景中，剩余操作不再执行。只需撤销一次，就能撤销这一批已经完成的全部修改。
助手工作时，Cinema 4D 弹出了错误提示，该怎么办？
客户端看不到 Cinema 4D 的对话框，因此可能不知道出了错，还会继续操作。失败的调用会显示在状态栏中。
请关闭对话框，将错误信息告诉助手，并让它先检查场景，再继续执行任务。
--
使用 AI 助手
为什么每一步都要我批准？能关闭吗？
批准提示由客户端发出，不是 Cinema 4D。
多久询问一次、是否可以关闭提示，都由客户端决定。批准方式、会话历史和模型行为也由客户端管理，无法在 Cinema 4D 中调整。
Cinema 4D 负责限制客户端可以执行哪些操作：
- 工具集（Toolset）：开放哪些工具组。
- 安全（Security）：是否允许运行 Python。
- 远程访问（Remote Access）：是否允许其他电脑上的客户端连接。
两项 Python 设置有什么区别？
Allow exec_python Command 允许助手直接在 Cinema 4D 中运行 Python 代码。
Allow Python-Bearing Operations 允许助手创建或编辑带有 Python 代码的对象，例如 Python 标签、生成器和效果器。
全新安装时，这两项默认开启。如果调用被拒绝，提示会说明需要启用哪项设置。如果您之前使用过测试版服务器，请检查这两个选项，因为早期版本不会为已有安装自动开启它们。
重要：
与他人交换场景文件时，请注意 Allow Python-Bearing Operations 这一选项。
保存在场景中的 Python 代码，会在场景下次打开时运行，即使是在另一台电脑上打开。因此，如果您需要发送或接收场景文件，请关闭这一选项。
在哪里查看助手的权限和操作记录？
工具集（Toolset）页面列出了可开放的工具组，每组都有对应的复选框。
完整的工具列表和说明保存在首选项文件夹下的 mcp 子文件夹中。点击 Open Preferences Folder… 即可打开首选项文件夹。
同一位置还保存了审计日志，记录客户端发起的每一次调用。状态栏会在执行过程中显示调用及其成功或失败的状态。
调用失败不一定说明连接有问题。模型有时会先尝试一种方法，失败后再修正调用，因此偶尔出现失败是正常的。
日志（Logging）页面可以设置记录哪些内容，以及是否在调用被拒绝时，立即在控制台中显示提示。
场景数据会被发送到电脑之外吗？
MCP 服务器本身不会主动向外发送数据。它只接收请求并返回结果，默认也只允许本机访问。
不过，返回给客户端的数据如何处理，取决于客户端。
如果客户端使用云端模型，就会将对话内容发送到服务提供商的服务器，包括工具返回的结果。例如，助手读取了场景中的对象名称，这些名称就会成为对话的一部分，并随对话发送给云端服务。
如果您对数据保密有要求，请查阅客户端的数据处理说明，或使用本地模型。
令牌需要保密吗？
需要。Cinema 4D 首次启动时会生成身份验证令牌，每个客户端连接时都必须提供它。设置客户端时，程序会自动提供所需的令牌信息，您无需手动操作，也不应自行抄录。
请不要将客户端配置文件或 Cinema 4D 首选项文件夹放在共享位置。
不同客户端保存令牌的方式不同：有些配置引用首选项文件夹中的令牌文件，有些则直接保存令牌。因此，执行 Regenerate Token 后，处理方式也有所不同：
- 引用令牌文件的配置会自动读取新令牌。
- 直接保存令牌的配置仍使用旧值，连接会因此失效。请在客户端（Clients）页面中选择该客户端，再次点击 Update Selected Client 更新配置。
通过网络连接时，令牌以未加密的形式传输。请像保护其他身份验证凭据一样保护它；如果可能已经泄露，请重新生成。
不退出 Cinema 4D，能停止服务器吗？
可以。在服务器（Server）页面中关闭 Allow MCP Server，或在扩展菜单、Commander 中执行 Stop MCP Server。
已连接的客户端会立即断开。执行 Start MCP Server 即可重新启动服务器，无需重启 Cinema 4D。
--
编辑与交接
助手生成的内容，还能手动修改吗？
通常可以，但不一定容易调整。
例如，生成的动画可能每隔两帧就有一个关键帧，并使用线性插值，后续修改会比较麻烦。
如果您准备继续手动调整，请在提出任务时说明，让助手考虑后续编辑的需要。
同事能接手修改吗？
取决于助手采用了什么方法。
如果绑定依赖自动生成的 Python 代码，接手的人又没有当时的对话记录，理解和修改都会比较困难。
如果项目需要交接，请要求助手使用 Cinema 4D 的标准功能搭建，避免依赖 Python 控制器。
评论
0 条评论
文章评论已关闭。