Troubleshooting

Fix the common Cizgen MCP issues — connection to AutoCAD, subscription and API key errors, and version messages.

Cizgen MCP's error messages are written to tell you what to do, so the fastest path is usually to read the message in the chat. This page collects the common ones.

"Could not reach AutoCAD"

The MCP server couldn't connect to the plugin. Check, in order:

Is AutoCAD running with a drawing open? The connection only exists while AutoCAD is up.
Is the Cizgen plugin installed and current? Version 1.0.10 or newer is required — get it from the Download page, then restart AutoCAD.
Is the listener running? Type CIZGENMCP at the AutoCAD command line — it reports the connection status and lets you restart the listener.
Same Windows account? The local connection is private to the Windows user that started AutoCAD; your AI app must run as the same user.

Tool calls answer with a renewal message when your subscription has lapsed. Renew (or update your card) via Manage billing on the MCP dashboard — after renewing, simply ask the AI to try again. Cizgen re-checks automatically; you do not need to restart your AI app.

If you subscribed moments ago and still see this, wait a few seconds and retry — the payment confirmation arrives via webhook.

"API key rejected"

The key in your host configuration is invalid or was revoked. Generate a new key on the MCP dashboard and update your host:

Claude Desktop — Settings → Extensions → Cizgen, paste the new key.
Claude Code — re-run the claude mcp add cizgen … command with the new key.
Cursor / VS Code — edit the CIZGEN_MCP_API_KEY value in mcp.json.

Keys are shown only once at creation, so a lost key means a new key.

"Update required" / "Update available"

"Please install the latest version" on every tool call means your installed server is below the minimum supported version (this floor moves only for security or breaking changes). Claude Desktop users: download the latest cizgen-mcp.mcpb and double-click it to update in place. npx users normally receive the latest release automatically on the next host restart.
A one-time "update available" note on a successful result is informational — everything keeps working; update when convenient.

Offline use

Your subscription is verified against cizgen.app once a day, and a signed confirmation is cached so short offline stretches don't interrupt you — up to 72 hours without a connection. Past that, tool calls ask you to get back online once so the subscription can be re-verified.

Still stuck?

The panel's own Troubleshooting page covers AutoCAD-side issues (plugin not loading, trusted paths, WebView2). For anything else, reach out at cihadp@gmail.com.