Autograph MCP 服务器

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

AI 应用（例如 Claude Desktop 或 ChatGPT Desktop）称为客户端。客户端通过一组预先定义的工具与 MCP 服务器通信，例如“创建一个星形”或“添加一个噪声生成器”，而 Autograph 会在您打开的项目中执行每一次工具调用。

Autograph MCP 服务器最适合处理定义明确但费时费力的任务，例如：

• 重命名和重新组织层级结构
• 翻译以其他语言命名的资产

这类流程化且往往重复的工作，正是你乐于交给助手处理的任务。像 X 这样的任务，值得让 AI 助手在几分钟内完成，而不是耗费一整个下午手动做同样的工作。同样，日常维护也应该只需一两分钟。 

不会。你可以继续沿用现在的工作方式，并自行决定何时将任务交给它处理。Autograph MCP Server 默认处于关闭状态；启用后，它也只会执行你明确描述的特定任务。项目简报、视觉风格以及每一项创意决策，始终由你掌控。 

不需要。Autograph MCP 服务器内置于 Autograph 中，无需单独安装。Maxon 为该服务器提供支持，以实现 Autograph 与您的 AI 应用之间的连接。

如果您在同一个 AI 应用中设置了第三方服务器，请在使用内置服务器时禁用该服务器。这样，模型就只会看到一套 Autograph 工具。

不收费。Maxon 不会对 Autograph MCP Server 收费；它随 Autograph 一同提供，而 Autograph 本身也是免费的。

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

目前，Maxon 官方支持 Claude Desktop 和 ChatGPT Desktop，您可以直接在 Autograph 的偏好设置中配置其中任意一款。其他支持 MCP 的 AI 应用应该也能正常工作，但 Maxon 尚未对其进行测试，也不提供官方支持。

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

可以。在您自己的计算机上运行模型的应用（例如 LM Studio）同样适用。几乎所有近期推出的模型都能处理基本的 Autograph 任务，而性能更强的模型通常能带来更好的结果。

注意：本地模型会与 Autograph 共用您的显卡。如果模型勉强才能装入显存，就不会给渲染留下任何空间；而速度较慢的模型可能需要一分钟才能创建一个立方体。

您需要完整的 Autograph 应用程序（2027.0 或更高版本），以及您所选 AI 应用的桌面客户端，并且二者必须安装在同一台计算机上。除此之外无需任何其他内容。

请求是否清晰，通常决定了结果的质量。

• 模型。重命名之类的基础任务，几乎任何当前模型都能胜任。需要结合您的项目进行推理的任务则不然，而且小型模型与强大模型之间的差距会迅速拉大。
• 投入程度或推理级别，如果您的应用提供投入程度设置。快速重命名时，低投入就足够了。设置较大型的项目时，则应提高投入程度。不过，有时中等设置反而优于高设置，因为某些模型会过度思考。请据此进行测试。
• 请求。请说明项目元素、帧范围、渲染器，以及您之后打算如何编辑结果。

注意：您在网上看到的演示，很少会展示演示背后的提示词，也很少说明结果经过了多少次尝试。一次就成功的任务只是例外。您应做好与 AI 对话的准备，通常到第二或第三次提示时，结果会有显著改善。 

大部分等待时间都花在 AI 思考上，而不是 Autograph 执行操作上。Autograph 每次真正忙碌的时间只有几分之一秒。

补充一些背景信息：一项任务就是一个循环。模型读取你的请求并选择一条命令。Autograph 执行这条命令，通常只需一瞬间，然后返回结果。模型读取结果、思考并选择下一条命令。这个循环往往会重复数十次，而耗费的几分钟主要都用在思考上。Autograph 的状态栏会显示当前正在运行的命令。如果任务迟迟没有完成，请先查看 AI 应用。

当 MCP 服务器正在处理任务时，最好监控 AI 的活动和进度，但不要同时操作计算机和 Autograph。很多情况下，你的操作可能会与 MCP 服务器的任务发生冲突，或导致 LLM 客户端无法完成流程。如果你想接管操作，最好等待任务完成，或先暂停任务。

模型会根据训练数据给出答案，而这些数据可能早于该功能问世；有些模型甚至声称，官方的 Autograph MCP Server 根本不存在。你可以把这种情况想象成“薛定谔的 MCP”：只有当 AI 观察到它时，相关支持才会存在。

当应用连接时，服务器会告诉模型 Autograph 手册和 SDK 文档的位置。对自身训练数据深信不疑的模型可能会忽略这一提示，因此你可能需要直接要求 AI 查阅最新文档。模型需要通过 AI 应用访问网络，才能查看该网站。

AI 对其工作成果的描述可能会显得过于自信。接受某项内容已修复或完成之前，请检查 X 和 X。

只有你设置过的 AI 应用才能连接到 Autograph。除非你开启远程连接，否则该 MCP 连接的两端也必须在同一台计算机上运行。

可以把它想象成一把锁和一把数字钥匙。首次启动时，Autograph 会为自己创建一把锁和一把配套的钥匙。你设置的每个 AI 应用都会获得这把钥匙的副本，任何没有钥匙的应用都会被阻止。Autograph 会替你交付钥匙，无需你自行复制或粘贴。请妥善保管钥匙，不要将其记录下来，也不要把 AI 应用的设置或 Autograph 偏好设置文件夹放在他人可以访问的位置。

