Troubleshooting

Authentication failed

Symptoms: Authentication errors, "Unauthorized" responses, unable to load organization context

Solutions:

1. Log in to the CloudZero platform directly to verify your account access.
2. Clear cookies for cloudzero.com in your default browser and try again.
3. Restart Claude Code to trigger fresh authentication.

Plugin not found

Symptoms: "Plugin not found" when trying to install

Solutions:

1. Add the marketplace first:

   Bash

   claude plugin marketplace add cloudzero/cloudzero-claude-marketplace

2. Install the plugin:

   Bash

   claude plugin install cost-analyst@cloudzero

No data returned

Symptoms: "No cost data found" or empty results

Solutions:

1. Try a different time range; verify data exists for the period in the CloudZero platform.
2. Broaden your filters; remove specific service or account filters.
3. Recent cost data may take 24-48 hours to appear.

Response too large

Symptoms: A tool returns "produced a response of X.X MB, which exceeds the 5 MB limit"

Solutions:

1. Narrow the date range (for example, last 7 days instead of last 90 days).
2. Add filters to scope the query to specific accounts, services, or teams.
3. Lower the limit parameter to return fewer rows.
4. Change group_by to a less granular dimension.

This is expected behavior for queries that would otherwise exceed the MCP server's response size cap. AI agents that surface this error can typically retry on their own with a narrower query. See Response size limit for the underlying cap and per-tool limit maximums.

Get help

For issues not resolved by this guide:

• FinOps Account Manager: Contact your FinOps Account Manager for account-specific issues
• CloudZero Support: Email [email protected]
• GitHub Issues: File plugin bugs at cloudzero/cloudzero-claude-marketplace