跳到文档内容
搜索文档
浏览文档
语言中文
EnglishFrançais中文NederlandsDeutschالعربيةहिन्दी

API 和 MCP

从对话到图纸

将 Claude、ChatGPT 或其他 AI 工具连接到 Occlusia 的 MCP 服务器，批准它，只需提出要求，就能完成从上传到导出的全过程。

连接并批准

  1. 01

    添加地址

    在您的 AI 工具中，添加一个远程 MCP 服务器，地址为 https://api.occlusia.app/v1/mcp——在 Claude 中，位于 Settings、Connectors、Add custom connector。

  2. 02

    在 occlusia.app 上登录

    工具首次调用 Occlusia 时，会打开 occlusia.app：如有需要请先登录。这就是 OAuth：工具永远看不到您的密码，也无需复制任何密钥。

  3. 03

    批准应用

    页面会说明是哪个应用提出请求——若有则显示其经过验证的身份——、它将把您送回哪里，以及它将能做什么。只有在您刚刚亲自连接了它时才允许它。

  4. 04

    回到对话

    工具已连接。它会出现在您账户中的 已连接的应用 下，您可以随时在那里断开它。

一个模型，从上传到导出

您提出的要求，以及 AI 用 Occlusia 的工具所做的事。用您自己的话提问即可：AI 会自行阅读 Occlusia 的指南和参考。

  1. 01

    “打开我的模型”

    AI 会给您一个页面链接，您在其中拖放您的 .skp、.ifc、.fbx 或 .occs 模型，或 .occp 项目——或者从您提供的公开链接获取。打开它消耗一点。

  2. 02

    “里面有什么？”

    它会列出模型的视图、按分组排列的对象，以及注释和标高。列出是免费的。

  3. 03

    “用 AR-CONC 填充混凝土，剖切线用 BOLD”

    它会修改您指定对象的设置——如果您提供 .occc 文件，则整体应用您的配置。

  4. 04

    “给我看 Section A-A”

    它会绘制该视图并看到图像，因此可以检查自己的成果并展示给您。每次新的绘制消耗一点；再次绘制同一张图纸则免费。

  5. 05

    “将 Section A-A 和平面图导出为一份 1:50 的 A3 PDF”

    它会导出，并为每个文件给您一个下载链接。PDF 每页消耗一点。

工作区

  • AI 所打开、设置和导出的内容，在使用期间会保留在您的工作区中，在不同请求之间、不同对话之间都不会丢失。工作区在闲置 15 分钟后结束，其文件随之删除。
  • workspace_status 会说明工作区里有什么；请 AI 重置工作区即可重新开始。
  • 保留重要的内容：请求将项目 (.occp) 或配置 (.occc) 作为下载文件。

AI 工具能看到什么

您的 AI 工具会收到 Occlusia 的工具所返回的内容——模型对象和视图的名称、它绘制的预览、下载链接——其提供方按自己的条款保留这些内容。Occlusia 只在您的工作区中保留您的文件，并在工作区结束时删除它们。

改用 API 密钥

会发送请求头的工具，可以用 API 密钥代替 OAuth。服务器支持 MCP 2026-07-28，并向下兼容 2025-11-25 至 2025-03-26。

claude mcp add --transport http occlusia https://api.occlusia.app/v1/mcp \
  --header "Authorization: Bearer occ_sk_…"
使用 Claude Code，或在其他 AI 工具的 MCP 设置中。