APS MCP 인증 예제

Autodesk Platform Services와 통합되는 MCP 서버의 참조 구현으로, 다음의 모든 조합을 다룹니다:

• 서버가 APS에 인증하는 방식

  • 2LO - 2-legged OAuth, 앱 전체

  • 3LO - 3-legged OAuth, 사용자별

  • PKCE - 공개 클라이언트용 3-legged OAuth, 사용자별

  • SSA - 보안 서비스 계정, 비인간 정체성

• MCP 클라이언트가 서버에 인증하는 방식

  • 인증 없음 (STDIO)

  • 외부 ID 공급자(identity provider)를 통한 인증

  • OAuth 프록시 서비스를 통한 인증

모든 HTTP 기반 예제는 분할된 MCP TypeScript SDK v2 (@modelcontextprotocol/{server,express,node})를 통해 2026-07-28 MCP 사양 개정판을 대상으로 합니다. 이는 MCP 서버가 전용 인증 서버(authorization server)를 기반으로 하는 OAuth 2.1 리소스 서버(resource server) 역할을 해야 하며, MCP 클라이언트 식별을 위해 동적 클라이언트 등록(Dynamic Client Registration)보다 **클라이언트 ID 메타데이터 문서(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 프로젝트이므로 한 번의 설치로 shared와 4개의 TypeScript 서버가 모두 해결됩니다.

3. .env.example을 .env로 복사하고 선택한 APS_AUTH_MODE에 맞는 값을 채운 후, 해당 폴더에서 npm start로 TypeScript 예제를 실행합니다 (또는 루트에서 npm run start -w <package-name>).

4. simple-oauth-proxy는 별도의 Python/FastMCP 서비스입니다 — 설정은 자체 README를 참조하세요. aps-mcp-server-remote-proxy를 시도하는 경우에만 필요합니다.

범위에 대한 참고 사항

이것들은 한 번에 처음부터 끝까지 읽을 수 있도록 최적화된 교육용 예제입니다. 간결함을 위해 의도적으로 생략한 몇 가지 부분은 관련 README에 명시되어 있습니다 (수평 확장 방안이 없는 메모리 전용 상태, OAuth 프록시 예제에서 완전한 SSRF 강화 없이 단순화된 CIMD 가져오기 등). 해당 참고 사항을 읽지 않고 보안 관련 부분을 프로덕션에 그대로 복사하지 마세요.