Install Lightsage MCP in Cursor - Lightsage

Documentation Index

Fetch the complete documentation index at: /docs/llms.txt

Use this file to discover all available pages before exploring further.

Cursor supports remote MCP servers with OAuth. Add the hosted Lightsage server from Cursor’s MCP settings, then sign in and select the Lightsage organization the connection can access.

Open Cursor's MCP settings
Press Cmd+Shift+P on macOS or Ctrl+Shift+P on Windows and Linux.
Run View: Open MCP Settings.
Add the Lightsage server
Click Add New MCP Server. Cursor opens its mcp.json configuration file instead of showing a setup form. Add Lightsage under mcpServers:
```
{
  "mcpServers": {
    "lightsage": {
      "url": "https://mcp.lightsage.com/mcp"
    }
  }
}
```
If the file already contains other servers, add only the lightsage property inside the existing mcpServers object. Do not replace the other entries. Save the file, return to MCP settings, and make sure lightsage is enabled.
Sign in with OAuth
Start the sign-in action for Lightsage in Cursor. When your browser opens, sign in, select your Lightsage organization, and approve access.
Verify the connection
Return to Cursor and confirm that Lightsage shows as connected. Then run a read-only prompt:
```
Use the Lightsage MCP server to check my Lightsage auth status.
```

Use Lightsage from the Agent CLI

The Agent CLI reads the same MCP configuration as Cursor. It uses .cursor/mcp.json in the current project or ~/.cursor/mcp.json for all projects. If you completed the Cursor steps above, do not add the server again. Authenticate and verify the server:

agent mcp login lightsage
agent mcp list
agent mcp list-tools lightsage

If agent mcp login lightsage reports that the client is not in the config, confirm that ~/.cursor/mcp.json contains the lightsage entry and that agent mcp list displays it before trying to sign in again.

Use an API key instead

For automation or another environment where interactive OAuth is unavailable, configure a Lightsage API key in ~/.cursor/mcp.json for global access or .cursor/mcp.json inside one project:

{
  "mcpServers": {
    "lightsage": {
      "url": "https://mcp.lightsage.com/mcp",
      "headers": {
        "X-Lightsage-Api-Key": "${env:LIGHTSAGE_API_KEY}"
      }
    }
  }
}

Set LIGHTSAGE_API_KEY before starting Cursor:

export LIGHTSAGE_API_KEY="ls_cli_your_api_key"

Create and revoke API keys from the Lightsage dashboard. Do not put API keys in shared project config or commit them to a repository. See the Cursor MCP docs for config locations and remote server authentication.