AI Connections (MCP)

An AI Connection lets an outside AI assistant — ChatGPT, Claude, Cursor, VS Code and other tools that speak the Model Context Protocol — work with your Simplio3D projects directly, instead of you copying answers back and forth. ChatGPT and Claude connect in one click with the Simplio3D plugin; other tools use a token you create, decide exactly what it is allowed to touch, and paste into the AI tool. It is the same idea as giving a contractor a key that only opens certain doors, with an expiry date on it.

Available on every plan — Starter, Pro and Enterprise — and during the 30-day trial. Manage everything at Dashboard → Integrations → AI Connections. A connected assistant follows your plan's rules: on Starter it cannot create Modular projects or duplicate projects, just as you can't in the dashboard. (The developer API & SDK token in Profile → API/SDK is a separate feature and still needs Pro or Enterprise.)

What a connected agent can and cannot do

It can

  • Read your projects — option blocks, variants, materials, pricing, conditional rules, form fields and quote requests.
  • Inspect a 3D model's part names so it can talk about the right meshes.
  • Make low-risk edits, such as renaming a block or adding a variant.
  • Propose risky changes — pricing, SKUs, deletions, a store product link — which then wait for you.
  • See whether a store is connected, list its products, and follow the progress of a workflow.

It cannot

  • Publish a project, create a share link or change embed settings.
  • Connect, disconnect or read the credentials of a Shopify or WooCommerce store.
  • Upload a file, or delete a project.
  • Apply its own risky change — every one of those needs your approval in the app.
  • Reach a workspace the connection was not created for, or anything outside the scopes you ticked.

The quickest way: the Simplio3D plugin for ChatGPT or Claude

Simplio3D publishes a plugin in ChatGPT's plugin directory (also used by Codex) and in Claude's plugin directory, so you don't need a token. Dashboard → Integrations shows both under AI Connections, each with a button that opens the plugin and a step-by-step guide. In ChatGPT:

  1. 1In ChatGPT, open Plugins, search for "Simplio3D" and click Install plugin — or click Open in ChatGPT on Dashboard → Integrations.
  2. 2Click Connect Simplio3D. A Simplio3D sign-in page opens in a new tab: sign in there, never in the chat.
  3. 3On the Simplio3D approval page, choose the workspace. Read-only access is ticked for you. To let ChatGPT build and edit your projects, tick all the boxes under Write access. Then click Authorize.
  4. 4Back in ChatGPT, try a prompt such as "Audit my Simplio3D projects". The connection is listed under Dashboard → Integrations → AI Connections, where you can revoke it at any time.

In Claude, open Customize → Plugins, search for Simplio3D and install the plugin, then connect Simplio3D on the plugin's Connectors tab — the same sign-in and approval page follows, with the same Write access boxes. The plugin also teaches Claude how to audit, build and price configurators. If you already added the Simplio3D connector (below), the plugin reuses that connection.

Write access is opt-in. Without it the assistant can read, audit and explain, but not change anything. To add it after connecting read-only, disconnect Simplio3D in ChatGPT or Claude, revoke the old connection under AI Connections, then connect again and tick the Write access boxes. Full walkthroughs with a screenshot of every screen: the ChatGPT plugin guide and the Claude plugin guide.

The bar at the top of your dashboard. Simplio3D may also remind you with a short bar above the dashboard: “Use ChatGPT or Claude? Install the Simplio3D plugin…”. Get the plugin brings you to these cards, and the ✕ turns the bar off for good, on every device. It only appears a few times, never instead of a message about your account, and during a free trial it shows once before the trial countdown comes back. It also stops by itself once ChatGPT or Claude is connected.

Connecting Claude from its connector directory

Simplio3D is listed in Claude's connector directory, so Claude users don't need a token at all. This works in Claude on the web, the desktop and mobile apps, and Cowork.

  1. 1In Claude, open Customize → Connectors and search for "Simplio3D" (or open claude.ai/directory/connectors/simplio3d).
  2. 2Click Connect. A Simplio3D sign-in page opens — sign in with your Simplio3D account.
  3. 3On the Simplio3D approval page, choose the workspace. Read-only access is ticked for you; tick the write permissions only if you want Claude to make changes. Then click Authorize.
  4. 4You are back in Claude, connected. The connection is listed under Dashboard → Integrations → AI Connections, where you can revoke it at any time.
Claude asks you before it runs anything that changes or removes something in your projects, and risky changes such as prices or deletions still wait for your approval in Simplio3D. To give Claude more access later, disconnect and connect again, and tick the extra permissions on the approval page. Removing the connector inside Claude does not revoke it in Simplio3D — revoke it on the AI Connections page too.

Creating a connection

For Cursor, VS Code, Claude Desktop configuration files and other tools that ask for a token:

  1. 1Open Dashboard → Integrations → AI Connections.
  2. 2Copy the MCP endpoint shown at the top — that is the address your AI tool connects to.
  3. 3Click "Create connection" and give it a name that says which tool it is for, such as "Claude Desktop". A name per tool makes it obvious which one to revoke later.
  4. 4Choose the workspace. A connection is tied to the workspace you pick here, permanently.
  5. 5Tick only the scopes that tool actually needs (see below), then create it.
  6. 6Copy the token immediately — it is shown once and never again — and paste it into your AI tool's configuration alongside the endpoint.
