Luminon Luminon logo

2. Installation

2.5 Claude

Installation is similar on Linux, macOS, and Windows (with WSL2 enabled on Windows).

Default Claude Desktop config path: Linux `~/.config/Claude/claude_desktop_config.json`, macOS `~/Library/Application Support/Claude/claude_desktop_config.json`, and Windows `%APPDATA%/Claude/claude_desktop_config.json`.

This applies to Claude Desktop.

Local configuration:

Add the following to your Claude Desktop config file.

{
  "mcpServers": {
    "luminon": {
      "command": "luminon",
      "args": ["mcp"]
    }
  }
}

Remote configuration:

Luminon exposes the server over HTTP. Start it with `luminon start remote`.

luminon start remote

If your client version supports remote MCP servers by URL, add the following:

{
  "mcpServers": {
    "luminon_remote": {
      "url": "<myluminonserver>",
      "headers": {
        "Authorization": "Bearer lbt_b0d158c9e3f94bd3bc8245504c74114b"
      }
    }
  }
}

The `Authorization` Bearer token is generated with `luminon token create`, as explained in 2.3 . The URL is the IP address or domain name of the machine where Luminon is running. With the `luminon_remote` name, you can keep this connection alongside `luminon` for the local MCP in the same `claude_desktop_config.json`.