Docs Troubleshooting
Troubleshooting
Most problems come from one of four places: the connector in your AI app, your sign-in, the agent on your computer, or the CAD program. Work down this page.
The connector will not add
- Check the URL is exactly https://mcp.cadmcp.ai/mcp with nothing before or after it.
- Claude Free allows one custom connector. Remove another custom connector, or use a paid Claude plan.
- On Claude Team or Enterprise, an owner may need to add CADMCP.AI for the organisation first.
Sign-in fails or keeps coming back
- Sign in with your CADMCP.AI account, not your Claude or OpenAI account.
- Check that your plan is active on your account page.
- Forgot your password? Reset it.
- Remove the connector from your AI app, add it again and sign in once more.
“No computer connected”
- Is the computer on and awake, and is the agent running in the tray?
- Does the agent say it is connected? If not, check your internet connection and any company proxy or firewall that blocks outgoing connections.
- Is Pause AI access switched on in the agent?
- If you paired more than one computer, is this one marked as active in Your CADMCP.AI?
The AI cannot see my model
- Open the CAD program and the document you want to work on.
- In SOLIDWORKS, check that our add-in is switched on under Tools, Add-ins.
- Planning questions work without a model open; reading and changes do not.
A change is waiting
That is expected: every change waits for a person. Look for the approval card in the CAD program (in SOLIDWORKS, our add-in’s task pane). Requests expire if nobody answers them; ask again if one has expired.
A change was refused
- The document changed on disk after the request was made, or a different document is now active. Ask again with the right document active.
- The request asked for something that is never allowed, such as saving over an existing file.
- Change requests are switched off on that computer.
Codex says a tool timed out
A slow read in a large model can take longer than Codex waits. Try a narrower question (one body, one feature), or ask again. Change requests are not affected: they wait on the approval card.
Still stuck?
Email info@cadmcp.ai with the time it happened, your AI app (Claude or Codex), your CAD program and the message you saw. Please never send passwords, card numbers or confidential CAD files.