---
title: "Claude Code"
description: "Give Claude Code a window into your running app through the Loggerhead MCP server."
source: "https://getloggerhead.com/docs/connect-your-ai-tool/claude-code/"
---

# Claude Code

> Give Claude Code a window into your running app through the Loggerhead MCP server.

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.

```bash
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

```bash
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](/docs/connect-your-ai-tool/connect-your-project-with-one-prompt/).

See [Tools reference](/docs/mcp-server/tools-reference/) for what each tool accepts.