• TRIAGE
  • ANALYSIS
  • REPAIR
  • HUMAN

How to debug failed RPA jobs with your AI

Connect ShadowBot to your AI client once. After that, you can just ask your agent to find the error in any specific job.

Ask AI about this page

Short answer

How do I find out why my RPA job failed?

Give your AI the Job ID and ask it to check the logs. It will pull the execution history and specific task details to tell you exactly where the process broke. You'll get a clear explanation of the error instead of a wall of text.

The outcomes.

Where every error lands.

The AI organizes the raw data into these specific outcomes.

TRIAGE

Error identification

The AI scans the logs to find the specific exception or failure point. You get a plain English summary of the crash.

ANALYSIS

Root cause discovery

By looking at the task details, the AI connects the failure to specific input data or environment issues. It explains why the logic failed.

REPAIR

Fix suggestions

The AI suggests how to adjust your automation logic or data to prevent the same error from happening again.

HUMAN

Manual intervention

If the error is a system outage or a credential issue, the AI flags that you need to fix it yourself in the RPA platform.

The workflow

What your AI does when a job fails.

The AI handles the heavy lifting of searching through logs so you don't have to.

  1. Locate the job

    The AI finds the specific execution instance you're asking about using the provided ID.

    get_task_details

  2. Fetch logs

    It pulls the raw execution logs to see the sequence of events leading up to the crash.

    list_task_logs

  3. Parse errors

    The AI reads the log entries to isolate the specific error message or timeout.

    list_task_logs

  4. Summarize findings

    It combines the task metadata and the log content into a single explanation for you.

    get_task_details

Try it

Copy these to start.

Use these prompts once you've connected ShadowBot.

Starting points

Swap out the bracketed text with your actual Job IDs or task names.

ShadowBot Connector

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

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

  • Why did job ID 98765 fail?

  • Check the logs for task 'Invoice_Processor_Run' and tell me the error.

  • Summarize the last three failed executions for the 'Data_Sync' job.

  • Look at the details for job 12345 and tell me if it was a timeout or a data error.

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

Start here

Connect ShadowBot once, then ask.

Click the link to connect your account. Your credentials stay encrypted, and you can immediately start debugging in your preferred AI client.

Connect ShadowBot to your AI

FAQ

How this task behaves

  • 01

    Can the AI fix the RPA job automatically?

    No. The AI can only read logs and task details to tell you what happened. You have to make the changes in your RPA software yourself.

  • 02

    Does the AI need my login password?

    No. Vinkius manages the connection securely. You never give your password to the AI or the platform.

  • 03

    Can the AI delete failed jobs?

    No. This MCP only has tools to read logs and task details. It cannot delete, edit, or move any jobs.

  • 04

    Can I use this with Claude?

    Yes, as long as you are using an MCP-compatible client like Claude Desktop.

  • 05

    What if I don't have the Job ID?

    You can ask the AI to list recent tasks to find the ID you need before asking for the logs.

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

Connect ShadowBot to Claude, Cursor, ChatGPT & more