# Connect BuildCAD AI to your AI assistant (MCP)

BuildCAD AI is a free, hosted CAD MCP server. URL: https://buildcad.ai/api/mcp

No install and no API key: when you connect, a BuildCAD window opens; sign in (or create a free account) and click Allow. The server registers each app automatically (OAuth with dynamic client registration and client metadata documents), so leave any Client ID / Client Secret fields empty.

Tools: get_cad_guide, list_designs, get_design, run_model (build123d CAD with measurements, print checks and renders), save_design (opens in BuildCAD with sliders and STL, 3MF and STEP downloads).

## Claude (claude.ai, desktop and mobile apps)

Requirements: Any plan. Free plans can add one custom connector. On Team and Enterprise, an Owner adds it once in Organization settings, then you click Connect.

One click: https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=BuildCAD%20AI&connectorUrl=https%3A%2F%2Fbuildcad.ai%2Fapi%2Fmcp

1. Click **Add to Claude** above, or open **Customize > Connectors** in Claude, click **+ Add**, then **Add custom connector**.
2. Name: `BuildCAD AI`. URL: `https://buildcad.ai/api/mcp`. Leave the other settings as they are and click **Add**.
3. Click **Connect**. A BuildCAD window opens: sign in (or create a free account) and click **Allow**.
4. In a chat, click **+ > Connectors** and check that **BuildCAD AI** is on.

Check: Ask Claude: "Use BuildCAD AI to list my designs." You get your designs, or a note that you have none yet.

- **Add custom connector is greyed out:** on the Free plan you already have one custom connector. Remove it, or upgrade.
- **Claude answers without using BuildCAD:** turn it on under **+ > Connectors** for that chat, and say "Use BuildCAD AI" in your message.
- **Team or Enterprise:** ask a workspace Owner to add the connector first.

## ChatGPT (chatgpt.com)

Requirements: A plan with developer mode or custom apps. In Business and Enterprise workspaces an admin may need to allow custom MCP servers.

