APS MCP Server

v1.0.0Cloud Servicesstable

Experimental Node.js server implementing the Model Context Protocol for accessing Autodesk Platform Services API with fine-grained access control using Secure Service Accounts.

aps-mcp-servermcpai-integration
Share:
39
Stars
0
Downloads
0
Weekly
0/5

What is APS MCP Server?

APS MCP Server is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to experimental node.js server implementing the model context protocol for accessing autodesk platform services api with fine-grained access control using secure service accounts.

Experimental Node.js server implementing the Model Context Protocol for accessing Autodesk Platform Services API with fine-grained access control using Secure Service Accounts.

This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Experimental Node.js server implementing the Model Context P

Use Cases

Access Autodesk APIs
Integrate with Autodesk platform services
petrbroz

Maintainer

LicenseMIT License
Languagetypescript
Versionv1.0.0
UpdatedMay 11, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx aps-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use APS MCP Server

APS MCP Server is an experimental Node.js MCP server that connects AI assistants to the Autodesk Platform Services (APS) API, enabling them to query Autodesk Construction Cloud (ACC) projects, retrieve project issues, and generate visual dashboards through natural language. It uses Secure Service Accounts for fine-grained access control, ensuring the AI agent only accesses the APS resources the service account is explicitly granted permissions to see. It is intended for AEC (Architecture, Engineering, Construction) teams who want to interrogate their Autodesk data without writing API calls manually.

Prerequisites

  • Node.js 16 or later with yarn package manager
  • An Autodesk Platform Services account with an APS application (client ID and secret)
  • A Secure Service Account created in APS with appropriate permissions
  • Claude Desktop or another MCP-compatible client
1

Clone the repository

Clone the APS MCP Server repository. Note: the canonical repository has moved to autodesk-platform-services/aps-mcp-server-nodejs.

git clone https://github.com/petrbroz/aps-mcp-server.git
cd aps-mcp-server
2

Install dependencies

Install Node.js dependencies using yarn.

yarn install
3

Build the server

Compile the TypeScript source to the build directory.

yarn run build
4

Create a Secure Service Account

Use the included utility to create a service account for fine-grained APS access. You will need your APS_CLIENT_ID and APS_CLIENT_SECRET.

export APS_CLIENT_ID=your_client_id
export APS_CLIENT_SECRET=your_client_secret
npx create-service-account your-username "First" "Last"
5

Configure Claude Desktop to use the built server

Add the built server to claude_desktop_config.json using the absolute path to the compiled server.js file.

{
  "mcpServers": {
    "autodesk-platform-services": {
      "command": "node",
      "args": ["/absolute/path/to/aps-mcp-server/build/server.js"],
      "env": {
        "APS_CLIENT_ID": "your_client_id",
        "APS_CLIENT_SECRET": "your_client_secret",
        "APS_SA_ID": "your_service_account_id",
        "APS_SA_EMAIL": "[email protected]",
        "APS_SA_KEY_ID": "your_key_id",
        "APS_SA_PRIVATE_KEY": "-----BEGIN RSA PRIVATE KEY-----\n..."
      }
    }
  }
}

APS MCP Server Examples

Client configuration

Claude Desktop config for APS MCP Server with all required Autodesk credentials.

{
  "mcpServers": {
    "autodesk-platform-services": {
      "command": "node",
      "args": ["/absolute/path/to/aps-mcp-server/build/server.js"],
      "env": {
        "APS_CLIENT_ID": "your_aps_client_id",
        "APS_CLIENT_SECRET": "your_aps_client_secret",
        "APS_SA_ID": "your_service_account_id",
        "APS_SA_EMAIL": "[email protected]",
        "APS_SA_KEY_ID": "your_key_id",
        "APS_SA_PRIVATE_KEY": "-----BEGIN RSA PRIVATE KEY-----\nMIIE..."
      }
    }
  }
}

Prompts to try

Example natural language queries for Autodesk Construction Cloud data.

- "What ACC projects do I have access to?"
- "Give me a visual dashboard of all open issues in project 'Office Tower Phase 2'."
- "List all RFIs submitted in the last two weeks for the Harbor Bridge project."
- "How many issues are currently in 'In Review' status across all my ACC projects?"

Troubleshooting APS MCP Server

Server fails to start with missing environment variable errors

All six environment variables (APS_CLIENT_ID, APS_CLIENT_SECRET, APS_SA_ID, APS_SA_EMAIL, APS_SA_KEY_ID, APS_SA_PRIVATE_KEY) are required. Verify each is set correctly in the env block of your config. Ensure the private key has newlines properly escaped as \n.

Queries return empty results or 403 errors

The service account must be granted access to the specific ACC hubs and projects you want to query. In the APS admin console, assign the service account to the relevant ACC account and project members list. Access is not inherited from the parent APS application.

'yarn run build' fails with TypeScript errors

Ensure you are using a compatible Node.js version (16+). Run 'node --version' and 'yarn --version' to verify. Delete the node_modules directory and run 'yarn install' again before rebuilding.

Frequently Asked Questions about APS MCP Server

What is APS MCP Server?

APS MCP Server is a Model Context Protocol (MCP) server that experimental node.js server implementing the model context protocol for accessing autodesk platform services api with fine-grained access control using secure service accounts. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install APS MCP Server?

Follow the installation instructions on the APS MCP Server GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with APS MCP Server?

APS MCP Server works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is APS MCP Server free to use?

Yes, APS MCP Server is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Cloud Services MCP Servers

Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "aps-mcp-server": { "command": "npx", "args": ["-y", "aps-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use APS MCP Server?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides