MCP
Connect an assistant to PromptLens and manage work in your organization.
Connect your assistant to PromptLens through the hosted Streamable HTTP endpoint:
https://www.promptlens.io/mcpThe connection uses OAuth with browser sign-in and explicit consent. It acts with your current organization memberships and roles. A retrieval key is not an MCP login credential.
Connect a client
Follow the client setup guide for Claude Desktop, ChatGPT web or desktop, Claude Code, Codex, and Cursor. Add the server URL, complete browser authorization, and start with a read-only request to list organizations.
Compatible OAuth clients can connect; access does not depend on a product-name allowlist. Clients supporting dynamic registration use the advertised OAuth metadata. A client requiring a pre-registered application needs its own registered client ID and redirect URLs.
Organization targeting
Every organization-scoped tool call includes organizationId. Ask the assistant to list your organizations and confirm the intended ID before changing shared resources. An account default is an initial suggestion, not permission to silently switch workspaces.
Tools use the API's stable operation names and share its permissions, revision checks, pagination, and retry rules. Use the assistant workflow to create and evaluate a ticket router, review a candidate, and publish a selected version.
Tools and confirmation
State the actions you authorize and the workspace they apply to. Destructive or billable actions need an explicit decision; a tool annotation describes an action but is not proof of your approval. Server-side permissions and concurrency checks still apply.
Accepted evaluations continue in the background if the assistant disconnects. Reconnect and inspect the run IDs, or explicitly request cancellation when that is your intention.
Retrieval keys
MCP key creation returns a dashboard handoff. Open the trusted PromptLens URL to create and copy the secret there. Listing and revoking keys remain management tools; the retrieval secret does not appear in an assistant transcript.
Disconnect
Use the client's disconnect or revoke control. Removing a server entry does not necessarily revoke its OAuth grant; follow the client's revocation behavior. Each connection is independent, and disconnecting one does not cancel accepted evaluations or sign out other clients.