APS MCP App

What it does

APS MCP App brings Autodesk Platform Services directly into your AI workflow. It renders an interactive 3D viewer inside MCP-compatible clients, letting you browse Autodesk Construction Cloud projects, preview design files (Revit, AutoCAD, Navisworks, and more), and inspect individual elements — all without leaving your conversation.

When you ask about a design, the MCP App opens a full APS Viewer with orbit, pan, and zoom controls. Select any element in the viewer and its ID is reported back to the LLM for follow-up questions like "Tell me more about this beam" or "What material is this wall?"

Key features

• Interactive 3D viewer — Full APS Viewer with orbit, pan, zoom, and element selection embedded as an MCP App UI resource
• Project browsing — List and navigate Autodesk Construction Cloud projects and their folder contents
• Design hierarchy & properties — Drill into the design structure and retrieve element metadata
• Element selection feedback — IDs of clicked elements are sent back to the LLM for contextual follow-up
• SVF2 & SVF1 support — Defaults to SVF2 for faster loading; switch to SVF1 via query parameter
• Multi-region — Supports UK+4 regions with automatic hub detection
• Secure Service Account auth — Uses Autodesk's SSA API for server-to-server authentication

Installation

Claude.ai (HTTP)

Add the MCP server URL in Claude.ai Settings → Integrations:

https://aps-mcp-app-example.autodesk.io/mcp

Claude Desktop (HTTP)

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "aps-mcp-app": {
      "url": "https://aps-mcp-app-example.autodesk.io/mcp"
    }
  }
}

Self-hosted

git clone https://github.com/autodesk-platform-services/aps-mcp-app-example
cd aps-mcp-app-example
npm install
# Configure .env with APS_CLIENT_ID, APS_CLIENT_SECRET, SSA_ID, SSA_KEY_ID, SSA_KEY_BASE64
npm run build
npm start

Server listens at http://localhost:3000/mcp.

Supported hosts

• Claude.ai (via HTTP transport)
• Claude Desktop
• Any MCP client supporting HTTP transport and MCP Apps