> For the complete documentation index, see [llms.txt](https://docs.katara.ai/about/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.katara.ai/about/start-here/quickstart.md).

# Quickstart

This guide takes you from sign-in to your first knowledge-backed answer. You need an organization membership and permission to create the resources in your chosen workflow. If you only need to connect an AI client with an **MCP User** role, skip the business dashboard and use [MCP setup](https://docs.katara.ai/about/connect-ai-clients/connect.md).

## 1. Sign in and select an organization

1. Open your Katara application and sign in with Google or an emailed one-time password.
2. If you followed an invitation, use the invited email address and confirm the invitation.
3. Select the organization you want to work in. Organization selection matters: agents, content, access and billing belong to that workspace.
4. If you are creating an organization, enter its name, choose an available data-residency region and continue to the plan setup.

The current onboarding offers US residency; EU is marked **Coming soon**. Residency cannot be changed after creation. Moving regions requires a new organization and fresh ingestion, so make this choice before adding content.

If onboarding or payment setup interrupts the dashboard, finish the required steps or contact an administrator. Do not create duplicate organizations to work around an access error.

## 2. Choose a knowledge workflow

### Option A: create a Brain

Use this path for a personal or team knowledge space with original documents, Wiki pages and facts. It requires Brain capabilities to be enabled in your deployment.

1. Open **Brains → Create Brain**.
2. Enter a name and choose **Personal** or **Team**. The kind cannot be changed later.
3. For a Team Brain, choose its audience if you want to share it. A Team Brain without audience grants remains owner-only.
4. Create the Brain and wait for initialization/readiness before contributing.
5. Open **Sources → Upload sources**, review the audience and export disclosure, and upload your files.
6. Check upload outcomes. Then use **Activity** to request or inspect refresh work when available.
7. Open **Knowledge** to browse the resulting pages. Check freshness warnings rather than assuming an accepted upload is already reflected in the Wiki.

See [Create a Brain](https://docs.katara.ai/about/brains/create.md), [Sources](https://docs.katara.ai/about/brains/sources.md) and [Activity](https://docs.katara.ai/about/brains/activity.md).

### Option B: upload documents and create a Collection

Use this path to answer from selected original documents without a Brain Wiki.

1. Open **Agent Library → Create an agent** and create a **Content Uploader**.
2. Open **Document Upload**, select that uploader as the destination and add files.
3. Inspect accepted content under **Content Management → Content**.
4. Under **Collections**, create a collection with filters selecting the intended documents.
5. Synchronize the collection and inspect its documents and logs.

See [Content Uploader](https://docs.katara.ai/about/agents-and-answering/content-uploader.md) and [Collections](https://docs.katara.ai/about/documents-and-collections/collections.md). Collection filters do not attach existing documents to a Brain.

## 3. Configure a Q\&A agent

1. In **Agent Library**, create a **Q\&A** agent.
2. Configure exactly one answer source: your Collection or your Brain.
3. Review answering settings and save the agent.
4. Open **Prompt Lab**, select the agent and ask a specific question about your source material.
5. Inspect the answer and its available source information. If evidence is missing, check the target, permissions and readiness before changing model settings.

A saved Brain-backed Q\&A binding cannot be moved to a different target. Create another Q\&A agent when you need a different Brain. See [Q\&A agents](https://docs.katara.ai/about/agents-and-answering/qna.md).

## 4. Share deliberately

Invite teammates and use groups where appropriate. Give Brain readers **Viewer** access and contributors **Editor** access according to your needs. Separately sharing an original document does not grant access to Brain pages or facts.

For external AI clients, use the organization-specific URL from `/mcp` and browser OAuth. Do not distribute your own session token.

Next: [Access and API grants](https://docs.katara.ai/about/organization-administration/access.md), [MCP setup](https://docs.katara.ai/about/connect-ai-clients/connect.md), or [Troubleshooting](https://docs.katara.ai/about/reference/troubleshooting.md).
