LABSCO SUMMARY
What the assistant can see is decided in ACC, not in the assistant.
The server acts as a Secure Service Account, so its reach is exactly the set of ACC projects that account's email has been invited to: add it to one project and that project is all it sees. It is experimental, and this repository is no longer where the project lives; the README points to autodesk-platform-services/aps-mcp-server-nodejs.
What it is
An experimental Node.js MCP server for the Autodesk Platform Services (APS) API. It signs in as a Secure Service Account, so the assistant reaches only the Autodesk Construction Cloud or BIM 360 projects that account has been invited to. The README says the project has moved to https://github.com/autodesk-platform-services/aps-mcp-server-nodejs; this repository is its original home.
What you get
- Your Autodesk Construction Cloud projects listed — "What ACC projects do I have access to?" is the README's first test prompt
- The issues in a project read back, for example as a visual dashboard of every issue in one project
- Access set by the service account: it reaches only the ACC projects its email has been invited to
- Setups for Claude Desktop, VS Code with Copilot and Cursor, each running the build/server.js you build from the clone
Requirements
Node.js and yarn, an APS app of the Server-to-Server type, and provisioned access to ACC or BIM 360. Build it from a clone, put the app's APS_CLIENT_ID and APS_CLIENT_SECRET in a .env file, then create a service account with the bundled create-service-account script and add the four APS_SA_ values it prints to the same file. Register the app's client ID as a custom integration in ACC and invite the service account's email to the projects it should see. MIT licensed.
Setup effort
Build from source — git clone https://github.com/petrbroz/aps-mcp-server.git
USE CASES
01
Finding out which ACC projects you can reach
Ask which Autodesk Construction Cloud projects the service account can see, without opening ACC.
02
Getting an overview of a project's issues
Ask for a visual dashboard of every issue in one ACC project.
03
Keeping the assistant to the projects it should see
Invite the service account only to those ACC projects; what it can read follows that membership.
BEFORE YOU INSTALL
What to know first
Requires
- Node.js and yarn
- An APS app of the Server-to-Server type (APS_CLIENT_ID and APS_CLIENT_SECRET)
- Provisioned access to ACC or BIM 360
Where it runs
All 3 documented clients run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
git clone https://github.com/petrbroz/aps-mcp-server.git
cd aps-mcp-server
yarn install
yarn run buildCreate a .env file in the project folder with APS_CLIENT_ID and APS_CLIENT_SECRET, the client ID and secret of your APS app (it must be a Server-to-Server application).
Create a service account; the script prints APS_SA_ID, APS_SA_EMAIL, APS_SA_KEY_ID and APS_SA_PRIVATE_KEY. Add them to the same .env file:
TERMINAL
npx create-service-account <YOUR_USERNAME> <YOUR_FIRST_NAME> <YOUR_LAST_NAME>In Autodesk Construction Cloud, register your APS client ID as a custom integration and invite the service account email to your ACC project(s).
MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"autodesk-platform-services": {
"command": "node",
"args": [
"<YOUR_PATH_TO_APS_MCP_SERVER>/build/server.js"
]
}
}
}<YOUR_PATH_TO_APS_MCP_SERVER> is the full path of the folder git clone created.
VS Code
VS CODE · JSON
{
"servers": {
"Autodesk Platform Services": {
"type": "stdio",
"command": "node",
"args": [
"<YOUR_PATH_TO_APS_MCP_SERVER>/build/server.js"
]
}
}
}<YOUR_PATH_TO_APS_MCP_SERVER> is the full path of the folder git clone created.
Cursor
CURSOR · JSON
{
"mcpServers": {
"Autodesk Platform Services": {
"command": "node",
"args": [
"<YOUR_PATH_TO_APS_MCP_SERVER>/build/server.js"
]
}
}
}<YOUR_PATH_TO_APS_MCP_SERVER> is the full path of the folder git clone created.