MCP docs: Connect your AI app

CommunityCAD MCP

Connect your AI app

One command sets it up in every AI app on your computer. Works with Claude, OpenCode, Cursor, Codex, VS Code and other MCP apps, or add it by hand.

The MCP server runs on your computer. Your AI app starts it when it needs it; there's nothing to keep running yourself. Windows, macOS and Linux all work. To see what it does first, watch the demo in SolidCraft.

Set it up with your AI agent#

Paste this into your AI agent and it does the setup for you, explaining each step:

Set up the CommunityCAD MCP server for me by following https://communitycad.dev/mcp/setup.md. Explain each step before you run it.

This works in agents that can run commands on your computer, such as Claude Code, OpenCode, Codex and Cursor's agent. In a chat-only app, use the one command instead. The agent follows these instructions.

Install with one command#

Copy the command for your system and run it: on Windows in PowerShell (search the Start menu for "PowerShell"), on macOS and Linux in Terminal.

curl -LsSf https://communitycad.dev/mcp/install.sh | sh

It does two things:

  1. Installs uv if you don't have it. uv is a small tool that downloads and runs Python programs, so you don't need to install Python yourself. It goes in your user folder: no admin rights or sudo.
  2. Adds CommunityCAD to your AI apps. It finds the AI apps on your computer and adds the server to each: OpenCode, Claude Desktop, Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot, Windsurf, Zed and VS Code. It backs up each settings file before changing it and leaves your other MCP servers alone.

Then restart your AI app, or start a new session, and check it works.

Want to read the script first? Here it is: install.sh for macOS and Linux, install.ps1 for Windows.

Already have uv? Run this instead; it does step 2:

uvx communitycad-mcp install

Check it works#

Ask your AI app: "What's my CommunityCAD account status?" It should answer that you're signed out and show the signed-out download limit. Then you can link your account, or just start searching.

If it doesn't know what you mean, see Something's wrong.

Claude Code plugin#

In Claude Code you can also install CommunityCAD as a plugin. Run these two commands in a Claude Code session:

/plugin marketplace add CommunityCad-dev/communitycad-mcp
/plugin install communitycad@communitycad

The plugin adds the server and a short guide that helps Claude find parts. It still needs uv: if you don't have it, run the one command first.

Claude Desktop extension#

Claude Desktop can install CommunityCAD as an extension, with no settings file to edit:

  1. Download communitycad.mcpb from the latest release.
  2. Double-click it, or drag it into Settings → Extensions in Claude Desktop.
  3. Choose Install.

Add it by hand#

Every app below runs the same command: uvx with the argument communitycad-mcp. It needs uv: run the one command, or install uv from docs.astral.sh/uv.

Claude Code#

In a terminal, run:

claude mcp add --scope user communitycad -- uvx communitycad-mcp

--scope user makes it available in all your projects. Then start a new Claude Code session; /mcp lists the CommunityCAD tools.

Claude Desktop#

  1. Open Settings → Developer → Edit Config.

  2. Add communitycad under mcpServers:

    {
      "mcpServers": {
        "communitycad": {
          "command": "uvx",
          "args": ["communitycad-mcp"]
        }
      }
    }

    If the file already lists other servers, add communitycad next to them instead of replacing them.

  3. Quit and restart Claude Desktop.

Cursor#

Open Cursor Settings → MCP → Add new global MCP server. That opens ~/.cursor/mcp.json; add communitycad under mcpServers:

{
  "mcpServers": {
    "communitycad": {
      "command": "uvx",
      "args": ["communitycad-mcp"]
    }
  }
}

Save the file. The server shows in Cursor's MCP settings; use it from Cursor's Agent chat.

VS Code#

In VS Code, MCP servers work in GitHub Copilot's Agent mode. Run this in a terminal:

code --add-mcp '{"name":"communitycad","command":"uvx","args":["communitycad-mcp"]}'

That's for macOS and Linux. On Windows, or if you prefer, open the Command Palette, run MCP: Open User Configuration, and add:

{
  "servers": {
    "communitycad": {
      "type": "stdio",
      "command": "uvx",
      "args": ["communitycad-mcp"]
    }
  }
}

