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

# Quickstart

Connect Mozark and complete your first action.

Get from zero to your first Mozark action in about five minutes.

## Before you start

* A Mozark account with access to at least one **organisation, project and app**. [Create an account](https://mozark.ai) if you need one.
* An MCP-compatible client — Claude (web/desktop), Claude Code, Cursor, VS Code, Windsurf or Codex.

{% stepper %}
{% step %}

## Connect the server

Add the Mozark MCP server to your client using this endpoint:

```
https://mcp.mozark.ai/mcp
```

Client-specific steps are in [Connect your client](/mcp/mozark-mcp-docs/getting-started/connect-your-client.md).
{% endstep %}

{% step %}

## Sign in

The first time the assistant calls a Mozark tool, your client opens a browser window to sign in to Mozark. Approve the request. Your credentials are never shared with the AI model — the client holds the token.
{% endstep %}

{% step %}

## Confirm your working context

Every Mozark action happens inside an **organisation → app → project**. Ask:

> *"What's my active Mozark context?"*

The assistant calls `mozark_get_active_context`. If nothing is set, it walks you through picking an organisation, project and app and locks them in for the session. See [Authentication and context](/mcp/mozark-mcp-docs/getting-started/authentication-and-context.md).
{% endstep %}

{% step %}

## Try something

Pick any of these:

> *"List the test cases in my current project."*

> *"Which devices are free right now?"*

> *"Generate positive functional test cases for the login journey."*
> {% endstep %}
> {% endstepper %}

## What next?

{% content-ref url="/spaces/sKHRrJ2t9qZCDuT5wRkG/pages/7e2ddcdb43228c22748d016bbe753ef65508552d" %}
[Generate test cases](/mcp/mozark-mcp-docs/guides/generate-test-cases.md)
{% endcontent-ref %}

{% content-ref url="/spaces/sKHRrJ2t9qZCDuT5wRkG/pages/cf18bb4584e9a1d1dcd8d03065d9dd2913905f43" %}
[Run tests on a real device](/mcp/mozark-mcp-docs/guides/run-tests-on-a-real-device.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.mozark.ai/mcp/mozark-mcp-docs/getting-started/quickstart.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.