Skip to content
CADground Documentation
Documentation menu

Connect Cursor

Add the remote server URL. Check that your Cursor version can complete sign-in with CADground.

2 min readUpdated

Check OAuth compatibility first

Check the CADground requirements. Cursor supports remote MCP and OAuth. CADground must also accept the callback address that your Cursor client uses after sign-in.

Cursor also documents an HTTPS web callback. The callback used can depend on how the client registers. Check Cursor’s current MCP and OAuth reference for your client.

1. Add the server URL

For one project, add the server to .cursor/mcp.json. For your user account, use ~/.cursor/mcp.json. Keep any existing server entries. Replace the example URL with the URL copied from CADground:

{
  "mcpServers": {
    "cadground": {
      "url": "https://cadground.ai/api/mcp/projects/PROJECT_ID"
    }
  }
}

In Cursor’s Customize area, open the MCP server controls. Check the connection and start sign-in when offered. CADground uses OAuth. You do not need a custom API-key header.

2. Allow access in CADground

When CADground opens, check the project and account. Choose read-only or read and write for your task. You can allow write access only if the client requested it and your role permits it.

If you see an invalid redirect error, stop setup. Use a compatible client or send support the exact error, callback scheme, and host. Do not change the callback in a generated sign-in URL by hand. It must match the callback the client registered.

3. Verify the tools

Use the cadground MCP server to read the current scene source. List the objects and take a picture. Read any returned MCP image resource. Do not change camera positions or geometry.

Check that the output matches the correct project. A picture’s address alone does not let the agent inspect the image. If Cursor cannot read it, ask it to use MCP resource reading. You can also try a client that supports the returned content.

Continue or choose another client

After the read test works, try one clearly defined measurement. Check write access before asking for camera movement or geometry changes. If Cursor cannot use a supported callback, try the Codex or Claude Code setup guide. You must still complete sign-in and test a tool with the chosen client.