Windsurf

Manual Configuration

Option 1: stdio (Recommended)

1. Open Windsurf
2. Navigate to MCP Configuration via the Cascade toolbar or Command Palette (Cmd + Shift + P → "MCP")
3. Add the following to your MCP configuration:

{
  "mcpServers": {
    "macuse": {
      "command": "/Applications/Macuse.app/Contents/MacOS/macuse",
      "args": ["mcp"]
    }
  }
}

4. Save and restart Windsurf

Option 2: HTTP with API Key

If stdio doesn't work, you can connect via HTTP using an API Key:

1. Open Macuse Settings → Connections, click +, enter "Windsurf" as the name, and click Create
2. Copy the API key immediately (it is only shown once)
3. Add the following to your Windsurf MCP configuration:

{
  "mcpServers": {
    "macuse": {
      "url": "http://127.0.0.1:35729/mcp",
      "headers": {
        "Authorization": "Bearer <your_api_key>"
      }
    }
  }
}

4. Save and restart Windsurf

See the API Keys page for more details.

Verifying the Connection

1. Open Windsurf and start a new AI chat
2. Ask the AI to "list available Macuse tools"
3. If configured correctly, the AI will show the available toolboxes