Skip to main content
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.
1

Open Cursor's MCP settings

Press Cmd+Shift+P on macOS or Ctrl+Shift+P on Windows and Linux. Run View: Open MCP Settings.
2

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:
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.
3

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.
4

Verify the connection

Return to Cursor and confirm that Lightsage shows as connected. Then run a read-only prompt:

​
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:
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:
Set LIGHTSAGE_API_KEY before starting Cursor:
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.