---
title: Browser Use
description: Run managed browser automation tasks through Browser Use's MCP server.
type: connection
keywords:
  - mcp
  - browser
  - browser automation
  - cloud browser
  - web automation
---

# Browser Use

Connection integration for eve. Run managed browser automation tasks through Browser Use's MCP server.

## Install

Add the connection from eve's registry. This writes the initial definition under `agent/connections/` and installs its authentication dependency when needed:

```bash
eve add connection/browser-use
```

## Quick start

### MCP · API key

Create `agent/connections/browser-use.ts`. The connection name is derived from the filename:

```ts
// agent/connections/browser-use.ts
import { defineMcpClientConnection } from "eve/connections";

export default defineMcpClientConnection({
  url: "https://api.browser-use.com/v3/mcp",
  description: "Browser Use: run browser automation tasks, inspect sessions, and manage browser profiles.",
  headers: () => ({
    "x-browser-use-api-key": process.env.BROWSER_USE_API_KEY!,
  }),
});
```

Keep the API key in a server-side environment variable. eve sends it directly to the MCP server and does not expose it to the model.

## Configure

### MCP · API key

Set `BROWSER_USE_API_KEY` as a server-side environment variable:

```bash
BROWSER_USE_API_KEY=your_api_key
```

Browser Use runs tasks in managed cloud browsers. Add approval gates or tool filters before allowing unattended browser actions.

See the [Connections docs](/docs/connections) for principal types, headers, approval, and protocol-specific filters.

[Read the full connection documentation](https://docs.browser-use.com/cloud/guides/mcp-server)

---

For a semantic overview of all documentation, see [/sitemap.md](/sitemap.md)

For an index of all available documentation, see [/llms.txt](/llms.txt)

For agent-facing discovery, including API and MCP surfaces, see [/agents.md](/agents.md)