APS MCP Auth Examples

Implementaciones de referencia de servidores MCP que se integran con Autodesk Platform Services, que cubren todas las combinaciones de:

• Cómo se autentica el servidor ante APS

  • 2LO - OAuth de dos patas, a nivel de aplicación

  • 3LO - OAuth de tres patas, por usuario

  • PKCE - OAuth de tres patas para clientes públicos, por usuario

  • SSA - Secure Service Account, identidad no humana

• Cómo se autentican los clientes MCP ante el servidor

  • sin autenticación (STDIO)

  • mediante un proveedor de identidad externo

  • mediante un servicio de proxy OAuth

Todos los ejemplos basados en HTTP apuntan a la revisión de la especificación MCP del 2026-07-28 mediante el MCP TypeScript SDK v2 dividido (@modelcontextprotocol/{server,express,node}), que exige que los servidores MCP actúen como servidores de recursos OAuth 2.1 respaldados por un servidor de autorización dedicado, y prefiere los Client ID Metadata Documents (CIMD) sobre el Dynamic Client Registration para identificar a los clientes MCP.

Cada ejemplo expone las mismas herramientas MCP, implementadas una vez en shared/ y reutilizadas en todos: list-projects (hubs + proyectos, a través de la API de Data Management) y list-contents (las carpetas de nivel superior de un proyecto, o el contenido de una carpeta específica).

Los ejemplos

Related MCP server: Devcon MCP Workshop 2026

Configuración común a todos los ejemplos

1. Registra una aplicación APS en https://aps.autodesk.com/myapps (una Traditional Web App si vas a usar cualquier ejemplo 3LO; una aplicación Server-to-Server / de estilo clave de API es suficiente para uso solo con 2LO). Para SSA, crea además una Secure Service Account y registra su clave pública; consulta la guía de SSA.

2. npm install en la raíz del repositorio: este es un proyecto de npm workspaces, por lo que una sola instalación resuelve shared y los cuatro servidores TypeScript.

3. Ejecuta cualquier ejemplo TypeScript con npm start desde dentro de su carpeta (o npm run start -w <package-name> desde la raíz), después de copiar su .env.example a .env y completar los valores para tu APS_AUTH_MODE elegido.

4. simple-oauth-proxy es un servicio Python/FastMCP independiente; consulta su propio README para la configuración; solo es necesario si estás probando aps-mcp-server-remote-proxy.

Una nota sobre el alcance

Estos son ejemplos didácticos, optimizados para leerse de principio a fin de una sentada. Se han tomado varios atajos intencionalmente por brevedad, que se señalan en el README correspondiente (estado solo en memoria sin una estrategia de escalado horizontal, una obtención de CIMD simplificada sin un endurecimiento completo contra SSRF en el ejemplo del proxy OAuth, etc.). No copies los fragmentos relevantes para la seguridad textualmente a producción sin leer esas notas.