[!IMPORTANT] AI makes mistakes! Undisk MCP makes recovery instant. Home: https://mcp.undisk.app Issues: https://github.com/kiarashplusplus/undisk-mcp-tracker/issues

1-click setup for Undisk MCP in Claude Desktop.

Automatically detects your OS, locates the Claude Desktop config file, and adds the Undisk MCP stdio-proxy bridge — so Claude can read, write, and version files in your Undisk workspace.

Quick Start

npx @undisk-mcp/setup-claude --api-key YOUR_API_KEY

Get your API key at mcp.undisk.app/keys.

If you omit --api-key, the CLI will check the UNDISK_API_KEY environment variable, then prompt you interactively.

CLI Options

Flag	Description
`--api-key <key>`	Your Undisk API key (or set `UNDISK_API_KEY` env var)
`--endpoint <url>`	Custom endpoint or full MCP URL (default: `https://mcp.undisk.app`)
`--server-name <name>`	Server name in Claude config (default: `undisk`)
`--config <path>`	Override auto-detected config path
`--check`	Check if Undisk is already configured (exit 0 = yes, 1 = no)
`--remove`	Remove Undisk from the Claude Desktop config
`-h, --help`	Show help message

What It Does

The CLI writes (or merges into) your Claude Desktop config file:

{
  "mcpServers": {
    "undisk": {
      "command": "npx",
      "args": ["-y", "@undisk-mcp/stdio-proxy"],
      "env": {
        "UNDISK_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Existing config entries are preserved — only the undisk server entry is added or updated.

Verify Setup

npx @undisk-mcp/setup-claude --check

Exits with code 0 if Undisk is configured, 1 if not.

Workspace Routing

For multi-workspace routing, you can pass a full MCP URL with a workspace query:

npx @undisk-mcp/setup-claude \
  --api-key YOUR_API_KEY \
  --endpoint "https://mcp.undisk.app/v1/mcp?workspace=YOUR_WORKSPACE_ID"

You can also keep the default endpoint and use a workspace-scoped API key.

Remove

npx @undisk-mcp/setup-claude --remove

Removes the Undisk entry from your Claude Desktop config. Other MCP servers are left untouched.

Supported Platforms

Platform	Config Path
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

Programmatic Usage

import { setupUndisk } from "@undisk-mcp/setup-claude";

const result = setupUndisk({
  apiKey: "undisk_...",
  endpoint: "https://mcp.undisk.app", // optional
  serverName: "undisk",               // optional
  configPath: "/custom/path.json",    // optional
});

console.log(result.configPath);        // where the config was written
console.log(result.alreadyConfigured); // true if entry existed before