# Set up the CommunityCAD MCP server You are an AI agent helping a user connect their AI app to CommunityCAD (https://communitycad.dev), a library of real CAD parts with datasheets. Follow these steps in order. ## Goal Install the CommunityCAD MCP server and add it to the user's AI app, so the app can search CommunityCAD, read datasheets and download parts. ## Rules - Explain each command in one sentence before you run it. - Ask the user before changing any config file. - Never print, paste or log tokens, passwords or the contents of the CommunityCAD config folder. - Never edit, remove or reorder other MCP servers' entries. - If a step fails, show the user the exact error and point them to https://communitycad.dev/docs/mcp/troubleshooting. Don't guess at fixes that change their system. ## Steps 1. **Detect the OS**: Windows, macOS or Linux. 2. **Check for uv.** Run `uvx --version`. - If it prints a version, go to step 3. - If it isn't found, tell the user you'll install uv (a small tool that runs Python apps, installed in their user folder, no admin rights or sudo), then run the official installer for their OS only: - macOS or Linux: `curl -LsSf https://astral.sh/uv/install.sh | sh` - Windows (PowerShell): `powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"` - The new `uvx` may not be on PATH in this shell yet. Try `~/.local/bin/uvx` (macOS, Linux) or `%USERPROFILE%\.local\bin\uvx.exe` (Windows), or ask the user to open a new terminal. 3. **Add CommunityCAD to the AI app.** - If you know which app you're running in, run `uvx communitycad-mcp install --app ` with one of these names: `opencode`, `claude-desktop`, `claude-code`, `cursor`, `codex`, `gemini`, `copilot`, `windsurf`, `zed`, `vscode` - Otherwise run `uvx communitycad-mcp install`. It finds the AI apps on this computer and sets up each one. - It backs up each config file before changing it and leaves other servers alone. 4. **Check it.** Run `uvx communitycad-mcp doctor` and tell the user what it reports, in plain words. 5. **Tell the user to restart the app**, so it loads the new server: - Claude Code: start a new session. - Claude Desktop: quit it fully and reopen it. - Other apps: restart or reload the window, or start a new chat. 6. **After the restart**, the CommunityCAD tools are available. Offer to link the user's CommunityCAD account with the `link_account` tool. Linking is optional: searching, reading and downloading work without an account, within the signed-out limit. Docs: https://communitycad.dev/docs/mcp/installing