Intelligent Tools

Configuring Claude

MCP integration for Claude Desktop
View as Markdown

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

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

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.
1

Check your Node version

$node -v
2

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

$nvm install 20
$nvm use 20
$nvm alias default 20
3

Confirm your active version

$node -v

Setup Instructions

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

1

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
2

Step 2) Add your Knapsack MCP Configuration

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

1{
2  "mcpServers": {
3    "knapsack-mcp-toby": {
4      "command": "npx",
5      "args": [
6        "-y",
7        "mcp-remote",
8        "https://mcp.knapsack.cloud/mcp/toby"
9      ]
10    }
11  }
12}

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>
3

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.