> ## Documentation Index
> Fetch the complete documentation index at: https://docs.versuno.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Desktop

> Connect Versuno MCP to Anthropic's Claude Desktop app.

Claude Desktop uses a single JSON config file. Edit it manually or through the Settings UI.

## Via the UI

Open **Settings > Developer > Edit Config**. Claude Desktop opens your default JSON editor on the config file.

## File locations

| OS      | Path                                                              |
| ------- | ----------------------------------------------------------------- |
| macOS   | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| Windows | `%APPDATA%\Claude\claude_desktop_config.json`                     |
| Linux   | `~/.config/Claude/claude_desktop_config.json`                     |

## Config

```json theme={null}
{
  "mcpServers": {
    "versuno": {
      "command": "npx",
      "args": ["-y", "versuno-mcp"],
      "env": {
        "VERSUNO_API_KEY": "uk_live_xxx"
      }
    }
  }
}
```

If you already have other MCP servers configured, add the `versuno` block alongside them. Do not replace the full `mcpServers` object.

## Remote (hosted HTTP)

Claude Desktop's config can't attach a custom `Authorization` header, so connect to Versuno's hosted server through the [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) bridge:

```json theme={null}
{
  "mcpServers": {
    "versuno": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.versuno.ai/mcp",
        "--header",
        "Authorization: Bearer uk_live_xxx"
      ]
    }
  }
}
```

This still launches `npx` locally as a thin bridge, but all tool calls go to the hosted server. It provides the read/query tools only — `pull_asset` and `push_asset` need local disk access, so use the direct config above for those.

## Restart

Claude Desktop only reads the config on startup. Quit the app fully (menu bar, not just the window) and reopen it.

## Verify

Open a new chat. You should see a tool icon in the input area indicating MCP tools are available. Click it to see the list. Versuno should contribute 9 tools.

## Troubleshooting

Claude Desktop shows MCP errors under **Settings > Developer > MCP**. Check the server status there. See the generic [Troubleshooting guide](/mcp/setup#troubleshooting) for common causes.