• PIPELINE
  • STATUS
  • GAPS
  • HUMAN

How to audit workflow states with your AI

Connect Shortcut to your AI client to start scanning your project structure. Your agent can then map out pipelines and check individual story statuses.

Ask AI about this page

Short answer

How can I audit my workflow states with AI?

Your AI uses Shortcut data to map custom pipelines and check the status of specific stories. This lets you spot stuck tasks and verify your project organization. Here is how it works.

Audit outcomes.

Where your data lands.

These are the specific insights your agent provides after scanning Shortcut.

PIPELINE

Workflow maps

The AI pulls your custom pipeline structures so you can see the path work takes. You get a clear view of your project's logic.

STATUS

Story state checks

Your agent checks individual stories to see if they are in the right stage. This confirms your team is following the defined process.

GAPS

Identify stuck work

The AI finds stories that have stalled in a single state. You get a list of tasks that need immediate attention.

HUMAN

Manual cleanup

The AI flags where your pipeline logic is broken. You decide how to fix the organization in Shortcut.

The workflow

What your AI does when the request arrives.

The AI uses specific Shortcut tools to pull the data needed for your audit.

  1. Map pipelines

    The agent pulls a list of all custom workflows in your Shortcut instance.

    list_workflows

  2. Find stories

    Your AI searches for specific stories within your projects to inspect them.

    search_stories

  3. Check states

    The agent looks at the current status of the stories it found.

    search_stories

  4. Flag errors

    The AI compares the story states against your pipeline structure to find mismatches.

    list_workflowssearch_stories

Try it

Copy these to start.

Paste these into your chat to begin the audit.

Starting points

These are opening lines. Replace the project names and pipeline titles with your actual Shortcut names.

Shortcut Connector

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

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

  • List all my current workflows in Shortcut so I can see my pipeline structure.

  • Check the 'In Progress' state for all stories in the Mobile App project.

  • Find any stories in the 'Beta' pipeline that are stuck in the 'Review' state.

  • Audit my 'Feature Development' workflow and tell me if any stories are in the wrong stage.

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

Start here

Connect Shortcut once, then ask.

Link your Shortcut account to get started. Your login stays encrypted on our side, and you can immediately start asking questions about your workflows.

Connect Shortcut to your AI

FAQ

How this task behaves.

  • 01

    Can the AI change my story states?

    No. The AI can only read and search your data. You have to move stories manually in Shortcut.

  • 02

    Can the AI create new pipelines?

    No. This Connector is for auditing and reading existing data, not for creating or modifying your Shortcut configuration.

  • 03

    How does the AI know which stories to check?

    It uses the search tools to find stories based on the project names or status labels you provide in your prompt.

  • 04

    Does the AI see all my Shortcut data?

    The AI only sees the data it needs to answer your specific question based on the tools it uses.

  • 05

    Can I audit multiple projects at once?

    Yes, as long as you specify the different projects in your prompt so the AI knows where to look.

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

Connect Shortcut to Claude, Cursor, ChatGPT & more