Autodesk Product Help MCP

Autodesk 产品帮助 MCP

让任何兼容 MCP 的 AI 客户端都能以只读方式访问 Autodesk 官方帮助与支持文档。

开始使用 · 工具 · 示例 · 故障排除 · 文档

Autodesk® 产品帮助是一款模型上下文协议（MCP）服务，可将 AI Agent 直接连接到 Autodesk 官方产品文档，涵盖 110 多种产品，包括 Autodesk Fusion®、AutoCAD®、Revit®、Inventor®、Maya®、Civil 3D® 等。它是一种安全的只读接口，可让 AI 工具搜索、浏览并检索可信的 Autodesk 帮助内容。它支持自然语言查询、加快新用户上手，并为基于权威 Autodesk 产品文档构建的智能 Agent 提供可靠基础。

主要功能：

• 使用自然语言提出支持问题。
• 更快地学习和上手 Autodesk 产品。
• 为 AI Agent 和自动化奠定基础。
• 支持 10 种语言和 40 个地区设置。

要求：

• 无特殊要求。

关于 Autodesk

全球的设计师、工程师、建筑商和创作者都信赖 Autodesk，借助它来设计和制造各种事物。从我们居住和工作的建筑，到我们驾驶的汽车和跨越的桥梁；从我们使用和依赖的产品，到启发我们的电影和游戏。Autodesk 的 Design and Make Platform 释放数据的力量，以加速洞察并自动化流程，为客户提供技术支持，帮助他们创造我们周围的世界，并为其业务和地球带来更好的成果。详情请访问 autodesk.com。

重要

此服务由 Autodesk 托管和运营，因此无需在本地安装或运行任何内容。ai-integrations 仓库中的此文件夹包含 MCP Registry 元数据（server.json）和设置文档。

示例提示词

连接后，可以尝试向助手提问：

• 操作方法：“在 AutoCAD 中，如何使用图层特性管理器创建和管理图层？”或“在 AutoCAD 或 Civil 3D 中，如何使用 Spec Editor 为管道组件创建并指定自定义特性？”
• 故障排除：“在 Revit 中，为什么视图中看不到链接的 CAD 文件？如何排查此问题？”或“AutoCAD 错误 1603 是什么意思？”
• 开始使用：“我是 Revit 新手。请给我一份放置墙体的入门教程。”或“此帮助涵盖哪些 Autodesk 产品？”
• 账户和账单：“如何登录 Autodesk 账户？”或“如何将试用版升级为付费订阅？”

开始使用

端点： https://api.aps.autodesk.com/knowledge/public/v1/mcp

任何支持通过可流式传输的 HTTP 连接远程服务的 MCP 客户端，都可以连接到此 URL。无需凭据。可通过 https://api.aps.autodesk.com/knowledge/public/health 进行运行状况检查。

在 Claude 或 ChatGPT 中使用

Autodesk Product Help 已列入这两款应用，因此无需任何配置即可连接：

• Claude：Claude 目录中的 Autodesk Product Help
• ChatGPT：ChatGPT 中的 Autodesk Product Help

将服务添加到客户端

claude mcp add --transport http autodesk-product-help \
  https://api.aps.autodesk.com/knowledge/public/v1/mcp

{
  "mcpServers": {
    "autodesk-product-help": {
      "url": "https://api.aps.autodesk.com/knowledge/public/v1/mcp"
    }
  }
}

{
  "servers": {
    "autodesk-product-help": {
      "type": "http",
      "url": "https://api.aps.autodesk.com/knowledge/public/v1/mcp"
    }
  }
}

{
  "mcpServers": {
    "autodesk-product-help": {
      "serverUrl": "https://api.aps.autodesk.com/knowledge/public/v1/mcp"
    }
  }
}

import asyncio

from mcp import ClientSession
from mcp.client.streamable_http import streamable_http_client

MCP_URL = "https://api.aps.autodesk.com/knowledge/public/v1/mcp"

async def main() -> None:
    async with streamable_http_client(MCP_URL) as (read, write):
        async with ClientSession(read, write) as session:
            await session.initialize()
            result = await session.call_tool(
                "search_help_content",
                {"query": "AutoCAD error 1603", "locale": "en_US"},
            )
            structured = result.structured_content or {}
            for doc in structured.get("results", []):
                print(doc["title"], doc["url"])


if __name__ == "__main__":
    asyncio.run(main())

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const MCP_URL = "https://api.aps.autodesk.com/knowledge/public/v1/mcp";

const client = new Client({ name: "example", version: "1.0.0" });
await client.connect(new StreamableHTTPClientTransport(new URL(MCP_URL)));

const { structuredContent } = await client.callTool({
  name: "search_help_content",
  arguments: { query: "AutoCAD error 1603", locale: "en_US" },
});

for (const doc of structuredContent?.results ?? []) {
  console.log(doc.title, doc.url);
}

