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

# Quickstart

> Create an Akua account, connect an agent, and ask for a workspace briefing

This quickstart gets Akua into the hands of a coding agent. You will create or open a workspace, connect documentation and platform context, and ask the agent to recommend your next setup steps.

## Fastest path

Give your coding agent this instruction:

```text theme={null}
Fetch https://docs.akua.dev/agent-setup/prompt and follow it for this workspace.
```

The prompt configures `akua-docs` at `https://docs.akua.dev/mcp` for current documentation and `akua` at `https://mcp.akua.dev` for authenticated workspace context.

## Prerequisites

* An Akua account at [akua.dev](https://akua.dev)
* Access to the workspace you want the agent to inspect
* A coding agent or AI tool that supports remote MCP servers

## Set up your workspace

<Steps>
  <Step title="Create or sign in to your account" icon="user-plus">
    Open [akua.dev](https://akua.dev), create an account, or sign in with your existing account.
  </Step>

  <Step title="Open a workspace" icon="building">
    Choose the workspace the agent should use. A workspace is the boundary for Products, clusters, billing, and agent access.
  </Step>

  <Step title="Connect your agent" icon="robot">
    Ask your coding agent to fetch `https://docs.akua.dev/agent-setup/prompt`, then let it configure the docs MCP server and the platform MCP server.
  </Step>

  <Step title="Authorize the platform server" icon="key">
    Complete the OAuth flow for `https://mcp.akua.dev` when your agent asks. The docs server at `https://docs.akua.dev/mcp` does not require sign-in.
  </Step>

  <Step title="Ask for a workspace briefing" icon="messages">
    Start with a read-only prompt so the agent inspects the workspace before changing anything.

    ```text theme={null}
    Summarize my Akua workspace and recommend the next three setup steps.
    ```
  </Step>
</Steps>

## Next paths

<CardGroup cols={2}>
  <Card title="Agent setup" icon="robot" href="/agent-setup">
    Configure a coding agent with Akua docs and platform MCP servers.
  </Card>

  <Card title="Platform MCP" icon="server" href="/ai/platform-mcp">
    Review authenticated workspace access for MCP-compatible agents.
  </Card>

  <Card title="Prepare compute" icon="server" href="/clusters/create">
    Create managed Kubernetes infrastructure or connect a cluster you operate.
  </Card>

  <Card title="Package software" icon="cube" href="/packages">
    Turn software source into a reusable Package version.
  </Card>

  <Card title="Create a Product" icon="box" href="/products">
    Wrap a Package version as customer-facing software.
  </Card>

  <Card title="Configure Offers" icon="store" href="/marketplace/offers">
    Create private Offer links and customer install paths.
  </Card>
</CardGroup>