MCP 工具限制

Notice： 适用于 Archicad Collaborate 或 Archicad Max。
MCP 只能执行 Archicad API 公开的操作。当某项操作无法通过该 API 提供时，即使 Archicad 本身可以手动执行，AI 也无法安全地完成该操作。提出 MCP 请求时应考虑以下限制：
  • 参数层次结构：AI 无法将列表项（例如分类、说明图例等）移动到其他父级或组，也无法在其同级项之间重新排序。
  • 无法编辑的元素属性：AI 无法更改字体、字号、字体样式、线型、文本画笔、标签类型或尺寸指针线型。GDL 相关的属性——例如门窗参数、框架宽度和对象参数——通常也无法进行编辑。
  • 可见性与选择：不可见元素尚未完全受支持，因此 AI 或许能够可靠地找到或修改它们，但无法显示不可见元素。用户必须指定是否也要修改不可见元素。
  • 图层组合：无法读取自定义图层组合的内容。AI 只能确定是否存在自定义组合，而无法确定其包含哪些图层设置。
  • 视图和图册设置：无法读取缺失或不适用的视图设置。AI 无法切换到样板布图。AI 还可能在图册上生成不正确的当前翻新过滤器，或在操作中心或报告窗口中改为显示禁用的翻新过滤器。尽管可以通过操作中心、图册、母版图册和报告窗口中的 AI 更改禁用的翻新过滤器，但 Archicad 会显示警告，且结果可能与预期的活动过滤器不符。
  • 尚未调研的功能：列出模型元素未使用的信息或类别、放置外部图形、设置 3D 窗口的日期和时间或访问 3D 视图设置 DPI 的 API 支持尚未得到确认。
  • Archicad 模态对话框：工具调用可能会打开警告或信息对话框，需要用户单击继续或撤销等选项。对话框打开期间，处理将被阻止。目前，AI 无法读取对话框文本，也无法转达用户的选择。在 AI Assistant 中，用户无法提交另一个提示；而使用公共 MCP 时，新的请求会等待，直到直接在 Archicad 中关闭该对话框。如果请求看似卡住，请检查 Archicad——特别是在使用多个显示器时。
  • 当 AI Assistant将收藏夹应用于现有元素时：
    • 结构分析模型参数不会应用
    • 表面值仅在表面替代处于激活状态时才会应用。（相比之下，Archicad 自身的“应用”命令每次都会设置表面。）
    • “排除 ID/起始楼层”设置始终优先（无论元素传递设置中的当前默认值如何）
  • 当 AI Assistant将收藏指定为元素默认设置时：
    • 收藏夹的所有设置均包含在内，包括 ID 和起始楼层。
  • 准确指定属性名称：当您想要查询或修改特定属性时，请明确指定该属性的名称。有些属性名称相似，否则 AI 可能会将它们混淆，从而返回或更改错误的属性——例如：“将墙壁的表面改为 Wooden -Horizontal。”与其这样，不如指定您想要修改哪个表面：“将墙的边缘表面更改为木质 - 水平”