AI & Agents

Connect AI assistants to Akua through MCP servers, or use the embedded dashboard agent for guided deployment and operations

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

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

Cursor

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"
    }
  }
}

VS Code

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"
    }
  }
}

Claude Desktop

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.

Other

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)

Related topics

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.