Autodesk Product Help MCP

Autodesk Product Help MCP

あらゆるMCP互換AIクライアントに、Autodeskの公式ヘルプおよびサポートドキュメントへの読み取り専用アクセスを提供します。

はじめに · ツール · プロンプトの例 · トラブルシューティング · ドキュメント

Autodesk® Product Helpは、Model Context Protocol（MCP）サーバーです。Autodesk Fusion®、AutoCAD®、Revit®、Inventor®、Maya®、Civil 3D®など、110以上の製品に関するAutodeskの公式製品ドキュメントにAIエージェントを直接接続します。安全な読み取り専用インターフェースとして、AIツールから信頼できるAutodeskヘルプコンテンツを検索、閲覧、取得できます。これにより、自然言語での問い合わせに対応し、導入を加速させ、Autodeskの信頼できる製品ドキュメントに基づくインテリジェントなエージェントの確かな基盤を提供します。

主な機能：

• 自然言語でサポートに関する質問ができます。
• Autodesk製品の学習と導入をより迅速に進められます。
• AIエージェントと自動化の基盤を構築できます。
• 10言語、40ロケールに対応しています。

要件：

• 特別な要件はありません。

Autodeskについて

世界中のデザイナー、エンジニア、建設業者、クリエイターが、あらゆるものの設計と製作を支援するAutodeskを信頼しています。私たちが暮らし、働く建物から、運転する車、渡る橋まで。日々使用し、頼りにしている製品から、私たちにインスピレーションを与える映画やゲームまで。AutodeskのDesign and Make Platformは、データの力を引き出して洞察を加速し、プロセスを自動化します。これにより、お客様はテクノロジーを活用して私たちを取り巻く世界を創造し、ビジネスと地球環境の双方にとってより良い成果を実現できます。詳しくは、autodesk.comをご覧ください。

重要

このサービスはAutodeskがホストおよび運用しているため、ローカルでインストールや実行を行う必要はありません。ai-integrationsリポジトリ内のこのフォルダーには、MCP Registryのメタデータ（server.json）とセットアップドキュメントが含まれています。

プロンプトの例

接続したら、アシスタントに次のように質問してみてください。

• 操作方法：「AutoCADで、Layer Properties Managerを使って画層を作成、管理するにはどうすればよいですか？」または「AutoCADまたはCivil 3Dで、Spec Editorを使って配管コンポーネントにカスタムプロパティを作成し、割り当てるにはどうすればよいですか？」
• トラブルシューティング：「Revitで、リンクしたCADファイルがビューに表示されないのはなぜですか？また、問題を解決するにはどうすればよいですか？」または「AutoCADのエラー1603は何を意味しますか？」
• はじめに：「Revitを使うのは初めてです。壁を配置する初心者向けチュートリアルを教えてください。」または「このヘルプでは、どのAutodesk製品を扱っていますか？」
• アカウントと請求：「Autodeskアカウントにサインインするにはどうすればよいですか？」または「試用版を有料サブスクリプションにアップグレードするにはどうすればよいですか？」

はじめに

エンドポイント： https://api.aps.autodesk.com/knowledge/public/v1/mcp

Streamable 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();

エージェントにセットアップを任せる

これを AI コーディングエージェントに貼り付けます。

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 が表示されます。

ツール

このサーバーは 2 つのツールを公開します。どちらも読み取り専用、非破壊的、冪等として注釈付けされています。

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
  }
}

エージェント向けのベストプラクティス

• 製品がすでにわかっている場合は、search_help_content を直接呼び出してください。製品またはリリースコードを検索、検証する必要がある場合に限り、get_available_products を呼び出してください。
• 製品またはリリースを get_available_products の正確な値に対応付けられない場合は、推測せずにそのフィルターを省略してください。
• query にはキーワードを豊富に含めてください。製品と機能またはタスクを含め、可能な限りユーザーの表現をそのまま使い、正確なエラー文やコードがあれば含めてください。
• query は locale と同じ言語で記述し、locale は推測せずユーザーのコンテキストから選んでください。
• 使用する各結果の url を引用し、ユーザーが元の記事を読めるようにしてください。

トラブルシューティング

MCP クライアントと SDK は HTTP の詳細を処理します。以下の HTTP エラーのほとんどは、エンドポイントを直接呼び出すカスタム統合に影響します。

HTTP エラー

ツールのエラー

ツールの呼び出しが失敗しても、HTTP リクエストは成功します。ツールの結果には isError: true が含まれ、テキストは以下のコードのいずれかで始まり、その後にエラーの原因と解決方法が続きます。ほとんどのエージェントはこのメッセージを読み取り、リクエストを修正できます。

検索結果がない場合

search_help_content が total_results: 0 を返した場合は、release_code、product_code、sources の各フィルターを一度に 1 つずつ削除するか、機能について製品独自の用語を使って query を言い換えてください。

問題の報告

リクエストごとに新しい UUID を含む x-request-id ヘッダーを送信してください。サーバーは同じ値をレスポンスで返します。リクエストを追跡できるよう、issue を作成する際にその値を記載してください。

セキュリティとデータの取り扱い

• このサービスは読み取り専用です。ツールは公開済みのヘルプおよびサポートコンテンツのみを取得し、データを変更することはできません。
• パブリックエンドポイントでは認証は不要で、Autodesk アカウントや顧客データにアクセスすることもありません。
• query やその他のツール引数に、パスワード、ライセンスキー、アクセストークン、その他の個人情報や機密情報を入力しないでください。
• セキュリティの脆弱性を報告するには、Autodesk Vulnerability Disclosure Policyに従い、Autodesk on HackerOneから報告を送信してください。セキュリティ報告について、公開 issue を作成しないでください。

このリポジトリについて

ai-integrationsリポジトリは、Autodesk AI インテグレーションの公式配布先です。このフォルダー product-help/remote-mcp-server には、Autodesk Product Help MCP ファイルが含まれています。

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

server.jsonはMCP Registry schemaに準拠しており、サーバーをOfficial MCP Registryに公開するために使用されます。

現在のレジストリ名、バージョン、リモートエンドポイントについては、server.jsonを参照してください。

server.json は Autodesk によって管理され、サービスの新しいバージョンが公開される場合にのみ変更されます。

コントリビューション

ドキュメントやクライアントのセットアップ例へのコントリビューションを歓迎します。

1. リポジトリをフォークし、変更用のブランチを作成してください。
2. 変更内容とテスト方法を説明したプルリクエストを作成してください。たとえば、上記の curl チェックを使用できます。

ホストされているサービスは、このリポジトリからビルドされるものではありません。機能のリクエストやサービス自体の問題については、issue を作成してください。

サポート

• セットアップ、レジストリのメタデータ、またはこのドキュメント： issue を作成してください。
• Autodesk 製品に関する質問： Autodesk Community forumsをご利用ください。

ライセンスと利用条件

LICENSE.md の適用対象は、このリポジトリ内のファイルのみです。ホスト型サービスや、サービスが返す Autodesk のコンテンツは対象外です。

Autodesk Product Help MCP server の利用には、Autodesk の利用規約およびプライバシーに関する声明が適用されます。