Claude

Add the GearDex MCP adapter to Claude Desktop or Claude Code.

StudioThe Studio API, webhooks, and MCP adapter are included with the Studio plan.Compare plans

The adapter runs on your computer. Claude Desktop and Claude Code can start it. Claude on the web and the Claude phone apps connect only to remote MCP servers, so they cannot use the adapter.

Claude Desktop

These steps are the same on macOS and Windows. Only the config file location and the command are different.

Create a Studio API key in Settings, API & Agents. For a first test, give the key read scopes only.
Install Node 22 or newer.
Quit Claude and open it again. Claude can then find npx.
In Claude, open Settings, Developer.
Click Edit config. Claude opens the folder that contains claude_desktop_config.json.
Open claude_desktop_config.json in a text editor.
Caution: If the file already has an mcpServers block, do not replace it. Add the geardex entry in that block.
Paste the config for your system into the file.
Replace gdx_live_REPLACE_ME with your key.
Save the file.
Note: If you only close the window, Claude continues to run with the old config.
Quit Claude. On macOS, click Claude, Quit (⌘Q). On Windows, right-click the Claude icon in the system tray and click Quit.
Open Claude again.
Open Settings, Developer.
In the local MCP servers, make sure that the status of geardex is running.
Send a starter prompt.

macOS

textConfig file

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

jsonclaude_desktop_config.json (macOS)

{
  "mcpServers": {
    "geardex": {
      "command": "npx",
      "args": [
        "--yes",
        "--package",
        "https://github.com/dylandersen/geardex-public/releases/download/mcp-v0.2.0/geardex-mcp-0.2.0.tgz",
        "geardex-mcp"
      ],
      "env": {
        "GEARDEX_STUDIO_API_KEY": "gdx_live_REPLACE_ME"
      }
    }
  }
}

Windows

textConfig file

%APPDATA%\Claude\claude_desktop_config.json

jsonclaude_desktop_config.json (Windows)

{
  "mcpServers": {
    "geardex": {
      "command": "npx.cmd",
      "args": [
        "--yes",
        "--package",
        "https://github.com/dylandersen/geardex-public/releases/download/mcp-v0.2.0/geardex-mcp-0.2.0.tgz",
        "geardex-mcp"
      ],
      "env": {
        "GEARDEX_STUDIO_API_KEY": "gdx_live_REPLACE_ME"
      }
    }
  }
}

Claude Code

Create a Studio API key in Settings, API & Agents. For a first test, give the key read scopes only.
Install Node 22 or newer.
In the command below, replace gdx_live_REPLACE_ME with your key.
Note: On Windows (not WSL), put cmd /c before npx in the command.
Run the command in a terminal.
Run claude mcp list.
Make sure that geardex shows as connected.
Start Claude Code.
Send a starter prompt.

bashAdd GearDex to Claude Code

claude mcp add --transport stdio --scope user geardex \
  --env GEARDEX_STUDIO_API_KEY=gdx_live_REPLACE_ME \
  -- npx --yes --package https://github.com/dylandersen/geardex-public/releases/download/mcp-v0.2.0/geardex-mcp-0.2.0.tgz geardex-mcp

With --scope user, GearDex is available in all your projects.