Skip to content
CADground Documentation
Documentation menu

Connect ChatGPT

Add your project’s MCP server in ChatGPT. Allow access, then test it with a CADground scene tool.

2 min readUpdated

Before you start

Check the external MCP requirements. Copy the MCP server URL from your project details. Your ChatGPT account or workspace must also allow custom MCP servers. Your organization can restrict this, even if CADground is ready.

1. Add the custom server

  1. Open Plugins in ChatGPT.
  2. Select +, then Add custom MCP server.
  3. Enter a name you will recognize, such as “CADground — roof survey”.
  4. In Connection, enter the copied project URL as the Server URL.
  5. Select OAuth authentication.
  6. Review the displayed information and choose Create as a plugin.
  7. Install the plugin from your personal or workspace area. Follow the steps to connect it.

These labels follow OpenAI’s current custom MCP instructions. If you see different labels or cannot find the action, check those instructions and your workspace permissions.

When CADground opens in the browser, sign in with the account that has project access. Check the project and client names. Choose Read only for inspection and measurements. Choose Read and write for camera movement and supported edits.

The permission screen shows only the access your role allows and the client requested. If write access is missing, an API key will not fix it. See permission troubleshooting.

3. Use it in a conversation

Select or enable the installed CADground plugin in the conversation. Then ask it to use a tool:

Use my CADground connection to read the current scene state. Take a picture of the active source. Use the tool results to identify the project scene and visible objects. Do not move anything or change the geometry.

Check: the response should use results from CADground tools. Confirm that the source belongs to the correct project. If ChatGPT cannot see the tools, check that you enabled the plugin in this conversation and completed sign-in.

Working with scans and reports

The scan stays in the CADground project. You do not need to upload it again for each ChatGPT conversation. Tools can return pictures, measurements, scene descriptions, and resources that require the connection’s permission to read.

If ChatGPT receives a cadground:// address, it must read it through MCP. It is not a public web link. With write access, ask it to save reports in outputs/ using the MCP file tools. Uploading a generated PDF requires the client to read and send its bytes. Ask where the report was saved.

Remove the connection

To remove project access, open the CADground project details. Find the client under Connected clients. Select Disconnect → Remove. If you also want to remove the plugin from ChatGPT, do that separately in ChatGPT.