Skip to main content
The Trace MCP Server acts as a bridge, effectively giving your AI Agent eyes and hands to debug your local applications. It implements the Model Context Protocol.

​
⚡ Quick Start

The server runs on your local machine using npx. It does not require installation.

​
🛠️ IDE Configuration

​
1. Claude Desktop App

To use Trace with Claude, you need to add it to your claude_desktop_config.json. Location:
  • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Configuration:
Tip: Set HEADLESS to "false" if you want to watch the browser open and click things while Claude works.

​
2. Cursor (AI Editor)

Cursor has built-in MCP support.
  1. Open Cursor Settings (Cmd + ,).
  2. Navigate to Features -> MCP.
  3. Click + Add New Server.
    • Name: trace
    • Type: command
    • Command: npx -y @probebrowser/mcp-server
  4. (Optional) Add Environment Variables for TRACE_API_KEY.

​
3. Windsurf / Other MCP Clients

Any client supporting the stdio transport can connect. Command:

​
🔐 Environment Variables

​
🧪 Verification

Once configured:
  1. Restart your IDE (Claude/Cursor).
  2. Ask the Agent: “Check the console logs of the active page” or “Click the signup button”.
  3. You should see the tool execution in the Agent’s thought process.