Connect an MCP client

Use https://www.promptlens.io/mcp as the remote Streamable HTTP URL in each client. Complete OAuth in the browser using the intended PromptLens account. Menu names and custom-connector access depend on your client version and workspace policy.

Claude Desktop

Open Customize → Connectors, choose + → Add custom connector, and enter the PromptLens URL. Complete authorization and enable the connector in the conversation. In managed workspaces, an owner may need to add or allow the connector first. See Claude's remote connector instructions.

ChatGPT web

Enable developer mode where it is available in your account or workspace, then use the custom app/connector creation flow. Name it PromptLens, enter the server URL, and select OAuth. Finish sign-in and enable the connector for the conversation. If workspace policy controls custom connectors, ask an administrator to enable the relevant access. See ChatGPT developer mode.

ChatGPT desktop

In desktop versions exposing MCP server settings, open Settings → MCP servers → Add server, select Streamable HTTP, enter the URL, and choose Authenticate. Finish the browser handoff and check that tools appear before starting work. If your desktop version does not expose this control, use the web setup available to your account. See desktop and CLI MCP configuration.

Claude Code

Add the HTTP server from your terminal:

claude mcp add --transport http promptlens https://www.promptlens.io/mcp

Open Claude Code and use /mcp to select PromptLens and complete OAuth authentication. After sign-in, inspect the connection status. See Claude Code MCP documentation.

Codex

codex mcp add promptlens --url https://www.promptlens.io/mcp
codex mcp login promptlens

Finish browser consent, then use the server from your Codex session. The desktop app can also expose MCP configuration through settings. See Codex MCP configuration.

Cursor

Add this to the project's .cursor/mcp.json, or your user-level ~/.cursor/mcp.json when the connection should be available across projects:

{
  "mcpServers": {
    "promptlens": {
      "url": "https://www.promptlens.io/mcp"
    }
  }
}

Open Cursor's MCP settings, enable the server, and complete its OAuth prompt. The configuration contains the endpoint, not a token. See Cursor MCP documentation.

Check the connection

Ask: “List my PromptLens organizations and their IDs. Do not make any changes.” Select the intended organization before continuing with the assistant workflow.

If tools are missing, inspect whether the server is enabled for the current conversation and whether authorization completed. For login or discovery errors, use MCP troubleshooting. Use the client's revoke/disconnect controls when retiring access; deleting configuration alone may leave the OAuth grant active.