Windsurf#

Open Windsurf Settings → Cascade → MCP Servers → Manage MCP servers → View raw config. That opens ~/.codeium/windsurf/mcp_config.json; add:

{
  "mcpServers": {
    "communitycad": {
      "command": "uvx",
      "args": ["communitycad-mcp"]
    }
  }
}

Save, then press Refresh in the MCP servers panel.

OpenCode#

Add communitycad under mcp in your OpenCode config, opencode.json (in your project, or ~/.config/opencode/opencode.json for all projects):

{
  "mcp": {
    "communitycad": {
      "type": "local",
      "command": ["uvx", "communitycad-mcp"],
      "enabled": true
    }
  }
}

Then start a new OpenCode session.

Codex#

Add this to ~/.codex/config.toml:

[mcp_servers.communitycad]
command = "uvx"
args = ["communitycad-mcp"]

Then start a new Codex session.

Other apps#

In any app that can run a local MCP server (also called a stdio server), add a server that runs the command uvx with the argument communitycad-mcp. The app's own docs say where.

Use it inside SolidCraft#

SolidCraft's AI chat runs a coding agent you already have (Codex, OpenCode, Gemini CLI or Claude Code) and gives it SolidCraft's own tools. Codex, OpenCode and Gemini CLI also load the MCP servers you've set up for them, so CommunityCAD comes along (Claude Code should too; if it doesn't show up there, use one of the others):

  1. Set up the agent you use in SolidCraft's chat, if you haven't yet.
  2. Add CommunityCAD to that agent: run the one command above, or just for that agent, for example uvx communitycad-mcp install --app codex (also opencode, gemini or claude-code).
  3. Start a new chat in SolidCraft.
  4. Ask: "Find me an M8 socket head screw with a STEP file and put it in my design."

SolidCraft's chat can't show pictures yet, so show_images gives you links to the pictures instead.

Something's wrong#

Run the built-in check:

uvx communitycad-mcp doctor

It checks that uv works, that CommunityCAD can be reached, whether you're signed in, and which AI apps have CommunityCAD set up. It tells you what to fix. See also Troubleshooting.

Updating#

Run the one command again: it always gets the newest version (communitycad-mcp@latest). To be sure your AI app uses it:

  1. Close every session that uses it: quit the AI app, or end the session.
  2. Run uv cache clean communitycad-mcp.
  3. Start a new session. uvx downloads the newest version.

Your sign-in and settings are kept.

On Windows, close the session first. While the server is running, Windows keeps its program file locked, so an update can't replace it. If an update fails with a "file in use" or "access denied" error, quit the AI app and try again.

Settings#

You don't need to change anything. If you want to, these are environment variables your AI app passes to the server (in a JSON config, add them under "env" next to "args"):

  • COMMUNITYCAD_DOWNLOAD_DIR: where downloads are saved; each model gets its own folder inside. Default: ~/CommunityCAD.
  • COMMUNITYCAD_MAX_DOWNLOAD_MB: larger files are refused before anything is downloaded or counted. Default: 500.
  • COMMUNITYCAD_CONFIG_DIR: where your sign-in is kept. Default: your user config folder.

For example, in Claude Code:

claude mcp add --scope user communitycad -e COMMUNITYCAD_DOWNLOAD_DIR=~/Parts -- uvx communitycad-mcp

Uninstalling#

  1. Unlink your account first, so the sign-in stops working.

  2. Remove the server from your AI apps:

    uvx communitycad-mcp uninstall

    It removes CommunityCAD from every app it set up, and leaves your other servers alone. If you added it by hand, you can also remove it by hand: in Claude Code, claude mcp remove --scope user communitycad; in the other apps, delete the communitycad entry from the config and restart. The Claude Code plugin and the Claude Desktop extension are removed from the app's plugin or extension list.

Files you downloaded stay in your downloads folder. uv stays installed; it's used by other tools too, and uv's docs say how to remove it.

A hosted version#

A hosted version, with nothing to install, is planned. You'll add it to your AI app by its address, and it will work in web and phone AI apps too. It isn't available yet.