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

# Quickstart: Connect Hyper to Your AI Client

> Install the Hyper desktop app, sign in with Google, join a workspace, and wire up your AI client as an MCP server in under 5 minutes.

Getting Hyper running takes about five minutes. You'll install the macOS desktop app, authenticate with Google, and configure your AI client — Claude, Cursor, or Codex — to connect to Hyper's MCP server. After that, every session your agents run will automatically brief itself from your team's shared memory.

<Note>
  Hyper is currently macOS-only. Windows support is on the roadmap — sign up at [heyhyper.ai](https://heyhyper.ai) to be notified when it ships.
</Note>

## Prerequisites

Before you start, make sure you have:

* A Mac running **macOS 12 Monterey or later**
* At least one AI coding client installed: [Claude Code](https://claude.ai/code), [Claude Desktop](https://claude.ai/download), [Cursor](https://cursor.sh), or [OpenAI Codex CLI](https://github.com/openai/codex)
* A Google account for authentication

***

## Setup steps

<Steps>
  <Step title="Download and install the desktop app">
    Visit [heyhyper.ai](https://heyhyper.ai) and click **Download for macOS**. Open the downloaded `.dmg`, drag Hyper into your Applications folder, and launch it.

    The desktop app is built on Tauri and runs natively on macOS — no Electron overhead, no browser tab to keep alive.
  </Step>

  <Step title="Sign in with Google">
    Hyper uses Google OAuth for authentication. Click **Sign in with Google** in the app and complete the OAuth flow in the browser window that opens. Once authenticated, you'll land on the workspace selection screen.

    <Info>
      Your Google credentials are never stored by Hyper directly — only the OAuth token issued by Google is used to authenticate your session.
    </Info>
  </Step>

  <Step title="Create or join a workspace">
    A workspace is the shared memory space for your team. You have two options:

    <Tabs>
      <Tab title="Create a new workspace">
        Click **New Workspace**, give it a name (usually your company or project name), and choose whether it's a **Personal** or **Team** workspace. You'll become the admin automatically.
      </Tab>

      <Tab title="Join an existing workspace">
        If a teammate has already set up a workspace, ask them for the invite link or **join token**. Click **Join Workspace**, paste the token, and confirm. You'll join as a member.
      </Tab>
    </Tabs>

    <Tip>
      Not sure which to pick? Start with a personal workspace to try Hyper solo, then create or join a team workspace when you're ready to share memory with colleagues.
    </Tip>
  </Step>

  <Step title="Connect your AI client">
    Hyper exposes an MCP server your AI client connects to. Choose your client below and follow the configuration steps.

    <Tabs>
      <Tab title="Claude Code / Claude Desktop">
        Open your Claude configuration file (`~/.claude/claude_desktop_config.json` for Claude Desktop, or the equivalent for Claude Code) and add the following entry under `mcpServers`:

        ```json theme={null}
        {
          "mcpServers": {
            "hyper": {
              "url": "https://hyperlink.gethyper.space/mcp"
            }
          }
        }
        ```

        Restart Claude after saving.
      </Tab>

      <Tab title="Cursor">
        In Cursor, open **Settings → MCP Servers** and add a new server:

        * **Name:** `hyper`
        * **URL:** `https://hyperlink.gethyper.space/mcp`

        Save and restart Cursor.
      </Tab>

      <Tab title="Codex CLI">
        Add the MCP server to your Codex configuration file:

        ```json theme={null}
        {
          "mcp": {
            "servers": {
              "hyper": {
                "url": "https://hyperlink.gethyper.space/mcp"
              }
            }
          }
        }
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="Verify with the connect tool">
    Start a new session in your AI client and ask it to call the `connect` tool. Hyper will authenticate the session, register the agent, and return a **briefing** — a digest of your team's current context pulled from your workspace memory.

    A typical `connect` call looks like this:

    ```text theme={null}
    connect()
    ```

    Or, if you're joining with a specific workspace token and timezone:

    ```text theme={null}
    connect(join_token="abc123", tz="America/New_York")
    ```

    **Example briefing response:**

    ```text theme={null}
    ✅ Connected to workspace: Acme Engineering
    📋 Briefing as of 2025-06-10:

    Current sprint goal: Ship the billing migration by June 20.
    Auth stack: Supabase (RLS enabled for multi-tenant isolation).
    API versioning decision: Prefix all new routes with /v2/.
    Alice is leading the payments module; blocked on Stripe webhook retry logic.
    ```

    If you see a briefing, Hyper is working correctly.
  </Step>

  <Step title="Run your first ask">
    Now test memory retrieval directly. Ask your AI client to call the `ask` tool with a question about your project:

    ```text theme={null}
    ask("What auth library are we using and why?")
    ```

    Hyper searches your workspace memory — including past decisions, team notes, and synthesized context — and returns a grounded answer:

    ```text theme={null}
    We're using Supabase Auth. The decision was made on 2025-05-14 because it
    includes Row-Level Security (RLS) out of the box, which is required for
    multi-tenant isolation. Firebase Auth and a custom JWT approach were
    evaluated but ruled out due to complexity and maintenance overhead.
    ```

    <Tip>
      If the answer comes back empty, it just means no one has recorded that memory yet. Use `remember()` to capture important decisions as you make them.
    </Tip>
  </Step>
</Steps>

***

## What's next

You're connected. Here's where to go from here:

<CardGroup cols={2}>
  <Card title="Claude Setup Guide" icon="robot" href="/guides/claude-setup">
    Detailed Claude Code and Claude Desktop configuration
  </Card>

  <Card title="Cursor Setup Guide" icon="pen-to-square" href="/guides/cursor-setup">
    Step-by-step Cursor MCP configuration
  </Card>

  <Card title="How Memory Works" icon="brain" href="/concepts/memory">
    Learn how Hyper classifies and stores what agents remember
  </Card>

  <Card title="Invite Your Team" icon="users" href="/guides/team-onboarding">
    Add teammates and share a workspace
  </Card>
</CardGroup>