Configuration

The MCP server is configured entirely through environment variables, set in the env block of your MCP client’s config (e.g. ~/.claude/settings.json). There are three.

LOGURO_TOKEN

Required only if you haven’t run loguro login. See Authentication for the full breakdown.

LOGURO_PROJECT

Sets the default project slug. When this is set, the project parameter on every tool becomes optional — it defaults to whatever you configured here, and the tool description shown to Claude reflects that.

// Tool schema with LOGURO_PROJECT set:
project: z.string().default(DEFAULT_PROJECT).describe(`Project slug (default: ${DEFAULT_PROJECT})`)

// Tool schema without it (project becomes a required argument):
project: z.string().describe("Project slug (visible in app URL)")

If you only ever debug one app, set this once and forget it. Claude can still pass an explicit project for cross-project queries.

LOGURO_BASE_URL

Override the API host. Useful for self-hosted Loguro deployments or alternate environments (staging, on-prem). The default is https://logu.ro. Trailing slashes are stripped.

If your CLI auth was saved against a non-default base URL (i.e. loguro login was run pointing at a custom host), the MCP will reuse that baseUrl from auth.json automatically. LOGURO_BASE_URL only needs to be set when you want to override the saved value.

Example: full config

{
  "mcpServers": {
    "loguro": {
      "command": "bunx",
      "args": ["@loguro/mcp"],
      "env": {
        "LOGURO_TOKEN": "pat_…",
        "LOGURO_PROJECT": "payments-api",
        "LOGURO_BASE_URL": "https://logs.internal.example.com"
      }
    }
  }
}