Other MCP clients

Loggerhead ships an MCP server. It gives your coding tool five read-only tools: search logs, query metrics, search traces, get one trace, and get the receiver addresses. The server talks to the Loggerhead engine on your Mac over 127.0.0.1. Nothing leaves the machine.

Find the engine address

Open Collectors → Local OTLP receiver → Connection. The API row shows the address the MCP server needs, for example http://127.0.0.1:54321. The port changes when the app restarts, so copy it fresh.

The general shape

Every MCP client needs the same two facts: the command to start, and the engine address.

Field	Value
Command	`loggerhead-mcp`
Arguments	`--backend-url http://127.0.0.1:<api port>`
Transport	stdio

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "loggerhead": {
      "command": "loggerhead-mcp",
      "args": ["--backend-url", "http://127.0.0.1:54321"]
    }
  }
}

Gemini CLI

Add to ~/.gemini/settings.json under mcpServers with the same command and arguments. Restart the CLI.

VS Code

Add the server to the workspace .vscode/mcp.json with type stdio, the same command, and the same arguments.

To send the project’s own logs, metrics, and traces to Loggerhead, paste the prompt from Connect your project with one prompt.

See What the server exposes for the tools and the one resource.