Claude Code

Loggerhead ships an MCP server. Its tools let your coding tool read your logs, metrics, traces, and lint findings, mark a finding fixed, and change the lint rules with a reason that you can undo in the app. The server talks to the Loggerhead engine on your Mac over 127.0.0.1. Nothing leaves the machine.

Add it with one click

1. Open Loggerhead and click Settings in the sidebar.
2. Open the AI tab.
3. In the AI coding tools card, click Add next to Claude Code.

Loggerhead writes the server into ~/.claude.json and keeps every other entry in that file. It leaves a copy of the previous file beside it with the extension .bak. Restart Claude Code, and the Loggerhead tools appear.

The server finds the engine by itself. You do not set a port, and the entry survives a restart.

Add it by hand

Run this once in a terminal. --scope user writes the same entry as the Add button, so every project gets the server.

claude mcp add --scope user loggerhead -- "/Applications/Loggerhead.app/Contents/Resources/loggerhead-mcp"

Restart Claude Code. Type /mcp to confirm that loggerhead shows as connected.

In Loggerhead, open Settings › AI. After Claude Code uses a Loggerhead tool, the MCP server row names Claude Code and the last tool it used.

Try it

Ask Claude Code:

checkout is returning 500s locally. why?

Claude Code calls query_logs with the service and severity, then get_trace on the trace ID it finds, and answers from what your app actually did.

Remove it

claude mcp remove loggerhead

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

See Tools reference for what each tool accepts.