Set Up AI Hub
Connect AI Hub to your CloudZero account and start asking questions about your costs. Choose the setup path that fits your AI tool:
| Path | Best for | What it does |
|---|---|---|
| Option A: Claude Code Plugin | Claude Code users | Installs the MCP server and guided analysis skills in one command |
| Option B: Other tools quick install | Cursor, VS Code, Codex, and other supported tools | Adds the MCP server with a single npx command |
| Option C: Manual configuration | MCP-compatible AI tools | Configures the MCP server connection directly |
Option A: Connect with the CloudZero Plugin for Claude Code
The fastest way to get started. The Claude Code Plugin bundles the CloudZero MCP server with guided analysis skills in a single install.
What you need
- A CloudZero account
- Claude Code (v2.1 or above). If you do not have Claude Code installed, visit Anthropic's Claude Code installation guide, select your operating system and preferred install method, and follow the steps. Once
claudeis available in your terminal, return here to continue. - (Recommended) A dedicated folder for your cost analysis work (for example,
cloudzero-cost-analysis). Navigate to this folder in your terminal before startingclaude.
The CloudZero Plugin is supported through the Claude Code CLI. This is separate from claude.ai and Claude Desktop.
Install
-
Run the following commands to install the plugin:
claude plugin marketplace add cloudzero/cloudzero-claude-marketplace claude plugin install cost-analyst@cloudzero -
Start a Claude Code session by running
claudein your terminal. -
Run
/mcpand selectplugin:cost-analyst:cloudzerofrom the list. -
Follow the instructions to sign in to CloudZero.
-
After signing in to CloudZero, run the following command to teach Claude about your Dimensions, cloud configurations, and organization context. This improves the accuracy and relevance of every query.
/plugin:cost-analyst:cloudzero:init -
You are ready to start querying. Try one of the examples below.
Connect
To start a new session:
- Navigate to your cost analysis folder and run
claudein your terminal. - Run
/mcpand selectplugin:cost-analyst:cloudzerofrom the list. - Sign in to CloudZero when prompted. If you already have an active session, authentication is automatic.
Option B: Quick install for other MCP-compatible AI tools
Install the CloudZero MCP server into any supported AI tool with a single command using npx add-mcp.
What you need
- A CloudZero account
- Node.js (v18 or later)
Install with npx
Run the install command for your AI tool:
| AI tool | Install command |
|---|---|
| Antigravity | npx add-mcp https://czca-server.discovery.cloudzero.com/mcp -g -a antigravity -y |
| Claude Code | npx add-mcp https://czca-server.discovery.cloudzero.com/mcp -g -a claude-code -y |
| Cline (VS Code) | npx add-mcp https://czca-server.discovery.cloudzero.com/mcp -g -a cline -y |
| Cline CLI | npx add-mcp https://czca-server.discovery.cloudzero.com/mcp -g -a cline-cli -y |
| Codex | npx add-mcp https://czca-server.discovery.cloudzero.com/mcp -g -a codex -y |
| Cursor | npx add-mcp https://czca-server.discovery.cloudzero.com/mcp -g -a cursor -y |
| Gemini CLI | npx add-mcp https://czca-server.discovery.cloudzero.com/mcp -g -a gemini-cli -y |
| GitHub Copilot CLI | npx add-mcp https://czca-server.discovery.cloudzero.com/mcp -g -a github-copilot-cli -y |
| Goose | npx add-mcp https://czca-server.discovery.cloudzero.com/mcp -g -a goose -y |
| MCPorter | npx add-mcp https://czca-server.discovery.cloudzero.com/mcp -g -a mcporter -y |
| OpenCode | npx add-mcp https://czca-server.discovery.cloudzero.com/mcp -g -a opencode -y |
| VS Code | npx add-mcp https://czca-server.discovery.cloudzero.com/mcp -g -a vscode -y |
| Zed | npx add-mcp https://czca-server.discovery.cloudzero.com/mcp -g -a zed -y |
These commands install the MCP server to the tool's global configuration. To install to a project-level configuration instead, remove the
-gflag. For the most updated list of supported tools and commands, see the npx add-mcp documentation.
Install for Kiro
Kiro uses its own install command. For details, see the CloudZero Kiro Power repository.
kiro /powers install cloudzeroConnect
Open your AI tool and invoke any CloudZero tool. On first use, a browser window opens to sign in to CloudZero. If you already have an active session, authentication is automatic.
Option C: Manually connect an AI tool via MCP
Use this path if your AI tool is not listed above or you want full control over your MCP configuration.
Install
Add the CloudZero MCP server to your AI tool's configuration using the following values:
| Setting | Value |
|---|---|
| Server name | cloudzero |
| URL | https://czca-server.discovery.cloudzero.com/mcp |
| Type | http |
| Authentication | OAuth (a browser window opens on first use). For API key authentication, see API Key Authentication. |
Most AI tools accept this as a JSON configuration block:
{
"mcpServers": {
"cloudzero": {
"type": "http",
"url": "https://czca-server.discovery.cloudzero.com/mcp"
}
}
}Refer to your AI tool's documentation for where to add MCP server configurations.
Connect
On first use with OAuth, a browser window opens to sign in to CloudZero. If you already have an active session, authentication is automatic.
What to expect
After setup, you can start querying your cost data immediately. AI Hub accesses your full CloudZero data model, including the custom business logic in your Dimensions, optimization recommendations, and data from every connected provider. The same spend intelligence your team has built in CloudZero is available through natural language.
Examples of prompts you can ask
- "We had a cost spike last Tuesday. Investigate what caused it and recommend actions"
- "Do a deep dive on our RDS costs and identify optimization opportunities"
- "Generate a cost breakdown by team for Q4 including service details"
- "Analyze our tag coverage and prioritize resources that need tagging"
- "Run an anomaly detection scan, then show me my top cost drivers and any trends"
For more prompts organized by role and use case, see the Prompt Catalog.
Have questions or feedback? Reach out to your account manager.
