Docs menu · Claude Code & MCP

Documentation

Claude Code & MCP

Tessera ships an MCP (Model Context Protocol) server. Register it once and every Claude Code chat, in any project folder, can build and edit Tessera scenes: just say “use tessera to…”. This is separate from the Claude provider in the AI panel, which uses the same tools from inside the app.

Connect Claude Code

  1. Install Tessera and Claude Code, and sign in to Claude Code.
  2. Run this once in a terminal (Command Prompt or PowerShell):
Register the Tessera MCP server for your user (all projects)
claude mcp add --scope user tessera -- "%LOCALAPPDATA%\Programs\tessera\resources\runtime\python.exe" "%LOCALAPPDATA%\Programs\tessera\resources\engine\tessera\mcp_server.py"

It points Claude Code at Tessera’s bundled Python (%LOCALAPPDATA%\Programs\tessera\resources\runtime\python.exe) and the MCP server script (%LOCALAPPDATA%\Programs\tessera\resources\engine\tessera\mcp_server.py). --scope user makes it available in every project. Check it with claude mcp list; inside a chat, /mcp shows the server and its tools.

The same command for PowerShell
claude mcp add --scope user tessera -- "$env:LOCALAPPDATA\Programs\tessera\resources\runtime\python.exe" "$env:LOCALAPPDATA\Programs\tessera\resources\engine\tessera\mcp_server.py"

How it works

  • The MCP server talks to the Tessera engine over HTTP at http://127.0.0.1:7419 (override with the TESSERA_URL environment variable).
  • App open: Claude’s edits appear live in the Tessera window: the graph, the viewport and the Log.
  • App closed: the MCP server starts the engine headless in the background (no window) and works with it. Open the app later and it reuses that engine, so you see the same scene.
  • The server also gives Claude Tessera’s working guide: list and describe node types before using them, build in named batches, render and judge the result, run the layout check, lay out and comment the graph, save when done.

MCP tools

ToolWhat it does
list_node_typesList node types, optionally by category or search text
describe_node_typesFull docs and parameters for the given types
get_sceneThe current graph(s): nodes, types, inputs, params, display flag, errors
edit_graphApply a batch of graph ops, then cook the display node and report stats and errors
cookCook a node at a frame: counts, bounding box, attributes, errors
renderRender a node to an image so Claude can see it (views persp, front, side, top, back, left, quad; frame; size; wireframe)
inspect_attributesSpreadsheet rows of point / prim / vertex / detail attributes
run_pythonRun Python inside the engine (bulk generation, custom analysis)
exportWrite a node to .glb / .gltf / .obj / .ply / .stl / .tgeo.npz, single frame or a range
scene_fileScenes: new, save, load, list, load_example
frame_viewMove the camera of the open Tessera window(s)
send_to_unrealSend a node to the open Unreal Editor; live keeps it synced
check_layoutCheck an assembled scene for overlapping or floating parts, unseated roofs and lifted chimneys, with exact fixes

Example prompts

  • “Use tessera to build a mossy cliff terrain with a river, and export a 16-bit heightmap for Unreal.”
  • “Use tessera: fracture a stone column and knock it over with a ball. Render frame 60.”
  • “In tessera, make a fairy village of 12 houses, check the layout, then send it to Unreal with live link.”
  • “Open the tessera example eroded_mountains and add a forest below the tree line.”
  • “Use tessera to generate 20 rock variants and export each as a GLB into C:\Game\Rocks.”
  • “Look at the current tessera scene and tell me which nodes are slowest.”

Claude can also combine Tessera with your codebase: generate assets that match a level description, write export scripts, or build a node graph from a design document.

Other MCP clients

Any MCP client that supports stdio servers can use the same command and arguments: run %LOCALAPPDATA%\Programs\tessera\resources\runtime\python.exe with the argument %LOCALAPPDATA%\Programs\tessera\resources\engine\tessera\mcp_server.py. Codex, for example, is already wired up by Tessera when you use the GPT provider in the app.

Remove or update

Updates of Tessera keep the same paths, so the registration keeps working. To remove it:

claude mcp remove --scope user tessera