Troubleshooting

link

I don't see my applications​

• Check that Screen Context is enabled (toggle at bottom of window)
• Verify screen recording/accessibility permissions are granted in System Settings (macOS) or that UAC (User Account Control) was accepted (Windows)
• Restart Delegate after granting permissions

Delegate says it can't access a website​

• Check your internet connection
• Some corporate networks block certain AI services—contact your IT department if you suspect this
• Try a different website to isolate the issue

The browser extension isn't detected​

• Ensure the extension is installed and enabled in your browser
• On Chrome: chrome://extensions → Delegate should be listed and enabled
• Restart your browser after installation
• Re-run the Setup Wizard from Settings if needed

I can't sign in​

• Verify your UiPath account credentials
• If your organization uses SSO (Single Sign-On), ensure you are on the corporate network or VPN
• Check that your tenant is correctly selected

Delegate didn't understand what I wanted​

• Break the request into smaller steps
• Be more explicit about the goal and format
• Provide an example of the desired output

It started doing something I didn't expect​

• Press Escape to stop
• Ask "What are you trying to do?" to understand its reasoning
• Redirect with a clearer instruction

The task is taking too long​

• Check if you are in Background mode (slower but non-blocking)
• Ask for a status update: "What's taking so long?"
• Consider breaking into smaller chunks for complex tasks

It keeps asking for confirmation​

• You are in Guided mode—this is expected for safety
• Switch to Autonomous mode for trusted, repetitive workflows
• Review Security settings if you want to adjust what triggers confirmation

Delegate says it doesn't have permission​

1. Check Settings → Security → the relevant tool category is enabled.
2. Check Tool permissions for the specific tool or connector operation.
3. Check if the target app or site is in Blocked apps/websites under UI automation, or the path matches a category under Protected files.
4. Try switching to Cautious mode temporarily to see the specific denial.

I approved an action but it still failed​

1. Check OS-level permissions (macOS Privacy settings, Windows UAC).
2. Verify the application or site is not in Blocked apps/websites under UI automation.
3. Check if the file path matches a category under Protected files.
4. Review the error message — it may indicate a different issue (network, auth, etc.)

I want to allow a site that's blocked​

1. Open Settings → Security → UI automation, and check Blocked websites — remove the site if it's listed individually, or if it was added as part of a category (Banking, Payments, Crypto, Password Manager, Government, Healthcare).
2. If the setting is locked and shows as managed by your organization, contact your administrator instead — it is enforced through Automation Ops and cannot be changed locally.

A skill keeps asking for permissions I already granted​

1. Check if the skill is requesting a different permission than before.
2. Verify the skill's manifest matches what it actually uses.
3. Some permissions are session-scoped and require re-approval.
4. Check Settings → Permissions → Allowed Agents to ensure the relevant agent is enabled.

Integration Service: Connection failed or Authentication error​

Causes​

• OAuth token expired
• Password changed in the source service
• Organization policy revoked third-party access
• Insufficient permissions granted

Solutions​

1. Go to Settings → Connections → Reconnect.
2. If that fails, revoke and recreate the connection.
3. Check the service's own third-party app settings.
4. Verify you have the necessary permissions in the source application.

Integration Service: No connection found for [service]​

Solutions​

1. Create the connection in Settings → Connections.
2. Or specify a different approach that does not require that service.

Integration Service: Insufficient permissions​

Solutions​

1. Disconnect and reconnect, granting additional permissions when prompted.
2. Check with your IT administrator if organization policies restrict scopes.

MCP: Failed to connect to MCP server​

Causes​

• Remote server is down or unreachable
• Local process failed to start
• Network/firewall blocking the connection
• Invalid URL or configuration

Solutions​

1. Verify the server is running (for local) or accessible (for remote).
2. Check the URL/command for typos.
3. Test the endpoint manually (curl, browser).
4. Check firewall settings.
5. Review local process logs for startup errors.

MCP: Server connected but no tools available​

Solutions​

1. Check the server's documentation for required configuration.
2. Verify environment variables are set correctly.
3. Restart the MCP server.
4. Check server logs for initialization errors.

MCP: Tool call failed or MCP error​

Solutions​

1. Check the specific error message in the tool card.
2. Verify the tool's required parameters were provided.
3. Check if the underlying resource (file, database, API) is accessible.
4. Review MCP server logs for detailed error information.

Routine not found​

Solutions​

1. Check if the Routine is in Settings → Routines.
2. If imported, re-import from the original file.
3. Check the LocalSkills folder path in Settings → Skills & Marketplace.

Missing required input​

Solutions​

1. When running, fill in all prompted inputs.
2. If scheduling, ensure fixed values are set for all required inputs.
3. Edit the Routine to make inputs optional with defaults.

Routine failed at step X​

Solutions​

1. Check the error message in the tool card.
2. Verify required connections are active (Settings → Connections).
3. Ensure input files exist and are accessible.
4. Check if target applications are installed.
5. Run in Guided mode to see exactly where it fails.

Scheduled Routine didn't run​

Solutions​

1. Check Settings → Routines → Scheduled for the run status.
2. Verify Delegate was running at the scheduled time.
3. Check if the machine was asleep (schedules may not run while asleep).
4. Review the run history for error messages.
5. Ensure connections are still valid (not expired).

Item won't install​

Causes​

• Network connectivity issue
• Insufficient disk space
• Corrupted download
• Incompatible Delegate version

Solutions​

1. Check internet connection.
2. Free up disk space (check LocalSkills directory).
3. Try installing again.
4. Check if your Delegate is up to date.
5. Contact the publisher if the issue persists.

Installed skill doesn't appear​

Causes​

• Skill is disabled
• Not added to enabledSkills list
• Delegate needs restart

Solutions​

1. Check Settings → Skills & Marketplace → the skill is listed and enabled.
2. Restart Delegate.
3. Check the LocalSkills folder for the skill files.

Skill fails when I try to use it​

Causes​

• Missing required connections
• Missing required permissions
• Outdated skill version
• Application version mismatch

Solutions​

1. Check the skill's documentation for prerequisites.
2. Create required connections in Settings → Connections.
3. Enable required tool categories in Settings → Security.
4. Update the skill to the latest version.
5. Check if the target application version is supported.

Custom feed won't load​

Causes​

• Invalid feed URL
• Feed server down
• Feed format incorrect
• Network/firewall blocking

Solutions​

1. Verify the URL is correct and accessible in a browser.
2. Check feed format against UiPath specification.
3. Contact the feed administrator.
4. Check corporate firewall settings.

Setting changes don't take effect​

Solutions​

1. Restart Delegate and check if the setting took effect.
2. If the setting is on the Security or Permissions tab, use the Settings UI rather than editing the file directly.
3. If editing settings.json manually, verify you are editing the correct file path.

Settings file is corrupted​

Solutions​

1. Close Delegate.
2. Delete or rename settings.json.
3. Restart Delegate — fresh defaults are created.
4. Reconfigure your preferences.

Cannot find a setting​

Solutions​

1. Check if the setting is on the Security tab (UI-only).
2. Verify your Delegate version — some settings are version-specific.

Secure settings won't save​

Solutions​

1. Check OS-level security permissions.
2. macOS: Ensure Keychain is unlocked.
3. Windows: Ensure your user profile is properly loaded.
4. Restart Delegate.
5. If persistent, contact UiPath Support.