Configuration

This pages describes how to configure the Lenses MCP Server.

The MCP server will load the configuration from a .env file.

VARIABLE NAME	DESCRIPTION	DEFAULT	REQUIRED
TRANSPORT	MCP server transport	http (if OAUTH_ENABLED is True) stdio (if OAUTH_ENABLED is False)	No
HOST	MCP server host address	0.0.0.0	No
PORT	MCP server port	8000	No
OAUTH_ENABLED	Switch to enable/disable OAuth	False	No
LENSES_URL	Lenses HTTP Endpoint	http://localhost:9991	Yes
LENSES_ADVERTISED_URL	The publicly available Lenses HTTP endpoint (needs to be accessibly by MCP clients for OAuth)	LENSES_URL value	No
MCP_ADVERTISED_URL	The publicly available URL for this MCP server (needs to be accessible to MCP clients)		Yes if OAUTH_ENABLED is True
MCP_SCOPES	OAuth scopes required by Lenses resources. Published in protected-resource metadata so compliant clients include them in their /authorize request	read,write,delete	No
LENSES_API_KEY	Alternative authentication using a Lenses Service Account API key		Yes if OAUTH_ENABLED is False