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

# Workspace setup

> From first sign-in to API keys and verification — humans steer, agents execute.

<Warning>
  **Early access** — Settings labels and onboarding steps shift between releases. Screenshots: **coming soon**. [**Join the Product Brain Community**](https://community.productbrain.io) if the UI diverges from this page.
</Warning>

This page gets a **human** from “I just signed up” to “my workspace is ready for agents” in a few minutes. Your **agent** handles repetitive steps (`pb login`, MCP config) once you point it at this guide.

## 1. Sign in

Open [work.productbrain.io](https://work.productbrain.io) and complete account creation. Use a workspace you intend to connect to Cursor/Claude/etc.

## 2. Create or join a workspace

From the workspace switcher, create a workspace or accept an invite. Pick a slug you are comfortable seeing in URLs (`/w/<slug>/…`).

Screenshot: **coming soon**.

## 3. Invite teammates (optional)

When you collaborate, invite others from **Members** (see [Workspace members](/docs/workspace/members)). Everyone shares the same Chain within the workspace.

## 4. Generate an API key

Go to **Settings → API keys** (workspace-scoped). Create:

* a **read** key for experiments, or
* a **read-write** key when agents should capture and commit (subject to governance).

Copy the `pb_sk_…` value once; store it in a password manager.

Screenshot: **coming soon**.

## 5. Choose your connection path

Return to [Connect your tools](/docs/integrations/overview) and wire MCP or `pb`. Confused by packages? Read [pb vs MCP package](/docs/pb-and-mcp).

## 6. Activation vs readiness

**Activation** (Bridge) tracks onboarding milestones—first key, first capture, first connector.

**Readiness** is the ongoing health of your Chain (stale entries, review debt). They are not interchangeable labels.

Deep dive: [Bridge](/docs/working-in-the-app/bridge).

## 7. Verify

**You:** “Check that Product Brain is wired up.”

**Your agent:**

```bash theme={null}
pb doctor
```

Or, for MCP-only workflows, ask the agent to run MCP **`orient`** and confirm it returns workspace context.

## Next steps

* [Quickstart](/docs/quickstart)
* [Install pb](/docs/install)
* [Settings & admin](/docs/working-in-the-app/settings-admin)