Polly3D Documentation Français
AI assistant

AI assistant (MCP)

Let Claude, Cursor, Codex or another assistant build and adjust your scene through Polly3D's MCP server.

Polly3D Studio contains an MCP server (Model Context Protocol). An AI assistant that supports MCP — Claude (Desktop or Code), Cursor, VS Code, Codex, Antigravity… — can see and edit your scene with about forty tools: create objects, build materials, set lights, clone, animate, and look at the result with a render.

The conversation stays in your assistant's application (with your own subscription). The Assistant tab of Studio only shows a log of the actions taken. Every tool call is an undo step you can undo with ⌘ Z.

Setting it up#

  1. Open File > MCP settings… in Studio (or the button of the Assistant tab).
  2. In MCP Server, make sure the server is on.
  3. Switch on the assistant you use: Claude Desktop, Claude Code, Cursor, VS Code, Codex, Antigravity. Studio adds (or removes) the entry in that assistant's configuration file.
  4. For any other assistant, copy the JSON entry from Other assistants with Copy.
  5. Restart your assistant. Then ask it things like "Create a glass sphere on a blue backdrop with a soft light".

Studio is opened on demand when the assistant connects. Nothing goes over the network: the assistant talks to Studio through a local, owner-only socket in ~/Library/Application Support/Polly3D.

What the assistant can do#

Scene and objects, materials and layers, the Cloner and effectors, animation, links to After Effects sliders and drivers, mood and render settings, reference pictures. See Assistant tools for the complete list.

It can also manage the scene tabs (open a new scene, switch, save, close). It never throws away unsaved changes without being told to.

It cannot:

  • change the After Effects effect itself (camera, comp lights, nulls, Custom Textures, Aux sliders). It can tell you what to do there;
  • link After Effects text layers.

How it works with you#

  • The assistant first reads a built-in guide (get_guide) that explains how Polly3D works: materials, glass, lighting, the Cloner, animation, After Effects…
  • It looks at the scene (get_scene), builds in small steps, and uses render_preview to see an image of the result, then corrects it.
  • It works on the same scene you have open. You can step in at any time and edit; undo is shared.
  • Give it reference pictures (see below), a mood and a purpose ("a loader for a tech brand", "a product shot of a perfume bottle").

Matching a reference picture#

Give the assistant a file path to a photo, mood board or film frame. It can:

  1. Measure the picture (extract_palette): dominant colors, brightness, contrast, saturation, warmth, and where the light falls (a 3 × 3 brightness grid);
  2. build a first version framed like the reference;
  3. compare (compare_to_reference): it renders the scene and returns one image reference | render | difference with numbers and hints;
  4. correct one thing at a time, and compare again.

A pixel-perfect copy is neither possible nor the goal when the composition differs; the assistant tells you what remains different (a texture, a shape).

Good prompts#

  • Describe the result and the mood: "warm, soft studio light, pastel colors, a glass cube floating above a pink floor".
  • Ask it to name objects and groups so you can find them.
  • Ask for animation that you can finish in After Effects: "link the glass Blur to a Connector and tell me which one".
  • Iterate: "make the glass thicker", "the highlight is too harsh", "lower the sun".

Troubleshooting#

ProblemFix
The assistant does not see Polly3DCheck the switch for your assistant in MCP Settings, then restart it
The assistant cannot connectOpen Polly3D Studio once and check that the MCP Server is on
Nothing changes in the viewportCheck the Assistant tab: the log shows each action. Use ⌘ Z to undo
The scene is not updated in After EffectsThe assistant cannot save; press ⌘ S
Polly3D Studio documentation