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

# Windsurf

> Give Windsurf 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 **Windsurf**.

Loggerhead writes the server into `~/.codeium/windsurf/mcp_config.json` and keeps every other entry in that file. It leaves a copy of the previous file beside it with the extension `.bak`. Restart Windsurf, 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

1. Open **Windsurf Settings → Cascade → MCP servers**.
2. Click **Add server** and choose **Custom**.
3. Paste this configuration.

```json title="mcp_config.json"
{
  "mcpServers": {
    "loggerhead": {
      "command": "/Applications/Loggerhead.app/Contents/Resources/loggerhead-mcp"
    }
  }
}
```

4. Click **Refresh**. Windsurf lists the five Loggerhead tools.

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.