> ## 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.

# Agent Setup

> Connect a coding agent to Akua documentation and workspace context

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:

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

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

| Server      | URL                         | Auth      | Use it for                                  |
| ----------- | --------------------------- | --------- | ------------------------------------------- |
| `akua-docs` | `https://docs.akua.dev/mcp` | None      | Search current Akua documentation           |
| `akua`      | `https://mcp.akua.dev`      | OAuth 2.1 | Inspect and manage Akua workspace resources |

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:

```text theme={null}
Summarize my Akua workspace and recommend the next three setup steps.
```

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:

<Steps>
  <Step title="Add documentation context" icon="book">
    Add `akua-docs` with URL `https://docs.akua.dev/mcp`. This server searches Akua docs and does not require authentication.
  </Step>

  <Step title="Add platform context" icon="server">
    Add `akua` with URL `https://mcp.akua.dev`. This server connects the agent to authenticated workspace context.
  </Step>

  <Step title="Authorize platform access" icon="key">
    Sign in through the OAuth flow for the `akua` server when your tool prompts you.
  </Step>

  <Step title="Confirm account and workspace" icon="building">
    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.
  </Step>
</Steps>

For more detail about the two MCP servers, see [Documentation MCP](/ai/docs-mcp) and [Platform MCP](/ai/platform-mcp).

## Related topics

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Start with an account, workspace, agent setup, and workspace briefing.
  </Card>

  <Card title="Documentation MCP" icon="book" href="/ai/docs-mcp">
    Search Akua docs from MCP-compatible AI tools.
  </Card>

  <Card title="Platform MCP" icon="server" href="/ai/platform-mcp">
    Connect an agent to authenticated Akua workspace operations.
  </Card>

  <Card title="Agent permissions" icon="shield" href="/agents/permissions-and-security">
    Review controls for hosted agents and workspace access.
  </Card>
</CardGroup>