await client.close();

让 Agent 为你完成设置

将以下内容粘贴到你的 AI 编码 Agent 中：

Add the Autodesk Product Help MCP server to this environment.
Use the setup documentation at https://github.com/Autodesk/ai-integrations/tree/main/product-help/remote-mcp-server
and the endpoint https://api.aps.autodesk.com/knowledge/public/v1/mcp
(Streamable HTTP, no authentication). Verify the connection with initialize and tools/list.

验证连接

curl -sS -X POST https://api.aps.autodesk.com/knowledge/public/v1/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{
        "protocolVersion":"2025-06-18","capabilities":{},
        "clientInfo":{"name":"curl","version":"1.0"}}}'

成功的响应会将 serverInfo.name 报告为 autodesk-knowledge-public-v1-mcp-server。

工具

该服务提供两个工具。两者均标注为只读、非破坏性且幂等。

get_available_products

以 { product_name, product_code, release_codes } 对象列表的形式返回产品目录。此工具不接受参数。

需要有效的 product_code 或 release_code 来缩小搜索范围时，请调用此工具。发行版代码是 2025 这样的标识符，而不是“AutoCAD 2025”这样的显示名称。目录可能会随时间变化，因此请将此工具视为权威列表，而不要将值硬编码。

search_help_content

搜索 Autodesk 文档和支持文章，并返回最相关的文档。

每个结果都包含 title、url、locale、body（全文或摘录）、media_type 和 source。响应还会包含 total_results。

调用示例：

{
  "name": "search_help_content",
  "arguments": {
    "query": "AutoCAD Error 1603 install failed",
    "locale": "en_US",
    "product_code": "ACD",
    "max_results": 3
  }
}

面向 Agent 的最佳实践

• 如果已知产品，请直接调用 search_help_content。只有在需要查找或验证产品或版本代码时，才调用 get_available_products。
• 如果无法将产品或版本映射到 get_available_products 中的确切值，请省略该筛选条件，不要猜测。
• 让 query 包含丰富的关键词：包括产品和功能或任务，尽可能保留用户的措辞，并包含确切的错误文本或代码。
• 使用与 locale 相同的语言编写 query，并根据用户的上下文确定 locale，不要猜测。
• 请引用所用每项结果的 url，以便用户阅读原文。

故障排除

MCP 客户端和 SDK 会为你处理 HTTP 相关细节。以下 HTTP 错误主要影响直接调用端点的自定义集成。

HTTP 错误

工具错误

工具调用失败时，HTTP 请求仍会成功。工具结果中的 isError: true 表示出错，其文本以以下代码之一开头，后面会说明问题所在及修复方法。大多数 Agent 可以读取此消息并自行修正请求。

没有结果

如果 search_help_content 返回 total_results: 0，请逐一移除 release_code、product_code 和 sources 筛选条件，或使用该产品对相关功能的术语改写 query。

报告问题

每次请求都请在 x-request-id 标头中发送一个新的 UUID。服务器会在响应中返回相同的值。请在提交问题时附上该值，以便追踪请求。

安全与数据处理

• 此服务为只读服务。工具仅检索已发布的帮助与支持内容，无法更改任何数据。
• 公共端点无需身份验证，也不会访问 Autodesk 账户或客户数据。
• 请勿在 query 或其他工具参数中填写密码、许可证密钥、访问令牌或其他个人或敏感数据。
• 如需报告安全漏洞，请遵循 Autodesk 漏洞披露政策，并通过 Autodesk on HackerOne 提交报告。请勿为安全报告提交公开问题。

关于此代码库

ai-integrations 代码库是 Autodesk AI 集成的官方分发渠道。此文件夹 product-help/remote-mcp-server 存放 Autodesk 产品帮助 MCP 文件。

product-help/remote-mcp-server/
├── server.json   # MCP Registry metadata
├── README.md     # Setup and usage documentation
└── LICENSE.md

server.json 遵循 MCP Registry 架构，用于将服务发布到 Official MCP Registry。

请参阅 server.json，了解当前的注册表名称、版本和远程端点。

server.json 由 Autodesk 维护，仅在发布服务新版本时更改。

参与贡献

欢迎为文档和客户端设置示例做出贡献。

1. Fork 此代码库，并为你的更改创建一个分支。
2. 提交 pull request，说明更改内容及测试方法，例如使用上文的 curl 检查。

托管服务并非基于此代码库构建。如需提出功能请求，或报告服务本身的问题，请提交问题。

支持

• 设置、注册表元数据或本文档：提交问题。
• **关于 Autodesk 产品的问题：**请访问 Autodesk Community 论坛。

许可证和条款

LICENSE.md 仅适用于此代码库中的文件，不适用于托管服务或该服务返回的 Autodesk 内容。

使用 Autodesk Product Help MCP 服务须遵守 Autodesk 使用条款和隐私声明。