Run with Community Edition

Download and run Lenses Community Edition

To set up and run, follow the instructions here.

Lenses MCP Server will be running on http://localhost:8000/ with OAUTH_ENABLED parameter set to True so OAuth will be enabled by default.

Configure in your AI tool

To run in Cursor, Claude, Codex, etc. use the following mcp.json configuration to configure the client to connect using HTTP transport.

{
  "mcpServers": {
    "Lenses": {
      "type": "http",
      "url": "http://localhost:8000/mcp"
    }
}

Authenticate using OAuth

Navigate to your AI tool's MCP server settings and connect to authenticate with the Lenses OAuth authorization server (visible to your AI tool's client, configured with LENSES_ADVERTISED_URL with value http://localhost:9991/). Here is an example using Cursor.

This opens a web browser at http://localhost:9991/oauth2/authorize and passes OAuth parameters. Log in with your username/password. The default credentials are admin:admin.

You will be presented with an OAuth authorization consent screen where you can set read, write and delete scopes.

Completing this flow should take you back to your AI tool, authenticated and ready to use Lenses MCP Server with the granted authorization scopes.