@undisk-mcp/setup-claude

[!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

License

MIT — see LICENSE.