The token is a credential, exactly like a password. Anyone holding it can act on your workspace within its scopes for the whole 90 days. Rotate it the moment it is exposed — pasted into a chat or an AI transcript, attached to a support ticket, or shown on a screen share or recording. Rotating takes seconds; a leaked token does not expire because you regret it.

Choosing scopes (give it the least it needs)

Scopes are the doors the key opens. Start read-only, then add one write scope at a time as you find you need it — an agent that only reviews your pricing does not need to create projects or edit materials.

Scope groupWhat it allowsTick it when the agent should…
Workspace (read)See your workspace, plan and usage summary.Answer "what plan am I on / how much am I using".
Projects (read / write)List and inspect projects; create, rename, duplicate and change safe project settings.Report on your projects, or set new ones up for you.
Assets (read)List assets and inspect a 3D model's part names and hierarchy.Talk about the meshes inside your models.
Materials (read / write)Read the library; create and edit materials and assign them to variants.Build or tidy your material library.
Configurator (read / write)Read and author option blocks, variants and conditional rules.Build or restructure the options shoppers see.
Pricing (read / write)Read prices and formulas; propose pricing, SKU and formula changes.Work on pricing — every write still lands as an approval.
Forms (read / write)Read and author quote and checkout form fields.Build or adjust the lead form.
Quotes (read)Read submitted quote requests, including customer details.Summarize or triage incoming leads. Be deliberate — this is customer data.
Commerce (read / write)See whether a store is connected and list its products; link a product and set the checkout mode.Wire a project to a store product. Never grants access to store credentials.
Workflows (read)List workflow types and follow the progress of a run.Report on a long job you started in the app.
Several small connections beat one all-powerful one. Give the tool that reviews pricing a read-only token plus pricing write, and the tool that builds projects its own. Revoking one then never disrupts the other.

Expiry, rotating and revoking

  • Every token expires after 90 days. The connection list shows the expiry date and an Expired badge once it passes; an expired token simply stops working.
  • Rotate issues a replacement and stops the current token immediately. Use it on schedule, and always after any exposure. Update the tool with the new token straight away.
  • Revoke cuts the connection off immediately and cannot be undone. Use it when a tool is retired, or when you are unsure who has the token.
  • Each row shows when it was created and last used — a connection that has never been used is a good candidate for revoking.

One connection, one workspace

The workspace you choose at creation is baked into the connection and cannot be switched afterwards. If an agent asks about a project that belongs to a different workspace, it will be told the project does not exist — that is the boundary working, not a bug. To work across two workspaces, create a connection from each.

Approving what an agent proposes

Risky changes never happen out in the AI tool. They appear under Pending AI changes on the same AI Connections page, each listing every change it wants to make. Press Apply to accept or dismiss it to decline. Proposals are short-lived, so an old one is refused rather than written over your newer edits — just ask the agent again.

OAuth instead of a token

Some AI tools can authorize themselves rather than asking you for a token. You will see a Simplio3D consent screen naming the app, the workspace and the exact permissions it is requesting; approve it and the connection appears in the same list, marked OAuth app. Rotate and revoke work identically.

The full tool list

Every action an agent can take — what it reads, what it can change, and which ones always need your approval — is catalogued in the MCP documentation, along with connection instructions for individual AI clients.

More in Integrations

WooCommerceConnect WooCommerce and choose, per project, cart or checkout, the configured product with its 3D image and options, and the Simplio3D or WooCommerce price.WordPress PluginBuild configurator pages in WordPress from native blocks — Viewer, Options, Price, Summary and Add to Cart — connected to your account, with WooCommerce prices verified by Simplio3D.WordPress Plugin in ElementorBuild a Simplio3D configurator page in Elementor with the plugin’s shortcodes — one Shortcode widget per block, copied from the block editor, with Add to Cart, styling and fixes.ShopifyUse the Simplio3D app for Shopify from the Shopify App Store (works for client-owned stores) or connect your own Shopify app in the dashboard, then sell configured products via cart permalinks, draft orders, or SKU-matched carts.Save and Add to CartAn Enterprise setting for Shopify: one click saves the shopper's design, emails them a link and adds that design to the cart. What shoppers see, what happens when a step fails, and what reaches Shopify.API & SDK Quick StartGet started with the Simplio3D REST API and headless TypeScript SDK to drive configurators from your own code.Mobile & Native AppsEmbed your configurator in an iOS, Android, React Native, or Flutter app — web view setup, the AR hand-off, and the native event bridge.Building a Custom UIDesign your own configurator interface with @simplio3d/viewer — the platform renders the 3D product while you own every control, in any framework.Headless Integration WalkthroughShip a custom-UI configurator with @simplio3d/viewer step by step — install it, wire your own controls, handle failures, and avoid the traps that break silently.