1. Open [chatgpt.com/plugins](https://chatgpt.com/plugins), click **+**, then **Add custom MCP server**. If you don't see it, turn on **Developer mode** in **Settings > Security and login**.
2. Name: `BuildCAD AI`. Description: `Design 3D-printable parts`. Connection: public endpoint `https://buildcad.ai/api/mcp`. Authentication: **OAuth**.
3. Confirm with **I understand and want to continue**, then create it and install it.
4. A BuildCAD window opens: sign in (or create a free account) and click **Allow**.
5. In a new chat, type **@** and pick **BuildCAD AI**.

Check: Ask ChatGPT: "@BuildCAD AI list my designs." You get your designs, or a note that you have none yet.

- **No + or custom server option:** turn on developer mode, or ask your workspace admin to allow custom apps.
- **ChatGPT doesn't use BuildCAD:** start the message with **@BuildCAD AI**.

## Gemini (gemini.google.com)

Requirements: A personal Google account where Google offers custom connected apps (it is still rolling out: if you don't see **+ Custom**, your account doesn't have it yet). No client ID or secret needed.

1. On a computer, open [Customize > Connectors](https://gemini.google.com/customize/connectors) in Gemini.
2. Click **+ Custom**. In **Connect to an MCP server**, paste `https://buildcad.ai/api/mcp`.
3. Leave **Additional settings** closed. You don't need a client ID or secret: Gemini registers itself with BuildCAD. Click **Next**.
4. A BuildCAD window opens: sign in (or create a free account) and click **Allow**. You land back in Gemini.
5. In a chat, type **@** and pick **BuildCAD AI**.

Check: Ask Gemini: "@BuildCAD AI list my designs." You get your designs, or a note that you have none yet.

- **No + Custom button:** Google hasn't opened custom apps for your account yet (work and school accounts, and some countries, don't have it). Use Claude or ChatGPT meanwhile: same account, same designs.
- **Gemini asks for a Client ID and Secret:** leave them empty. Those fields are only for servers that can't register Gemini automatically.
- **It doesn't connect after you click Allow:** try a browser window signed in only to the Google account you use in Gemini, then add the app again.

## Grok (grok.com)

Requirements: A grok.com account with connectors.

1. Open [grok.com/connectors](https://grok.com/connectors) and click **New Connector**, then **Custom**.
2. Paste `https://buildcad.ai/api/mcp` and click **Connect**. Allow pop-ups from grok.com if your browser asks.
3. A BuildCAD window opens: sign in (or create a free account) and click **Allow**.

Check: Ask Grok: "Use BuildCAD AI to list my designs."

- **Nothing opens when you click Connect:** your browser blocked the pop-up. Allow pop-ups for grok.com and try again.

## Perplexity (perplexity.ai (web))

Requirements: A paid Perplexity plan. Web only.

1. In Perplexity, open **Settings > Connectors** and add a custom connector.
2. Paste `https://buildcad.ai/api/mcp` and choose **OAuth**.
3. A BuildCAD window opens: sign in (or create a free account) and click **Allow**.

Check: Ask Perplexity: "Use BuildCAD AI to list my designs."

- **The connector option is missing:** custom connectors need a paid plan and the web app.

## Claude Code (terminal, IDE extensions)

Requirements: Any Claude Code install.

Terminal:

```
claude mcp add --transport http --scope user buildcad-ai https://buildcad.ai/api/mcp
```

1. Run the command above.
2. In Claude Code, type `/mcp`, pick **buildcad-ai**, then **Authenticate**. Sign in to BuildCAD and click **Allow**.

Check: Run `claude mcp list`: you should see `buildcad-ai` marked **Connected**. Then ask: "Use BuildCAD AI to list my designs."

- **Already added on claude.ai?** Claude Code shows your claude.ai connectors in `/mcp` when you're logged in with the same account. No need to add it twice.
- **Needs authentication:** run `/mcp`, pick buildcad-ai and Authenticate again.

## Cursor (Cursor editor)

Requirements: Any Cursor plan.

One click: cursor://anysphere.cursor-deeplink/mcp/install?name=buildcad-ai&config=eyJ1cmwiOiJodHRwczovL2J1aWxkY2FkLmFpL2FwaS9tY3AifQ%3D%3D

~/.cursor/mcp.json:

```
{
  "mcpServers": {
    "buildcad-ai": {
      "url": "https://buildcad.ai/api/mcp"
    }
  }
}
```

1. Click **Add to Cursor**, or paste the config above into `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (one project).
2. In **Settings > Tools & MCP**, click **Needs login** next to buildcad-ai. Sign in to BuildCAD and click **Allow**.

Check: The server shows a green dot and 5 tools in **Settings > Tools & MCP**. Ask the agent: "Use BuildCAD AI to list my designs."

- **Red dot or no tools:** toggle the server off and on, then click **Needs login** again.

## VS Code (GitHub Copilot agent mode)

Requirements: VS Code with GitHub Copilot. Your organization's Copilot policy can turn MCP servers off.

One click: vscode:mcp/install?%7B%22name%22%3A%22buildcad-ai%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fbuildcad.ai%2Fapi%2Fmcp%22%7D

.vscode/mcp.json:

```
{
  "servers": {
    "buildcad-ai": {
      "type": "http",
      "url": "https://buildcad.ai/api/mcp"
    }
  }
}
```

1. Click **Add to VS Code**, or create `.vscode/mcp.json` with the config above. In VS Code the key is `servers`, not `mcpServers`.
2. Open the Command Palette, run **MCP: List Servers**, pick buildcad-ai, then **Start Server**. Allow the sign-in, then sign in to BuildCAD and click **Allow**.

Check: In Copilot Chat (agent mode), open **Configure Tools**: BuildCAD's 5 tools are listed. Ask: "Use BuildCAD AI to list my designs."

- **The server isn't listed:** check the file uses `servers` and `"type": "http"`, then reload the window.

## Codex (Codex CLI, IDE extension, ChatGPT desktop app)

Requirements: Any Codex install. The CLI, the IDE extension and the ChatGPT desktop app share this config.

Terminal:

```
codex mcp add buildcad-ai --url https://buildcad.ai/api/mcp
codex mcp login buildcad-ai
```

~/.codex/config.toml (alternative):

```
[mcp_servers.buildcad-ai]
url = "https://buildcad.ai/api/mcp"
```

1. Run the two commands above. The second opens a BuildCAD window: sign in and click **Allow**.

Check: Run `codex mcp list`, or `/mcp` inside Codex: buildcad-ai is listed. Then ask: "Use BuildCAD AI to list my designs."

- **Not logged in:** run `codex mcp login buildcad-ai` again.

## Antigravity (Antigravity CLI and IDE, Gemini CLI)

Requirements: Antigravity (which replaced Gemini CLI for personal accounts), or Gemini CLI on a work or API-key account.

~/.gemini/config/mcp_config.json (Antigravity):

```
{
  "mcpServers": {
    "buildcad-ai": {
      "serverUrl": "https://buildcad.ai/api/mcp"
    }
  }
}
```

Gemini CLI:

```
gemini mcp add -s user --transport http buildcad-ai https://buildcad.ai/api/mcp
```

1. Antigravity: add the config above. It uses `serverUrl`, not `url`.
2. Sign in: in the CLI, type `/mcp` to open the MCP manager. In the IDE, open **Agent settings > Customizations** and click **Authenticate**.
3. Gemini CLI: run the command above, then `/mcp auth buildcad-ai`.

Check: `/mcp` shows buildcad-ai connected. Ask: "Use BuildCAD AI to list my designs."

- **Config ignored:** Antigravity reads `serverUrl`; Gemini CLI's `httpUrl` won't work there.

## Windsurf (Windsurf (Devin Desktop), Cascade)

Requirements: Any Windsurf install.

mcp_config.json:

```
{
  "mcpServers": {
    "buildcad-ai": {
      "serverUrl": "https://buildcad.ai/api/mcp"
    }
  }
}
```

1. In the Cascade panel, click **...** then **MCPs**, then **Open MCP config file**, and add the config above (`serverUrl`, not `url`).
2. Save. Windsurf asks you to sign in: sign in to BuildCAD and click **Allow**.

Check: The MCPs list shows buildcad-ai with 5 tools. Ask Cascade: "Use BuildCAD AI to list my designs."

- **No tools:** refresh the MCPs list after saving the file.

## Other (opencode, pi, Zed, Goose, Kiro, any MCP client)

Requirements: Any client that supports remote MCP servers with OAuth.

Set up every agent on this computer:

```
npx add-mcp https://buildcad.ai/api/mcp -g
```

Or add it by hand:

```
URL:       https://buildcad.ai/api/mcp
Transport: Streamable HTTP
Auth:      OAuth (sign-in window, no API key or headers)
```

1. `npx add-mcp` finds the agents installed on your computer and writes each one's config in its own format.
2. Or point your client at the URL. It registers itself with BuildCAD automatically (dynamic client registration and client metadata documents are both supported), then opens a sign-in window.

Check: Ask your agent: "Use BuildCAD AI to list my designs."

- **Your client asks for an API key:** BuildCAD has none. Choose OAuth, or a client that supports it.

## Example prompts

- Use BuildCAD AI to list my designs.
- Use BuildCAD AI to design a 30 mm cube with a 10 mm hole through it, check it, and save it.
- Use BuildCAD AI to design a wall hook for a 20 mm towel rail that prints without supports, then save it.
- Make a Gridfinity 2x1 bin, 6 units tall, with a label lip, and save it to BuildCAD.
- Open my latest BuildCAD design and make the walls 2.4 mm thick.
- Add M3 screw holes in each corner of my bracket design, 4 mm from the edges.

## Troubleshooting

- There's no "custom connector", "+ Custom" or "custom MCP server" option: Your plan or account doesn't offer custom apps (Claude Free already has one; Gemini is still rolling out; ChatGPT needs developer mode). Fix: Check the requirements in your app's tab, ask your workspace admin, or use another app
- The sign-in window doesn't open, or closes without connecting: A blocked pop-up, or the browser is signed in to another account. Fix: Allow pop-ups for your AI app, use a window signed in to one account, and try again
- Gemini asks for a Client ID and Client Secret: Those fields are optional. Fix: Leave them empty: Gemini registers itself with BuildCAD
- Connected, but the AI doesn't use BuildCAD: The connector is off for this chat. Fix: Claude: **+ > Connectors**. ChatGPT and Gemini: type **@BuildCAD AI**. Or start with "Use BuildCAD AI"
- "Needs authentication" (Claude Code, Cursor, Codex, VS Code): Sign-in not done yet, or expired. Fix: Claude Code: `/mcp` then Authenticate. Codex: `codex mcp login buildcad-ai`. Cursor: **Needs login**. VS Code: **MCP: List Servers > Start Server**
- You see no designs, or someone else's: Signed in to another BuildCAD account. Fix: Remove BuildCAD AI from the app, add it again and sign in with the right account
- It worked before October 2026 and stopped: Connections from the old version expired. Fix: Remove BuildCAD AI from the app and add it again
- You edited a config file but the server isn't listed: Each app has its own format. Fix: Copy the config from your app's tab (VS Code: `servers`; Windsurf and Antigravity: `serverUrl`) and restart the app

Still stuck? Email hello@buildcad.ai with your app, plan, country and the error text.
