Troubleshooting

The assistant doesn't list CostCrunch, or says it failed to start

• Check uv is installed: uvx --version in a terminal.
• Desktop apps may not see your terminal's PATH. Put the full path to uvx in "command" (find it with which uvx).
• Restart the assistant after changing its config.

"This API key is not valid or has been revoked" The key was revoked, mistyped, or its owner left the company. Create a new key in Settings → API and update the config.

"This API key belongs to a different organization" COSTCRUNCH_ORG is set to another company. Remove it; a key always uses its own company.

"API keys can only read data" Something tried to make a change. Keys are read-only; make changes in the CostCrunch app.

Test the connection outside the assistant

COSTCRUNCH_API_KEY=cc_live_... uvx --from costcrunch cost account whoami

This prints the key's name and company. If it works here but not in the assistant, the problem is the assistant's config.

Still stuck? Email [email protected] with the error message (never the key).