Skip to main content
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:
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
  • 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

Create or sign in to your account

Open akua.dev, create an account, or sign in with your existing account.

Open a workspace

Choose the workspace the agent should use. A workspace is the boundary for Products, clusters, billing, and agent access.

Connect your agent

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.

Authorize the platform server

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.

Ask for a workspace briefing

Start with a read-only prompt so the agent inspects the workspace before changing anything.

​
Next paths

Agent setup

Configure a coding agent with Akua docs and platform MCP servers.

Platform MCP

Review authenticated workspace access for MCP-compatible agents.

Prepare compute

Create managed Kubernetes infrastructure or connect a cluster you operate.

Package software

Turn software source into a reusable Package version.

Create a Product

Wrap a Package version as customer-facing software.

Configure Offers

Create private Offer links and customer install paths.