Примеры аутентификации APS MCP

Эталонные реализации MCP-серверов, интегрирующихся с Autodesk Platform Services, охватывающие все комбинации:

• Как сервер аутентифицируется в APS

  • 2LO — двухногий OAuth, на уровне приложения

  • 3LO — трёхногий OAuth, на уровне пользователя

  • PKCE — трёхногий OAuth для публичных клиентов, на уровне пользователя

  • SSA — Secure Service Account, нечеловеческая идентичность

• Как MCP-клиенты аутентифицируются на сервере

  • никак (STDIO)

  • через внешнего поставщика идентичности

  • через OAuth-прокси-сервис

Все примеры на основе HTTP нацелены на редакцию спецификации MCP от 2026-07-28 через разделённый MCP TypeScript SDK v2 (@modelcontextprotocol/{server,express,node}), который требует, чтобы MCP-серверы выступали в роли OAuth 2.1 серверов ресурсов, поддерживаемых выделенным сервером авторизации, и предпочитает Client ID Metadata Documents (CIMD) вместо Dynamic Client Registration для идентификации MCP-клиентов.

Каждый пример предоставляет одни и те же MCP-инструменты, реализованные один раз в shared/ и переиспользуемые везде: list-projects (хабы + проекты, через Data Management API) и list-contents (папки верхнего уровня проекта или содержимое конкретной папки).

Примеры

Related MCP server: Devcon MCP Workshop 2026

Настройка, общая для всех примеров

1. Зарегистрируйте приложение APS на https://aps.autodesk.com/myapps ( Traditional Web App, если вы будете использовать какой-либо пример с 3LO; приложения в стиле Server-to-Server / API-ключ достаточно для использования только 2LO). Для SSA дополнительно создайте Secure Service Account и зарегистрируйте его открытый ключ — см. руководство по SSA.

2. Выполните npm install в корне репозитория — это проект npm workspaces, поэтому одна установка разрешает shared и все четыре TypeScript-сервера.

3. Запустите любой TypeScript-пример с помощью npm start из его папки (или 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 (состояние только в памяти без поддержки горизонтального масштабирования, упрощённая выборка CIMD без полной защиты от SSRF в примере с OAuth-прокси и т.д.). Не копируйте дословно фрагменты, связанные с безопасностью, в продакшн, не прочитав эти примечания.