AI Agents

Let a coding assistant like Claude Code see your board and work on it. It paints, builds node graphs, and exports.

Magerie can hand your board to an AI assistant. Turn on one setting and an assistant running on the same machine can see what is on your canvas, paint on it, wire up nodes, and export the result. You stay in the app the whole time and watch it happen.

This uses MCP (Model Context Protocol), the standard those assistants use to talk to other apps. Claude Code is the one Magerie sets up for you.

Turn it on#

Settings > Integrations > MCP Server. Flip it on.

That is the whole setup. The server starts immediately (no restart), and Magerie registers itself with Claude Code for you. The Claude Code row turns green and says Registered.

Start a new assistant session after that and it will already know about Magerie. Sessions you had open before need restarting.

What it can do#

Ask in plain language. The assistant works on the board you have open.

It can For example
Look at your board "What nodes are on my board?"
Paint "Draw a red circle on the image node, then fill it blue."
Build node graphs "Add a Noise node, blur it, and wire it into the canvas."
Change settings "Turn the blur radius up to 20."
Write script nodes "Write a JavaScript node that draws a spiral."
Play and scrub "Jump to 3 seconds and show me that frame."
Bring images in and out "Import this photo." / "Export the board to my Desktop."

It paints with the real brush engine, so strokes respect your active layer, your selection, and locks. Every stroke lands in your undo history: Cmd/Ctrl + Z takes back what the assistant did, exactly like your own strokes.

It can also see its own work. After painting it looks at the result, so you can say "make the beak bigger" and it knows what it drew.

Asking well#

  • Name the node. "Paint on the Image node called Sketch" beats "paint on the canvas."
  • Give it a size to work in. "The canvas is 1024 square" helps it place things.
  • Ask for changes in steps. "Now add a shadow under it" works better than one giant instruction.
  • If a result is off, undo and rephrase. It is faster than asking for a fix.

Other apps#

Cursor, VS Code, and other MCP-capable tools work too, with one paste. Press Copy Config in the same Settings panel and paste it into that app's MCP settings.

That config includes this machine's access token. Treat it like a password: it lets anything holding it edit your boards.

Good to know#

  • Nothing happens unless you ask. The assistant only acts on your instructions, and only while Magerie is running.
  • It works on the board you are looking at. Switch documents and it follows you.
  • The server only listens on this computer. It is not reachable from the internet.
  • Turn it off any time with the same toggle.

Where to next#

  • Painting covers the brush, layers, and selections the assistant paints through.
  • Node Graph explains the nodes it wires up.
  • Code Nodes is what it writes when you ask for a script.