AI & Agents - Akua

Akua is built for agentic operations. You can use the embedded dashboard agent for guided deployment and operations work, or connect your own AI tool through the Model Context Protocol (MCP). Both paths use the same platform API, workspace controls, and operational context.

What you can do

Hosted agents

Use the embedded dashboard agent or configure workspace agents that investigate, propose, and automate operations inside Akua.

Documentation MCP

Search and query Akua docs in real-time. No authentication required. Works out of the box with any MCP client.

Platform MCP

Manage clusters, products, and deployments via the Akua API from external AI tools. Uses OAuth 2.1 and sandboxed Code Mode.

Installation repositories

How agents read, prepare, and review changes to Akua installations through their git repositories.

Kubernetes access

Give agents direct access to cluster resources through the Kubernetes API proxy and command execution.

Dashboard generation

Use AI agents to generate and iterate on custom dashboards and snippets conversationally.

Code Mode in action

See real examples of agents composing complex multi-step operations in a single tool call.

Examples

Concrete examples: log analysis, security audits, cross-cluster comparison, incident debugging, and more.

Quick setup

Connect your AI tool in under a minute when you want Claude Code, Cursor, or another MCP-compatible client to work with Akua.

Claude Code
Cursor
VS Code
Claude Desktop
Other

claude mcp add --transport http cnap-docs https://docs.akua.dev/mcp
claude mcp add --transport http cnap https://akua.dev/mcp

Verify:

claude mcp list

Press Cmd+Shift+P → “Open MCP settings” → Add:

mcp.json

{
  "mcpServers": {
    "cnap-docs": {
      "url": "https://docs.akua.dev/mcp"
    },
    "cnap": {
      "url": "https://akua.dev/mcp"
    }
  }
}

Create .vscode/mcp.json:

.vscode/mcp.json

{
  "servers": {
    "cnap-docs": {
      "type": "http",
      "url": "https://docs.akua.dev/mcp"
    },
    "cnap": {
      "type": "http",
      "url": "https://akua.dev/mcp"
    }
  }
}

Config file location:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "cnap-docs": {
      "command": "npx",
      "args": ["mcp-remote", "https://docs.akua.dev/mcp"]
    },
    "cnap": {
      "command": "npx",
      "args": ["mcp-remote", "https://akua.dev/mcp"]
    }
  }
}

On first connection to the platform server, your browser will open for OAuth authorization.

Add the MCP server URLs to your tool’s configuration:

{
  "mcpServers": {
    "cnap-docs": {
      "url": "https://docs.akua.dev/mcp"
    },
    "cnap": {
      "url": "https://akua.dev/mcp"
    }
  }
}

Configuration format may vary. Refer to your tool’s documentation.

Server	URL	Auth	Use case
`cnap-docs`	`https://docs.akua.dev/mcp`	None	Search and query docs
`cnap`	`https://akua.dev/mcp`	OAuth 2.1	Manage clusters, products, deployments

You can set up just one server if you only need docs search or only need API access.

Beyond MCP

Akua’s AI integration goes beyond MCP servers:

Contextual menu: every doc page offers copy-as-markdown, open-in-AI, and one-click editor setup
llms.txt: industry-standard files (llms.txt and llms-full.txt) for AI indexing
Markdown access: append .md to any doc URL for AI-friendly output (for example, docs.akua.dev/ai/index.md)

Hosted agents

The embedded dashboard agent and the full agent product model.

Platform MCP

How Code Mode gives agents full API access in a sandboxed V8 isolate.

Examples

See agents in action: log analysis, security audits, and more.

Agents API

Build on the public agent resources and SDK shape.

Documentation Index

​What you can do

Hosted agents

Documentation MCP

Platform MCP

Installation repositories

Kubernetes access

Dashboard generation

Code Mode in action

Examples

​Quick setup

​Beyond MCP

​Related topics

Hosted agents

Platform MCP

Examples

Agents API

What you can do

Quick setup

Beyond MCP

Related topics