> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.knapsack.cloud/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.knapsack.cloud/_mcp/server.

# Configuring Claude

## Getting Started with Knapsack MCP + Claude Desktop

Before we can begin configuration you'll need to install and setup Claude Desktop. Download the latest version of Claude Desktop from Anthropic:

[https://claude.ai/download](https://claude.ai/download)

**If your organization maintains an allowlist or registry of approved MCP servers, be sure to add your Knapsack MCP site's workspace ID to this URL:** `https://mcp.knapsack.cloud/mcp/<workspace-id>`

#### Finding your workspace ID

To find your **workspace ID**, find the URL of your Knapsack site and look for what comes between `site /` and `/ latest`.

Below is an example of how we at Knapsack would find our workspace ID:

![Example of where to find your site's workspace ID](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/knapsack-docs.docs.buildwithfern.com/4e2fb921a350ef77bf60fab18a06ec365ce0ccffe301b56b0958aa9f873861a0/docs/assets/images/0cd26ee6-site-id.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260724%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260724T211253Z&X-Amz-Expires=604800&X-Amz-Signature=ecc35232db54022f7269c187c18eee1e0f17656cd1c84f67cde5838fd024f2f8&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

Our MCP URL would be `https://mcp.knapsack.cloud/mcp/toby`

***

## Prerequisites

* Knapsack MCP requires a local `Node.js v20` or later to run successfully.
* **Note:** There are many third-party and system-level methods and tools for managing node versions.
  * You can check and manage your Node version using nvm (Node Version Manager), as shown in the example below.

#### Check your Node version

```bash
node -v
```

#### If your version is lower than 20, install and set Node 20 as your default

```bash
nvm install 20
nvm use 20
nvm alias default 20
```

#### Confirm your active version

```bash
node -v
```

***

## Setup Instructions

After installing Claude Desktop in the Getting Started section, we can move onto our configuration.

#### Step 1) Create a config file

Create or edit your `claude_desktop_config.json` file:

##### Mac

```
~/Library/Application Support/Claude/claude_desktop_config.json
```

##### Windows

```
\AppData\Roaming\Claude\claude_desktop_config.json
```

#### Step 2) Add your Knapsack MCP Configuration

Add (or merge) the following block into your config file, adjusting for your Knapsack workspace:

```json
{
  "mcpServers": {
    "knapsack-mcp-toby": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.knapsack.cloud/mcp/toby"
      ]
    }
  }
}
```

**Replace:**

* `knapsack-mcp-toby` with your workspace identifier:
  `knapsack-mcp-<workspace-id>`
* `https://mcp.knapsack.cloud/mcp/toby` with your workspace endpoint:
  `https://mcp.knapsack.cloud/mcp/<workspace-id>`

#### Step 3) Restart and use Knapsack MCP with Claude Desktop

🎉 **Restart Claude Desktop.** Claude will automatically detect and connect to your new MCP configuration.

**🔐 Authenticate.** You will be directed to an authentication screen within your browser.

🚀 **Do great things.** Bootstrapped by Claude powered by Knapsack MCP.

***

## Troubleshooting

If something isn't working, try these steps:

* **Check the logs:**
  Errors usually reference the log file location. Review the logs for details.
* **Early Access not enabled:**
  Ensure your workspace has MCP access enabled; otherwise, the connection will fail.
* **Old Node version:**
  MCP requires Node 20. Use `nvm` to uninstall older versions and set Node 20 as both your current and default.