Skip to content
CADground Documentation
Documentation menu

Connect Claude Code

Add CADground as a remote HTTP server, then sign in and allow access in the browser.

2 min readUpdated

Before you start

Install and sign in to Claude Code where you will use it. Check the CADground requirements. Copy the project’s MCP URL. Claude Code uses your own model-provider account and plan.

1. Add the HTTP server

In your terminal, replace the example URL with the copied project URL and run:

claude mcp add --transport http cadground "https://cadground.ai/api/mcp/projects/PROJECT_ID"

By default, this command adds the server for the current project. Start Claude Code in that same project. For other configuration locations, see the official MCP reference.

2. Sign in and allow access

  1. Start Claude Code.
  2. Enter /mcp.
  3. Select the CADground server and start its sign-in action.
  4. Sign in to CADground in the browser. Check the project, then choose the permissions.

Choose read-only for your first inspection. Choose read and write for camera or geometry changes. You can allow only the permissions that the client requested and your project role permits.

3. Check status and call a tool

claude mcp list
claude mcp get cadground

Saving a server entry does not confirm that the connection works. After sign-in, test it with this request:

Use the cadground MCP tools to identify the active source and list objects. Take a picture without changing the scene. Read any returned image resource. Report any tool errors. Do not change the scene.

Check that the result matches the source selected in the editor. If no source is loaded, open CADground and load the scan. Then retry this test.

Run one operation at a time

CADground can report that the project is busy while the built-in AI or another external tool is using the scene. Ask the agent to run scene tools one at a time and wait for each result. Do not use two agents to change the same geometry at once.

Start a fitting task with one small region. If it stops, check whether the client stopped waiting or the tool reported a failure. Inspect the scene before retrying: the tool may already have changed geometry.

Remove or reconnect

To remove project access, select Connected clients → Disconnect → Remove in CADground. To remove the saved server entry from Claude Code, use:

claude mcp remove cadground

If reconnection fails, see MCP troubleshooting. Check the supported redirect addresses and requested permissions.