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

# Troubleshooting

> Solutions for auth errors, stale npx cache, ChatGPT OAuth setup, tools not loading, and how to reach support.

## Auth errors / 401 responses

If you receive a `401 Unauthorized` error, check two things:

1. The `USERINTUITION_API_KEY` environment variable is set in your MCP client's
   configuration.
2. The key value begins with `ui_sk_`. Keys that start with anything else are not
   valid API keys for this server.

Keys are issued from **Settings → API Keys** at
[app.userintuition.ai](https://app.userintuition.ai). If your key is correct but
you are still seeing 401s, regenerate the key from that page and update your
client config.

## Stale npx cache

`npx` caches packages locally. If an older version of `@userintuition-ai/mcp` is
cached, you may be running stale code even after a package update.

Clear the cache with:

```bash theme={null}
npx clear-npx-cache
```

Or force a fresh download on the next run:

```bash theme={null}
npx -y @userintuition-ai/mcp@latest
```

## ChatGPT OAuth connector setup

The ChatGPT connector uses the Streamable HTTP transport and requires OAuth. Before
you can add the MCP server URL, you must enable developer mode in ChatGPT:

1. Open **Settings → Apps & Connectors → Advanced**.
2. Toggle **Enable Developer Mode**.
3. Go to **Settings → Connectors → Create** and fill in:
   * **Name:** User Intuition
   * **MCP Server URL:** `https://mcp.userintuition.ai/mcp`
   * **Authentication:** OAuth (auto-discovered)

If Developer Mode is not enabled, the MCP Server URL field will not appear.

## Tools not visible after editing config

Most MCP clients (Claude Desktop, Cursor, VS Code) load MCP servers only at
startup. If you edit your config file to add or update the `userintuition` server
block, the new tools will not appear until you fully restart the client application.

Reload or restart the client after any config change.

## Getting help

* Use the `contact_support` MCP tool directly — it sends a support request and CCs
  you on the confirmation email.
* Email [support@userintuition.ai](mailto:support@userintuition.ai) for account or
  billing issues.