不过，一旦 AI 应用连接成功，它如何处理你的场景就取决于该应用及其提供商——如果你想了解他们如何处理你的数据，请查看其设置。

发出询问的是您的 AI 应用，而不是 Autograph。每个应用都会自行决定询问频率，以及您能否关闭这些提示。例如，Claude Desktop 的提示词输入框左下角设有自动模式。

Autograph 控制的是另一回事。在“编辑”>“偏好设置”>“MCP”下，您可以选择向 AI 提供哪些工具，以及是否允许 AI 运行 Python。

在“工具集”部分中，依次选择“编辑”>“偏好设置”>“MCP”。每个复选框控制一组工具。

详细信息：完整的工具列表及每项工具的功能说明，位于 Autograph 偏好设置文件夹内 MCP 文件夹中的参考文件里（“编辑”>“偏好设置”>“打开偏好设置文件夹…”）。AI 发送的每条命令都会写入同一文件夹中的日志文件，以便审计并确保安全；状态栏会在每次调用运行时显示其状态。

这两项 Python 偏好设置主要涉及安全性和日志记录。选择“允许 exec_python”后，您将允许 AI 助手在会话中运行其自己的 Python 代码，以执行其他工具未涵盖的任何功能。“详细日志记录”功能会记录所有已执行的 Python 代码，以及每次调用的完整参数和结果。

可以。每一批更改都可以使用 Autograph 的撤销功能还原。

如果某一批操作执行到一半失败，已经执行的步骤会保留在场景中，其余步骤则会被跳过。

可以。您可以随时禁用 Autograph MCP 服务器。只需在“编辑 > 偏好设置 > MCP”下取消勾选“启用 MCP 服务器”，或从“扩展”菜单或 Commander 中运行“停止 MCP 服务器”。已连接的应用会立即断开连接，运行“启动 MCP 服务器”即可恢复连接。

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

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

Maxon Capsules 提供高质量的模型、材质等资源，可显著提升您的项目。Autograph MCP 包含相关功能，可在您的项目中搜索并使用 Maxon Capsule 资源库中的资产。

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

有关更多详细信息，请参阅 Maxon 的最终用户许可协议。

一般来说，LLM 通过 MCP 代您完成的工作会生成可完全编辑的 Autograph 项目，但 LLM 的构建方式未必便于后续编辑。

如果您打算自行完善结果，在请求中说明这一点，可以让某些任务的后续编辑更加轻松。例如，生成的动画可能每隔一帧就有一个采用线性插值的关键帧，之后很难手动调整。

答案取决于 AI 是如何构建结果的。由生成的 Python 驱动的绑定，如果没有创建该绑定时的对话记录，任何人都很难修改。如果项目需要交接，请让 AI 使用 Autograph 的标准功能而非 Python 来搭建。

让您的 AI 应用在 Autograph 中创建一个简单的形状，例如星形。如果该形状出现，就说明连接成功。

详细信息：大多数应用也会在已连接的服务器中列出 Autograph。在 Claude Desktop 中，前往 Settings > Connectors 查找 Autograph，并确认 Status 列中显示勾选标记。该服务器也会显示在聊天框的 + 按钮下。连接状态和日志位于 Settings > Developer。

这通常是因为 AI 应用启动时 Autograph 尚未运行。请退出 AI 应用，然后重新启动。

如果重启后问题仍未解决，请再检查两项设置。Autograph MCP Server 默认处于关闭状态，因此请确保已勾选 Enable MCP Server 设置（或者从 Extensions 菜单或 Commander 中运行 Start MCP Server）。此外，如果你点击了 Regenerate Token，大多数应用都会停止工作，直到你在 Clients 部分逐一选择各个应用并再次点击 Update Selected Client，因为这些应用各自保存着旧密钥的副本。

大多数应用会在启动时尝试连接，并等待 Autograph 最多 20 秒。连接成功后，如果你稍后重启 Autograph，应用会自动重新连接；但如果首次连接失败，应用不会再次尝试。有些应用会在登录时启动，并在你关闭其窗口后继续在后台运行。再次打开窗口并不会重启应用。

Autograph 会为自身添加一个条目，并保持文件中的其他所有内容不变。请彻底重启应用，以便应用读取新设置。

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

不会。Autograph 只会修改由其自身写入的条目。

其他所有条目都会保留；每次写入前都会备份文件；如果某个条目并非由 Autograph 写入，系统会报告该情况并保持该条目不变。这同样适用于“更新所选客户端”和“从客户端移除”。

AI 应用无法看到 Autograph 的对话框，因此可能会像什么都没发生一样继续操作。关闭该对话框，将消息内容告诉 AI，并让 AI 在继续之前检查场景。

注意：状态栏会报告失败的调用。单次调用失败属于正常情况，因为模型经常会先尝试某项操作，失败后再使用修正后的调用。

不能。Autograph MCP Server 需要使用 Autograph 界面，并且只能在完整应用程序中运行，无法在 Commandline 或 Team Render 客户端及服务器中运行。