Skip to main content
Glama
deenesjakoruzh
autodesk-platform-services

APS MCP Auth Examples

Official
by autodesk-platform-services
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

APS MCP 身份验证示例

MCP 服务器的参考实现，集成 Autodesk Platform Services，覆盖以下所有组合：

  • 服务器如何向 APS 进行身份验证

    • 2LO - 2-legged OAuth，应用级

    • 3LO - 3-legged OAuth，按用户

    • PKCE - 用于公共客户端的 3-legged OAuth，按用户

    • SSA - 安全服务账户，非人类身份

  • MCP 客户端如何向服务器进行身份验证

    • 完全没有（STDIO）

    • 通过外部身份提供方

    • 通过 OAuth 代理服务

所有基于 HTTP 的示例均面向 2026-07-28 MCP 规范修订版，并基于拆分后的 MCP TypeScript SDK v2（@modelcontextprotocol/{server,express,node}）。该规范要求 MCP 服务器充当 OAuth 2.1 的 资源服务器，由专用授权服务器支持；在标识 MCP 客户端时，更倾向于使用 Client ID Metadata Documents (CIMD) 而非 Dynamic Client Registration。

每个示例都提供相同的 MCP 工具，均在 shared/ 中实现一次并在各处复用：list-projects（通过 Data Management API 获取 hubs 和 projects）和 list-contents（获取某个项目顶层的文件夹，或某个具体文件夹的内容）。

目录

MCP 客户端身份验证

演示内容

aps-mcp-server-local

无（STDIO）

最简单的设置——本地启动的进程，完全没有 MCP 层的身份验证。

aps-mcp-server-remote-auth0

外部 IdP（Auth0）

此服务器只验证令牌；Auth0（或任何符合 OIDC/JWKS 的提供方）仍然是授权服务器。按 IdP 用户缓存的 APS 提供方保存在内存中。

aps-mcp-server-remote-proxy

单独的 OAuth 代理服务

依赖一个位于 APS 认证之前的 OAuth 代理（simple-oauth-proxy）来生成“MCP 令牌”，并使用 /internal/exchange 端点将这些令牌交换为“APS 令牌”。

simple-oauth-proxy

（代理本身）

由 aps-mcp-server-remote-proxy 使用的、独立且与提供方无关的 OAuth 代理服务，基于 Python + FastMCP 构建。

shared

（库）

五个 APS 身份验证提供方类、两个 MCP 工具，以及上面所有示例复用的辅助函数。

所有示例共用的设置

  1. 在 https://aps.autodesk.com/myapps 注册一个 APS 应用（如果你会使用任何 3LO 示例，请选择 传统 Web 应用（Traditional Web App）；如果只使用 2LO，只需 Server-to-Server / API-key 风格的应用即可）。对于 SSA，还需要另外创建一个 Secure Service Account 并注册其公钥——参见 SSA 指南。

  2. 在仓库根目录执行 npm install——这是一个 npm workspaces 项目，一条安装命令即可解析 shared 和所有四个 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 时才需要它。

Related MCP server: Devcon MCP Workshop 2026

关于范围的说明

这些是教学示例，优化用于一口气读完。有几处为了简洁刻意做了简化，并已在相关 README 中标注（例如仅保存在内存中、没有水平扩展方案；OAuth 代理示例中，CIMD 获取方式简化且未对 SSRF 做完整加固，等等）。请不要在未阅读这些注意事项的情况下，将安全性相关的部分直接复制到生产环境。

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • ACC.MCP

    EverseDevelopment
    F
    license
    A
    quality
    C
    maintenance
    An MCP server that exposes Autodesk Platform Services (APS) as tools for AI assistants to interact with the APS Data Management API. It enables users to authenticate and manage hubs, projects, and folders through a standardized interface.
    27
    2
    -
  • APS MCP Auth0 Example by autodesk-platform-services

    APS MCP Auth0 Exampleofficial

    autodesk-platform-services
    F
    license
    Not graded
    quality
    D
    maintenance
    Example MCP server for Autodesk Platform Services that demonstrates proper OAuth authorization with Auth0 as the first layer and APS 3-legged OAuth as the second layer. Enables querying APS projects and issues through natural language after authenticating via Auth0 and APS.
    -

  • MCP Feature Reference Server

    charithadevarinti24-boop
    A
    license
    Not graded
    quality
    D
    maintenance
    A complete MCP server implementation demonstrating all protocol features (tools, resources, prompts, sampling, and elicitation) with OAuth authentication, serving as a learning resource and starting template for building MCP servers.
    MIT