Skip to main content
Use this page when you want a coding agent to help with Akua setup, operations, or troubleshooting. The agent should connect to Akua documentation first, then request authenticated platform access only when it needs workspace context.

​
Fast setup prompt

Give your agent this instruction:
The prompt tells the agent to configure the docs MCP server, configure the platform MCP server, and skip CLI installation unless akua is already installed. It also tells the agent to ask before sensitive platform actions beyond benign reads, including resource changes, spending, remote command execution, secret access, or Kubernetes exec or proxy actions.

​
What the agent configures

Use both servers when you want the agent to combine product documentation with your workspace state. Use only akua-docs when the agent only needs documentation context.

​
After setup

Ask for a read-only workspace briefing before asking the agent to create, update, delete, deploy, or spend money:
The briefing gives the agent a chance to inspect your workspace and propose the next action before it changes anything.

​
Manual setup

If your agent cannot fetch the prompt, configure the two MCP servers manually:

Add documentation context

Add akua-docs with URL https://docs.akua.dev/mcp. This server searches Akua docs and does not require authentication.

Add platform context

Add akua with URL https://mcp.akua.dev. This server connects the agent to authenticated workspace context.

Authorize platform access

Sign in through the OAuth flow for the akua server when your tool prompts you.

Confirm account and workspace

List available accounts and workspaces with read-only tools. Confirm the intended Akua account and workspace before asking the agent to summarize the workspace or inspect specific resources.
For more detail about the two MCP servers, see Documentation MCP and Platform MCP.

Quickstart

Start with an account, workspace, agent setup, and workspace briefing.

Documentation MCP

Search Akua docs from MCP-compatible AI tools.

Platform MCP

Connect an agent to authenticated Akua workspace operations.

Agent permissions

Review controls for hosted agents and workspace access.