Skip to main content
← Legba MCP server
Legba MCP

Legba MCP server for Claude Desktop

Give Claude Desktop a real browser through one local config. Claude can use Legba without sharing your existing browser profile.

What you get

A disposable browser in chat.

Claude Desktop can spawn a fresh Chromium session, drive a page, extract content, and return a screenshot. The session uses a residential IP and fresh fingerprint instead of your local browser identity. When Claude destroys it, its cookies, storage, tokens, and fingerprint are removed.

Install

Edit the desktop config.

Open Settings, then Developer, then Edit Config. On macOS, the file is ~/Library/Application Support/Claude/claude_desktop_config.json. On Windows, it is %APPDATA%\Claude\claude_desktop_config.json.

This file configures the Claude Desktop chat app. It does not configure Claude Code. The mcpServers object names Legba, starts the npx package, and passes one API key to that process. Keep every existing server entry when you add this block.

claude_desktop_config.jsonjson
{
  "mcpServers": {
    "legba": {
      "command": "npx",
      "args": ["-y", "legba-browser-mcp"],
      "env": {
        "LEGBA_API_KEY": "lgb_your_api_key"
      }
    }
  }
}

Replace the placeholder with your Legba API key. If the file already has an mcpServers object, add the legba entry inside it. Fully quit Claude Desktop after saving, then reopen the app.

Verify

Find the browser tools.

  1. Start a new conversation after restarting the app. Open the connectors control and confirm legba appears without a connection error.
  2. Inspect its available tools. You should see session.spawn, navigate, extract, act, screenshot, and session.destroy.
  3. Ask Claude to spawn a session and visit a test URL. Confirm it returns a session ID and rendered result. End by asking Claude to destroy that session.

If the connector is missing after restart, reopen the config through Developer settings. Check that the JSON parses and legba sits inside mcpServers. Then fully quit the app before the next check.