Adds Claude desktop installation guide

Provides a step-by-step guide with screenshots
for installing the APS MCP bundle in the Claude desktop app.

This allows users to easily configure and use the
APS MCP tools within the Claude environment.

Author: pderendinger-everse

README.md

@@ -116,6 +116,8 @@ This project can be packed as an [MCP Bundle](https://github.com/modelcontextpro
 
    Open `acc-mcp.mcpb` in Claude for macOS or Windows (or any app that supports MCPB). You’ll be prompted for **APS Client ID** and **APS Client Secret**; the app will pass them to the server as environment variables.
 
+   > For a step-by-step walkthrough with screenshots, see [docs/claude-desktop-installation.md](docs/claude-desktop-installation.md).
+
 The `manifest.json` at the repo root follows the [MCPB manifest spec](https://github.com/modelcontextprotocol/mcpb/blob/main/MANIFEST.md) (manifest_version 0.3, Node server, `user_config` for credentials).
 
 ## License

docs/01.png

@@ -0,0 +1,82 @@
+# Installing the APS MCP in Claude Desktop
+
+This guide walks through installing the **Autodesk Platform Services (APS) MCP** bundle directly from the Claude desktop app.
+
+## Prerequisites
+
+- [Claude desktop app](https://claude.ai/download) installed
+- An [APS application](https://aps.autodesk.com/) with a **Client ID** and **Client Secret**
+- The `acc-mcp.mcpb` bundle (build it with `npm run pack` or download it from releases)
+
+---
+
+## Step 1 – Open Extensions Settings
+
+In the Claude desktop app, go to **Settings → Extensions**.
+
+You will see the Extension Settings panel with options for auto-updates and the built-in Node.js runtime for MCP servers. To install the bundle, click **Install Extension** at the bottom of the page.
+
+![Claude desktop Extensions settings](01.png)
+
+> **Note:** "Use Built-in Node.js for MCP" is enabled by default. This means the app uses its own bundled Node.js runtime (24.x) instead of any system-installed version, so Node.js does not need to be installed on your machine.
+
+---
+
+## Step 2 – Preview and Install the Extension
+
+After selecting the `.mcpb` file, Claude shows a preview of the extension before installing.
+
+![APS MCP extension preview](02.png)
+
+The preview displays:
+
+- **Name:** Autodesk Platform Services (APS) MCP
+- **Description:** MCP server for Autodesk Platform Services: get tokens, list hubs, and call APS APIs.
+- **Developer:** Pablo Derendinger
+- **Tools (27):** `aps_login`, `aps_logout`, `aps_get_token`, `aps_dm_request`, `aps_list_hubs`, `aps_list_projects`, `aps_get_top_folders`, `aps_get_folder_contents`, `aps_get_item_details`, `aps_get_folder_tree`, and more.
+- **Requirements:** All requirements met
+
+> **Security notice:** Claude warns that installing an extension grants it access to your computer. Only install extensions from developers you trust.
+
+Click **Install** to proceed.
+
+---
+
+## Step 3 – Configure Your APS Credentials
+
+After clicking Install, a configuration dialog appears where you enter your APS application credentials.
+
+![APS MCP configuration dialog](03.png)
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| **APS Client ID** | Yes | Your APS app Client ID from [aps.autodesk.com](https://aps.autodesk.com) |
+| **APS Client Secret** | Yes | Your APS app Client Secret |
+| **APS OAuth scope(s)** | No | Space-separated scopes (e.g. `data:read data:write`). Default: `data:read` |
+| **3LO callback port** | No | Localhost port for the 3-legged OAuth callback. Default: `8910` |
+
+Fill in your credentials and click **Save**.
+
+---
+
+## Step 4 – Verify the Installation
+
+Once installed, the extension detail page shows the extension is **Enabled** with options to **Uninstall** or **Configure**.
+
+![APS MCP installed and enabled](04.png)
+
+The toggle must be blue (enabled) for the MCP tools to be available in Claude conversations. You can return to this screen at any time to reconfigure your credentials via the **Configure** button.
+
+---
+
+## Using the MCP Tools
+
+Once installed, the APS MCP tools are automatically available in your Claude conversations. Start by asking Claude to list your hubs:
+
+```
+List my APS hubs
+```
+
+For 3-legged OAuth flows (user-delegated access), use `aps_login`. For service-to-service access, the tools use your Client ID and Secret directly.
+
+See the [main README](../README.md#tools) for a full list of available tools and the typical browsing workflow.