• STATUS
  • AUDIT
  • REPORTS
  • ACTION

How to manage directory sync with your AI

Connect WorkOS to your AI client once. After that, your agent can pull live data from your HRIS and SCIM directories.

Ask AI about this page

Short answer

How can I monitor my directory syncs using AI?

Your AI client pulls real-time data from your HRIS and SCIM providers via WorkOS. You can check sync health, look up specific users, or audit group memberships. This gives you a direct view of your identity lifecycle.

Where your data lands.

Sync outcomes.

The AI pulls information from your external directories and organizes it into these specific areas.

STATUS

Sync health checks

The AI checks the status of your HRIS and SCIM connections. You'll see if provisioning is running or if a sync has stalled.

AUDIT

User and group lookups

Your agent pulls specific user profiles or group lists from your directories. This makes verifying access levels instant.

REPORTS

Directory snapshots

Get a clear view of your directory structure. The AI summarizes the current state of your users and groups as they exist in the source.

ACTION

Human intervention

The AI identifies discrepancies or failed syncs. You'll need to step in to fix data errors in your HRIS or manually resolve provisioning conflicts.

The workflow

What your AI does when the sync status changes.

The AI acts as a bridge between your identity provider and your chat interface.

  1. Identify directories

    The AI first finds all connected identity providers to see which ones are active.

    list_directories

  2. Check connection health

    It pulls the specific configuration and status for a chosen directory to see if it's healthy.

    get_directory_details

  3. Inspect user data

    The agent looks up individual users within a directory to verify their current attributes.

    list_directory_users

  4. Verify group membership

    It checks the contents of specific groups to ensure the sync correctly mapped your users.

    list_directory_groups

Try it

Copy these to start.

Use these prompts to begin interacting with your WorkOS data.

Starting points

Replace the bracketed text with your actual directory names or user emails.

WorkOS Connector

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

Connector linkhttps://edge.vinkius.com/vk_preview_rwxMA9lZDQOsPAB4YWRqrtYcwkF7I80gqKgTYNRP/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 — WorkOS capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "workos-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_rwxMA9lZDQOsPAB4YWRqrtYcwkF7I80gqKgTYNRP/mcp"
    }
  }
}
Copy into chat04

  • List all my connected directories to see what's synced.

  • Show me the details for the [Directory Name] directory.

  • Find the user [Email Address] in my directory and show their info.

  • Who is currently in the [Group Name] group?

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

Start here

Connect WorkOS once, then ask.

Follow the link to authorize the connection. Your credentials stay encrypted, and you can immediately start asking your AI about your directory status.

Connect WorkOS to your AI

FAQ

How this task behaves.

  • 01

    Can the AI fix a failed sync automatically?

    No. The AI can identify that a sync has failed, but you must go into your HRIS or SCIM provider to fix the underlying data issue.

  • 02

    Can I use the AI to delete users from my directory?

    No. This Connector only provides read access to list and inspect directory data. It cannot modify or delete users.

  • 03

    Does the AI see my admin passwords?

    No. Your credentials are encrypted and handled by Vinkius. The AI only interacts with the data exposed through the tools.

  • 04

    Can I see group memberships for all directories at once?

    The AI can do this if you ask it to check multiple directories, but it must query each one individually using the available tools.

  • 05

    How often is the directory data updated?

    The AI pulls live data from WorkOS whenever you ask a question, so you are seeing the current state of your directories.

  • More questions about WorkOS? See everything the WorkOS Connector can do

Connect WorkOS to Claude, Cursor, ChatGPT & more