Getting started

Start with Luminon

Use English if you want the default guide. Switch to Español for the localized instructions and metadata.

General install

Quick start

Use the MCP server through npx. The renderer is optional and useful when you want a local dashboard preview in the browser.

Use the client-specific snippets below for Claude Desktop, Gemini CLI, Codex, or Perplexity Desktop.

npx @luminondev/mcp-dashboard mcp
npx @luminondev/mcp-dashboard start renderer

Add Luminon to Claude Desktop as a local stdio MCP server, then restart Claude.

Default config path: macOS: ~/Library/Application Support/Claude/claude_desktop_config.json | Windows: %APPDATA%/Claude/claude_desktop_config.json

If you already have other MCP servers configured, merge this inside your existing mcpServers object.

{
  "mcpServers": {
    "luminon": {
      "command": "npx",
      "args": ["@luminondev/mcp-dashboard", "mcp"]
    }
  }
}

Add Luminon to your Gemini CLI settings so it starts automatically as an MCP server.

Default config path: macOS/Linux: ~/.gemini/settings.json | Windows: %USERPROFILE%\.gemini\settings.json

Keep any existing Gemini CLI settings and add luminon under mcpServers.

{
  "mcpServers": {
    "luminon": {
      "command": "npx",
      "args": ["@luminondev/mcp-dashboard", "mcp"]
    }
  }
}

Configure Luminon in Codex once and reuse it from the CLI or the IDE extension.

Default config path: ~/.codex/config.toml

Codex also supports adding MCP servers with commands, but the config file is the cleanest copy-paste setup.

[mcp_servers.luminon]
command = "npx"
args = ["@luminondev/mcp-dashboard", "mcp"]

Perplexity Desktop currently supports local MCP connectors from the Mac app settings instead of a JSON config file.

Where to add it: Perplexity Mac app -> Settings -> Connectors -> Add Connector

Perplexity documents local MCP support for the macOS app. Enter the command below in the Add Connector form.

npx @luminondev/mcp-dashboard mcp