Quick Start Guide¶

Get RapidTriageME up and running in under 5 minutes!

Prerequisites¶

Node.js 18+ installed
Chrome or Edge browser
Terminal/Command line access

🚀 5-Minute Setup¶

Step 1: Install the Chrome Extension¶

Open Chrome and navigate to chrome://extensions/
Enable "Developer mode" (top right)
Click "Load unpacked"
Select the rapidtriage-extension folder
The extension icon should appear in your toolbar

Step 2: Start the Local Server¶

# Using npm (recommended)
npx @yarlisai/rapidtriage-server

# Or clone and run locally
git clone https://github.com/YarlisAISolutions/rapidtriageME.git
cd rapidtriageME
./run.sh test

You should see:

🚀 RapidTriage Server running on port 3025
Available at: http://localhost:3025

Step 3: Configure Your AI Assistant¶

Claude (via MCP)Cursor IDE

Add to your Claude configuration:

{
  "mcpServers": {
    "rapidtriage": {
      "command": "npx",
      "args": ["@yarlisai/rapidtriage-mcp"],
      "env": {
        "BROWSER_TOOLS_PORT": "3025"
      }
    }
  }
}

Add to .cursor/mcp_settings.json:

{
  "mcpServers": {
    "rapidtriage": {
      "command": "node",
      "args": ["/path/to/rapidtriage-mcp/dist/mcp-server.js"],
      "env": {
        "BROWSER_TOOLS_PORT": "3025"
      }
    }
  }
}

Step 4: Test the Connection¶

Open any website in Chrome
Open DevTools (F12)
Click on the "BrowserToolsMCP" tab
You should see "Connected" status

Step 5: Start Debugging!¶

Ask your AI assistant: - "Check the console logs" - "Show me network errors" - "Take a screenshot" - "Run an accessibility audit"

✅ Verification Checklist¶

Chrome extension loaded and visible
Server running on port 3025
DevTools panel shows "Connected"
AI assistant can retrieve browser data

🎉 Success!¶

You're now ready to use RapidTriageME for AI-powered browser debugging.

Next Steps¶

Common Issues¶

Server not starting?

Make sure port 3025 is not in use:

lsof -i :3025
# Kill any process using the port
kill -9 <PID>

Extension not connecting?

Check the server is running
Reload the extension
Refresh the browser tab
Check DevTools console for errors

AI not receiving data?

Verify MCP configuration:

# Test MCP server directly
npx @yarlisai/rapidtriage-mcp

Need help? Check our troubleshooting guide or open an issue.