> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apexgenius.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Common Issues

> Fixes for Salesforce connection, metadata sync, workspace, and MCP problems.

## Connection issues

**"SF Connected" shows red or disconnected.**

1. Check your Salesforce session hasn't expired.
2. Verify the OAuth configuration in Salesforce.
3. Re-authenticate through **Dashboard → Connections**.
4. Check network connectivity.

## Metadata sync issues

**Sync fails or shows 0 components.**

1. Verify the Salesforce connection is active (green indicator).
2. Try running a new sync.
3. Check the user's permissions in Salesforce (API access is required).
4. Contact support if it persists.

**Sync is stuck "Loading in progress."**

1. Check the project activity and wait while the current sync is still running.
2. Refresh the page and check the Metadata tab.
3. Start a new sync only after the current run has failed or stopped.

## AI client issues

**AI says "No metadata loaded."**

1. Go to **Dashboard → Metadata**.
2. Check the sync completed successfully.
3. Run a sync if the count is 0.
4. Confirm the AI client is connected to ApexGenius and retry the request.

**Generic responses.** Make sure metadata is loaded, name the intended project, be more specific, and reference component names directly.

<Note>
  **The legacy web chat is retired.**

  Use the ApexGenius web workspace to manage connections, projects, metadata, files, activity, and settings. Ask questions and run tools from a connected AI client.
</Note>

## MCP issues

See the [MCP setup guide](/guides/mcp-setup). Its troubleshooting section covers missing tools and browser authorization. For account gating, check **Settings → Billing** in the [ApexGenius workspace](https://www.apexgenius.ai/auth).