Skip to content
ShapeAnywhere Wiki
AI & MCP

Connect cloud AI through MCP and OAuth

Set up a custom MCP connection, sign in with your ShapeAnywhere account and revoke access.

Updated:

Purpose

An AI client supporting custom MCP connections can use OAuth to access your connected ShapeAnywhere CAD. Sign in using your existing ShapeAnywhere account; no permanent MCP token needs to be shared with the client. Availability of custom connections and write actions depends on the client and your account.

Connect ChatGPT, Claude or another MCP client

  1. In your AI client (such as ChatGPT or Claude), open the settings for MCP servers or external connections. Add a new server. Availability and labels vary by provider and plan.
  2. Enter https://mcp.shapeanywhere.com/mcp. If your client supports it, choose OAuth and register automatically (DCR). In ChatGPT and Claude you may instead choose a published client identity (CIMD); this requires ShapeAnywhere to reach the respective public client metadata URL. ChatGPT requires ShapeAnywhere portal v749 or later. Neither OAuth option needs a permanent MCP token. Clients using Bearer tokens require the separate token guide.
  3. Sign in on the ShapeAnywhere page. Review the client name, return destination and requested permissions. Clients supply their own names; a name is not proof of identity. Only authorize a connection you started yourself.
  4. Allow or deny the connection. ShapeAnywhere does not share your password with the AI client.
  5. Open the intended CAD project, sign in with the same account and connect it under Tools → AI / MCP → Connections → Cloud AI through MCP (OAuth). Select exactly one project as the active MCP target.

Enable ShapeAnywhere in your AI client's chat. Tool selection varies between providers. CAD chat is a different route. Compare all four routes. Note: This guide applies to MCP-capable cloud clients in general. OAuth/DCR availability in Claude, ChatGPT or another provider depends on that client and account. Existing wiki links keep their previous address.

Start with a read-only test

Example: “Check the ShapeAnywhere connection, list the bodies and describe a current model image. Change nothing.” An empty project has no model image yet. Edits require both OAuth write permission and your approval in CAD or deliberately enabled automation there. OAuth does not enable automation.

Permissions and revocation

Tools tell the AI client whether they only read, add new content, or can change or delete existing data. These hints do not replace authorization or CAD approval. For example, a current model image only reads, while a chamfer changes an existing body. The privacy policy explains data sent to the selected AI service; the terms of use apply to use of the service. cad:read permits status, body data and model images. cad:write additionally permits the existing editing tools, including moving and deleting, while retaining CAD approval controls. Access tokens last 15 minutes and can be renewed under an authorization for up to 30 days. Reconnect afterward. Under Account → AI / MCP connections, OAuth authorizations appear separately from permanent MCP tokens and can be revoked immediately. The next request using that authorization is rejected, even if its access token has not expired. An already running CAD operation may still finish.

Troubleshooting

For “Access denied”, select OAuth rather than “No authentication” first. If sign-in is invalid or expired, start the connection again in your client. If write permission is missing, reconnect with the necessary permissions; a read token cannot edit CAD. If several CAD windows are active, leave only the intended MCP target enabled. If registration fails, check public OAuth metadata reachability and start with register automatically (DCR) in Claude. Published identity (CIMD) requires ShapeAnywhere to fetch ChatGPT or Claude client metadata over HTTPS; if that fetch is blocked, use DCR. ChatGPT CIMD requires the portal fix in v749 or later. Re-add the connector after server-side callback changes. Never paste a permanent MCP token into an OAuth client ID or secret field. Example: after Allow connection, the AI client still waits for sign-in. The return page should take you back automatically; if it remains open, use Continue to AI client. If “invalid or expired” appears instead, do not reuse the old consent form. Have ShapeAnywhere updated, cancel the waiting connection attempt in the client and start a new one. An authorization entry already visible in your account does not by itself confirm a completed connection. If the account is linked but Refresh tools fails with “server/discover response was invalid”, the tool discovery response was rejected. Have ShapeAnywhere updated, then choose Refresh tools again in the existing connection's management page. Open a new chat, select ShapeAnywhere and start with the read-only example above. Do not disable authentication or delete the app as a precaution. Tool discovery and the CAD connection are separate steps: body lists and model images still require the intended project to be connected. Do not bypass an unsupported return destination by disabling authentication. Use the destination shown by the client and have its support checked. Successful sign-in guarantees neither every client feature nor a correct CAD result. See the MCP tool reference and construction checks.