OpenLens

OpenLens MCP + ChatGPT: Integration Guide

Add the OpenLens Model Context Protocol server to ChatGPT as a custom connector. Once connected, ChatGPT can run visibility scans, pull citations, manage topics, and report on brand health across all seven AI platforms OpenLens tracks. Custom connectors require Developer Mode, which lives under the Advanced connectors panel.

TL;DR

Server URLhttps://openlens.com/mcp
TransportStreamable HTTP
AuthOAuth 2.1 (browser flow)
WhereSettings to Connectors to Advanced to Developer Mode

Turn on Developer Mode

  1. Open ChatGPT and click your profile, then Settings.
  2. Go to Connectors.
  3. Click Advanced.
  4. Toggle on Developer Mode.

Developer Mode is what unlocks the Add custom connector option. Without it, the connectors panel only shows the built-in integrations.

Add the OpenLens connector

  1. Back in Settings to Connectors, click Add custom connector.
  2. Set the URL to: https://openlens.com/mcp
  3. Set Auth to OAuth.
  4. Save the connector.

Complete OAuth

ChatGPT opens a browser tab for the Clerk OAuth handshake. Sign in with your OpenLens account and approve. The token is cached and reused on every subsequent tool call.

Verify it works

Start a new ChatGPT chat and ask:

“List my OpenLens projects.”

ChatGPT will call list_projects and return at least one row. If nothing happens, see Troubleshooting below.

What you can do once connected

The OpenLens MCP server exposes ~40 tools across project setup, brands, topics, prompts, runs, visibility analytics, citations, workstreams, and scheduling. From ChatGPT you can ask:

  • “How visible is Skylark on ChatGPT itself this week versus Perplexity? Tell me where the gap is widest.”
  • “Run every active prompt for project Skylark on Gemini and Grok, then summarize what changed.”
  • “Pull the citations behind the last 10 Skylark mentions and tell me which domains are driving the most volume.”
  • “Spin up a new project for Vertex Labs with 5 topics focused on developer tooling.”

Troubleshooting

  • “Add custom connector” button missing: Developer Mode is off. Go to Settings to Connectors to Advanced and toggle it on.
  • OAuth tab does not open: disable popup blockers for chatgpt.com and retry. Some browsers block the auth window without warning.
  • Tools not showing in chat: custom connectors load when a chat starts. Open a fresh chat after the connector shows as connected.
  • Anything else: email [email protected] with your ChatGPT plan and the exact error.

Related