📌Overview

Purpose: To provide an experimental Model Context Protocol server that enables access to Autodesk Platform Services API with enhanced security features.

Overview: The aps-mcp-server is built using Node.js and serves as a bridge to access the Autodesk Platform Services API. It leverages the Secure Service Accounts feature for improved access control, ensuring users can manage permissions effectively while interacting with Autodesk's suite of applications.

Key Features:

• Fine-Grained Access Control: Enables the use of Secure Service Accounts for more precise management of API access, improving security and compliance.

• Ease of Use Setup: Streamlined installation and setup process, allowing developers to quickly configure and deploy the server with minimal effort.

---

aps-mcp-server

Experimental Model Context Protocol server built with Node.js, providing access to Autodesk Platform Services API, with fine-grained access control using the new Secure Service Accounts feature.

Development

Prerequisites

• Node.js
• APS app credentials (must be a Server-to-Server application type)
• Provisioned access to ACC or BIM360

Setup

• Clone this repository
• Install dependencies: yarn install
• Build the TypeScript code: yarn run build
• Create a .env file in the root folder of this project, and add your APS credentials:
  • APS_CLIENT_ID - your APS application client ID
  • APS_CLIENT_SECRET - your APS application client secret
• Create a new service account (e.g., test-account-1): npx create-service-account test-account-1
  • This script will output an email of the newly created service account and several environment variables
• Add or overwrite the new environment variables in your .env file:
  • APS_SA_ID - your service account ID
  • APS_SA_EMAIL - your service account email
  • APS_SA_KEY_ID - your service account key ID
  • APS_SA_PRIVATE_KEY - your service account private key
• Invite the service account email as a new member to your ACC project(s)

Use with Inspector

• Run the Model Context Protocol Inspector: yarn run inspect
• Open http://localhost:5173
• Hit Connect to start this MCP server and connect to it

Use with Claude Desktop

• Make sure you have Claude Desktop installed
• Create a Claude Desktop config file if you don't have one yet:
  • On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • On Windows: %APPDATA%\Claude\claude_desktop_config.json
• Add this MCP server to the config, using the absolute path of the build/server.js file on your system, for example:

{
  "mcpServers": {
    "autodesk-platform-services": {
      "command": "node",
      "args": [
        "/absolute/path/to/aps-mcp-server/build/server.js"
      ]
    }
  }
}

• Open Claude Desktop, and try some of the following test prompts:
  • What ACC projects do I have access to?
  • Give me a visual dashboard of all issues in project XYZ

For more details on how to add MCP servers to Claude Desktop, see the official documentation.