APS MCP 認証サンプル

Autodesk Platform Services と統合する MCP サーバーのリファレンス実装です。以下のあらゆる組み合わせを網羅しています。

• サーバーが APS に対してどのように認証するか

  • 2LO - 2-legged OAuth（アプリ全体）

  • 3LO - 3-legged OAuth（ユーザー単位）

  • PKCE - パブリッククライアント向け 3-legged OAuth（ユーザー単位）

  • SSA - Secure Service Account（非人間アイデンティティ）

• MCP クライアントがサーバーに対してどのように認証するか

  • 認証なし（STDIO）

  • 外部アイデンティティプロバイダー経由

  • OAuth プロキシサービス経由

HTTP ベースのサンプルはすべて、分割された MCP TypeScript SDK v2 （@modelcontextprotocol/{server,express,node}）を介した 2026-07-28 MCP 仕様改訂版を対象としています。この仕様では、MCP サーバーが専用の認可サーバーに支えられた OAuth 2.1 リソースサーバーとして動作することが求められ、MCP クライアントの識別には Dynamic Client Registration よりも Client ID Metadata Documents（CIMD） が優先されます。

すべてのサンプルは同じ MCP ツールを公開しており、shared/ に一度実装してすべての場所で再利用しています。list-projects（Data Management API によるハブ＋プロジェクト）と list-contents（プロジェクトのトップレベルフォルダー、または特定フォルダーの内容）です。

サンプル一覧

Related MCP server: Devcon MCP Workshop 2026

すべてのサンプルに共通のセットアップ

1. https://aps.autodesk.com/myapps で APS アプリケーションを登録します（3LO のサンプルを使う場合は Traditional Web App、2LO のみの使用であれば Server-to-Server / API キー形式のアプリで十分です）。SSA の場合は、さらに Secure Service Account を作成し、その公開鍵を登録してください — SSA ガイド を参照してください。

2. リポジトリのルートで npm install を実行します — これは npm workspaces プロジェクトなので、1 回のインストールで shared と 4 つの TypeScript サーバーすべてが解決されます。

3. 各フォルダー内で npm start を実行して任意の TypeScript サンプルを起動します（またはルートから npm run start -w <package-name>）。その前に .env.example を .env にコピーし、選択した APS_AUTH_MODE に応じた値を入力してください。

4. simple-oauth-proxy は別の Python/FastMCP サービスです。セットアップは各自の README を参照してください。aps-mcp-server-remote-proxy を試す場合にのみ必要です。

スコープに関する注意

これらは教育用のサンプルであり、一気に通読できるように最適化されています。簡潔さのために意図的に省略したいくつかの点は、各 README で明記されています（水平スケーリングの考慮がないメモリ内のみの状態、OAuth プロキシのサンプルにおける完全な SSRF 対策を施していない簡略化された CIMD フェッチなど）。セキュリティに関わる部分を本番環境にそのままコピーする前に、必ずそれらの注意事項を読んでください。