• MEMBERSHIP
  • INVENTORY
  • SECURITY
  • HUMAN

How to audit workspace permissions with your AI

Connect Stoplight to your AI client to pull real-time access data. Once connected, you can ask your agent to scan for unauthorized users or outdated memberships.

Ask AI about this page

Short answer

Can my AI check who has access to my Stoplight workspaces?

Yes. Your AI uses Stoplight tools to list all active workspaces and their specific members. You'll get a clear view of your current access landscape.

Audit outcomes

Where your data lands

The AI organizes your Stoplight access data into these four categories.

MEMBERSHIP

User access lists

The AI pulls every user currently assigned to a workspace. You get a clean list of names and roles to check against your records.

INVENTORY

Workspace overview

Your agent identifies every workspace under your account. This helps you find forgotten projects that still have active users.

SECURITY

Permission gaps

The AI flags users who shouldn't have access based on your instructions. You receive a summary of potential risks.

HUMAN

Manual cleanup

The AI identifies the users that need to be removed. You must log in to Stoplight to actually revoke their access.

The workflow

What your AI does when the request arrives.

The AI moves from broad account oversight to specific user audits.

  1. Map the environment

    Your agent first identifies all available Stoplight workspaces to establish the scope of the audit.

    list_workspaces

  2. Pull user data

    The AI looks inside each identified workspace to grab the full list of members.

    list_workspace_members

  3. Analyze membership

    Your agent compares the current member lists against your specific security requirements.

    list_workspace_members

  4. Report findings

    The AI presents a clear summary of who has access and where permissions might be too broad.

    list_workspaceslist_workspace_members

Try it

Copy these to start.

Use these prompts to trigger the audit immediately.

Starting points

These are opening lines. Swap out the workspace names for your actual Stoplight project names.

Stoplight Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_aafvDKV5H0XnKaJJQxGGJwn6mIM7hALMzWdPNAou/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Stoplight capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "stoplight-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_aafvDKV5H0XnKaJJQxGGJwn6mIM7hALMzWdPNAou/mcp"
    }
  }
}
Copy into chat04

  • List all members in my 'Core API' workspace.

  • Show me all the Stoplight workspaces I have access to.

  • Are there any users in the 'Mobile Gateway' workspace that I didn't mention?

  • Give me a list of all members across all my Stoplight workspaces.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Stoplight once, then ask.

Click the link to authorize the connection. Your credentials stay encrypted, and you can immediately start asking questions in your preferred AI client.

Connect Stoplight to your AI

FAQ

How this task behaves

  • 01

    Can the AI remove users from a workspace?

    No. The AI can only read and list existing members. You have to manually remove users within the Stoplight UI.

  • 02

    Can the AI create new workspaces?

    No. This MCP is limited to reading workspace and member data.

  • 03

    Does the AI see my Stoplight password?

    No. Your login credentials are encrypted and never shared with the AI model.

  • 04

    Can I audit permissions for a workspace I don't own?

    No. The AI can only see the workspaces and members that your specific account has permission to view.

  • 05

    Will the AI change any API documentation settings?

    No. The AI only has read access to membership and workspace lists; it cannot modify your API specs.

  • More questions about Stoplight? The Connector page answers them. See everything the Stoplight Connector can do

Connect Stoplight to Claude, Cursor, ChatGPT & more