Connect lavela to your AI agent

Add lavela once, then ask your agent to launch and run your app. You sign in with your lavela account when the agent asks — there's no token to copy.

Start with the short, 3-step guide

Claude (web and desktop app)

Adds lavela as a custom connector. Connectors you add on claude.ai also show up in the Claude desktop app.

Add to Claude

Claude opens “Add custom connector” with lavela already filled in — click Add.
Click Connect, sign in to lavela, and approve access.
In each new chat, turn lavela on from the tools (+) menu, then ask: “launch my app with lavela”.

Want ads, cron jobs, preview environments, security scans or legal documents too? Those need the full connection — see how below.

Claude Code

Run this once in a terminal on the computer with Claude Code CLI installed. Lavela will be available across your projects.

claude mcp add --transport http --scope user lavela https://console.lavela.dev/api/mcp

Open Claude Code in your app project folder. If it was already open, start a new session.
Inside Claude Code, enter /mcp, select lavela, then choose Authenticate.
Sign in to Lavela in the browser and approve access. Return to Claude Code and check that the status is Connected.

Already added lavela?

An old entry, with an old address or a leftover token header, can stop the browser sign-in from starting, so remove it everywhere and add lavela again.

Paste these four lines into your terminal. A line for a place where lavela was never added just says so, which is fine.

claude mcp remove lavela -s user
claude mcp remove lavela -s local
claude mcp remove lavela -s project
claude mcp add --transport http --scope user lavela https://console.lavela.dev/api/mcp

Or run this instead. It clears old lavela entries from your Claude Code settings itself (not a project’s .mcp.json), signs you in through the browser, and sets up Claude Code (and any other supported tool it finds on this computer).

npx @lavela/cli connect

Seeing claude: command not found?

This command requires the Claude Code CLI. Install it, then retry in a new terminal.

Claude Code installation guide

Codex

Connect from the MCP settings in the desktop app where you use Codex.

Open Settings → MCP servers → Add server in the app.
Server name
lavela
Connection type
Streamable HTTP
https://console.lavela.dev/api/mcp
Select Save → Restart → Authenticate. Sign in to lavela and approve access in the browser that opens.

In a new chat, enter /mcp to check the lavela connection.

This connection works even if lavela is absent from the plugin directory.

Connect in the terminal (Codex CLI)

Use this if you installed Codex CLI separately and can run the codex command in your terminal.

codex mcp add lavela --url https://console.lavela.dev/api/mcp

Next, sign in to lavela and approve access in your browser.

codex mcp login lavela

If you see command not found: codex, use the app settings above. Installing the desktop app does not guarantee a terminal command is available.

Official Codex connection guide

Cursor

Opens Cursor and adds lavela to its MCP servers. Cursor asks you to sign in to lavela the first time.

Add to Cursor

Set it up manually instead

Paste this into ~/.cursor/mcp.json:

{
  "mcpServers": {
    "lavela": {
      "url": "https://console.lavela.dev/api/mcp"
    }
  }
}

VS Code

Opens VS Code and installs lavela for Copilot agent mode. VS Code asks you to sign in to lavela the first time.

Install in VS Code

Set it up manually instead

Paste this into .vscode/mcp.json in your workspace:

{
  "servers": {
    "lavela": {
      "type": "http",
      "url": "https://console.lavela.dev/api/mcp"
    }
  }
}

Supported desktop tools (CLI)

Detects the agents installed on your machine (Claude Code, Cursor, Windsurf, Claude Desktop) and adds lavela to each after you sign in.

npx @lavela/cli connect

Server URL

For any other MCP client that supports remote servers with OAuth sign-in.

https://console.lavela.dev/api/mcp

Need ads, cron jobs, preview environments, security scans or legal documents too? Connect with https://console.lavela.dev/api/mcp/all for every tool.

New to lavela? Create an account — eligible new accounts get free compute credit automatically, no card needed.