aps-mcp-server

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

Screenshot

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 (let's call it test-account-1): npx create-service-account test-account-1
- This script will output an email of the newly created service account, and a bunch of 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 prompt:
- 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.