MCP quickstart guide🔗

This guide walks through the steps required to connect an AI assistant to Lightrun MCP and authenticate with your Lightrun account. For an overview of Lightrun MCP concepts and architecture, see Lightrun MCP Overview.

Prerequisites🔗

Before you begin, ensure that:

You have a Lightrun user account within your company’s Lightrun organization.
You are assigned to a role that has permission to view and copy Lightrun MCP server setup details and access the MCP page in the Lightrun Management Portal. This permission is available for the following roles:
- Developer
- Company Admin
- Group Admin

Step 1: Copy the Lightrun MCP server details🔗

Connecting to the Lightrun MCP involves copying a configuration snippet containing your Lightrun Server details into your AI client’s New MCP Server settings. Communication with the Lightrun server is performed over HTTPS.

Log in to your Lightrun account.
In the main Platform area of your Management Portal, from the left navigation bar, click Lightrun MCP.

The Lightrun MCP page opens.
Copy the provided MCP server configuration snippet. If you already have MCP servers configured, copy only the Lightrun entry and add it under mcpServer in the mcp.json file.

Copy MCP configuration from here

You can manually configure your AI client using the following details.

URL
https://your-company-server.lightrun.com/mcp

JSON configuration

{
  "mcpServers": {
    "Lightrun": {
      "url": "https://your-company-server.lightrun.com/mcp"
    }
  }
}

Replace your-company-server with your organization’s Lightrun server hostname.

Once copied, proceed to set up your Lightrun Server integration within your AI Assistant.

Step 2: Set up the MCP server in the AI tool🔗

The following steps apply to any MCP-compatible AI client. Cursor is shown here as an example.

To connect Lightrun MCP using Cursor:

Open Cursor.
From the menu bar, select Settings > Cursor Settings > Tools & MCP.
Click Add Custom MCP.

The mcp.json file opens in Cursor.
Paste the Lightrun MCP Server configuration into the JSON.

If you already have MCP servers configured, copy only the Lightrun entry and add it under mcpServers.
Save the file and return to the Settings page.

The Lightrun MCP Server is now configured, and the Needs authentication label is displayed next to the Connect button.

Step 3: Authenticate with Lightrun🔗

From the Tools & MCP > Installed MCP Servers section, click Connect.

The Lightrun Server connectivity terms are stated.
Click Continue to complete the process.

The Lightrun MCP server is authenticated, and the supported tools are displayed.
If prompted, restart Cursor to complete setup.

Once configured, Cursor can access live runtime context from Lightrun.

Next steps🔗

You’re ready to debug live applications directly from your AI Assistant.

To continue, explore the Supported Lightrun Tools to see which runtime inspection and debugging capabilities are available through Lightrun MCP.

Last update: January 15, 2026