> ## 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.

# Quickstart

> Connect Claude Desktop, Cursor, Claude Code, VS Code, or ChatGPT to the User Intuition MCP server.

## 1. Get an API key

Sign up at [app.userintuition.ai](https://app.userintuition.ai) and create a key under
**Settings → API Keys**. Keys look like `ui_sk_...`.

## 2. Connect your client

<Tabs>
  <Tab title="Claude Desktop">
    Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "userintuition": {
          "command": "npx",
          "args": ["-y", "@userintuition-ai/mcp"],
          "env": { "USERINTUITION_API_KEY": "ui_sk_your_key_here" }
        }
      }
    }
    ```
  </Tab>

  <Tab title="Cursor">
    Add to `.cursor/mcp.json` (same `mcpServers` block as Claude Desktop).
  </Tab>

  <Tab title="Claude Code">
    ```bash theme={null}
    claude mcp add userintuition -- npx -y @userintuition-ai/mcp
    ```

    Then set `USERINTUITION_API_KEY` in your environment.
  </Tab>

  <Tab title="VS Code">
    Add to `.vscode/settings.json` under `"mcp.servers"` (same block as Claude Desktop).
  </Tab>

  <Tab title="ChatGPT">
    Settings → Connectors → Create. MCP Server URL: `https://mcp.userintuition.ai/mcp`.
    Authentication: OAuth (auto-discovered).
  </Tab>
</Tabs>

## 3. Verify

Ask the client to run `list_studies`. A successful call confirms the connection.

## Install matrix

| Client         | Transport               | Setup                                                          | Auth                    | First-success check    |
| -------------- | ----------------------- | -------------------------------------------------------------- | ----------------------- | ---------------------- |
| Claude Desktop | stdio                   | `npx -y @userintuition-ai/mcp` in `claude_desktop_config.json` | `USERINTUITION_API_KEY` | `list_studies` returns |
| Cursor         | stdio                   | `npx -y @userintuition-ai/mcp` in `.cursor/mcp.json`           | `USERINTUITION_API_KEY` | `list_studies` returns |
| Claude Code    | stdio                   | `claude mcp add userintuition -- npx -y @userintuition-ai/mcp` | `USERINTUITION_API_KEY` | `list_studies` returns |
| VS Code        | stdio                   | `npx -y @userintuition-ai/mcp` in `.vscode/settings.json`      | `USERINTUITION_API_KEY` | `list_studies` returns |
| ChatGPT        | Streamable HTTP + OAuth | connector to `https://mcp.userintuition.ai/mcp`                | OAuth (auto-discovered) | `list_studies` returns |