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

# Quickstart

> Mint an API key, install the Reality Harness MCP, and see your first XP.

This walks through Level 1 — commits only. It's the fastest path to seeing real XP, and everything here still works once you add Level 2 or Level 3 later.

<Steps>
  <Step title="Mint an API key">
    Go to [app.conquoreum.com/deck/setup](https://app.conquoreum.com/deck/setup) and sign in. The setup wizard mints a scoped key for you — see [Minting your first API key](/get-started/minting-your-first-api-key) if you want the full walkthrough. The key looks like `cqk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` and is shown to you exactly once — copy it before you continue.
  </Step>

  <Step title="Install the Reality Harness MCP">
    ```bash theme={null}
    git clone <your reality-harness-mcp repo>
    cd reality-harness-mcp
    npm install
    npm run build
    ```

    Requires Node 18 or newer.
  </Step>

  <Step title="Add it to your MCP client">
    Paste into `claude_desktop_config.json` (Claude Desktop) or your project's `.mcp.json` (Claude Code), replacing the path with your actual clone's `dist/index.js`:

    ```jsonc theme={null}
    {
      "mcpServers": {
        "reality-harness": {
          "command": "node",
          "args": ["/absolute/path/to/reality-harness-mcp/dist/index.js"],
          "env": {
            "CONQUOREUM_CONVEX_URL": "https://api.conquoreum.com",
            "CONQUOREUM_API_TOKEN": "cqk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
          }
        }
      }
    }
    ```

    Or, with the Claude Code CLI:

    ```bash theme={null}
    claude mcp add reality-harness node \
      /absolute/path/to/reality-harness-mcp/dist/index.js \
      -e CONQUOREUM_CONVEX_URL='https://api.conquoreum.com' \
      -e CONQUOREUM_API_TOKEN='cqk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
    ```
  </Step>

  <Step title="Connect a folder and see your first XP">
    Ask your MCP client to call `reality_harness_connect_folder` on a repo you work in (must have a `.git` or `docs/` folder, and live under your home directory). From there, `reality_harness_submit_progress` reports your commits and completed planning checkboxes to Conquoreum, and XP shows up in the Throne Room.
  </Step>
</Steps>

<Note>
  If `CONQUOREUM_CONVEX_URL` or `CONQUOREUM_API_TOKEN` is unset, the MCP runs in mock mode — every tool still works, but nothing is sent to Conquoreum. Good for trying it out before you mint a real key.
</Note>

## Go further

<CardGroup cols={2}>
  <Card title="Level 2 — + Outcomes" icon="trophy" href="/reality-harness/level-2-outcomes">
    Submit a real payment, release, or evaluation for bonus XP.
  </Card>

  <Card title="Level 3 — + Board sync" icon="layout-list" href="/reality-harness/level-3-board-sync">
    Sync an Obsidian task board into the Throne Room checklist.
  </Card>

  <Card title="Tool reference" icon="wrench" href="/reality-harness/tool-reference">
    All 8 MCP tools, in detail.
  </Card>

  <Card title="Scopes reference" icon="key" href="/api-keys/scopes">
    What each API key scope unlocks.
  </Card>
</CardGroup>