Figma MCP Server Setup: Remote vs Desktop
On this page
Why not just paste a screenshot?
A screenshot tells the agent what a design looks like. It doesn't say that the gray is your color/surface/muted variable, that the spacing is 24 pixels, or that the button is already a component in your codebase. So the agent invents values, and you spend the next hour replacing them. Figma's MCP server sends that structure along with the picture, so the code uses your tokens and components.
Remote or desktop?
Figma runs two servers:
| Remote | Desktop | |
|---|---|---|
| URL | https://mcp.figma.com/mcp | http://127.0.0.1:3845/mcp |
| Needs the Figma desktop app | No | Yes, running |
| Plans | All plans | A Dev or Full seat on a paid plan (Professional, Education, Organization, Government or Enterprise) |
| How you point at a design | Paste a link to a frame | Select it in Figma, or paste a link |
| Can write to the canvas | Yes (beta) | No |
Start with the remote server: it works on every plan and needs nothing installed. One limit to know: only clients listed in Figma's MCP catalog (figma.com/mcp-catalog) can connect to it. Claude Code, Codex, Cursor, VS Code and Gemini CLI are all on that list.
Add the remote server
You sign in with your Figma account the first time you connect.
Claude Code. Figma's docs list the plugin as the recommended route:
claude plugin install figma@claude-plugins-officialOr add just the server:
claude mcp add --transport http figma https://mcp.figma.com/mcpCodex CLI:
codex mcp add figma --url https://mcp.figma.com/mcpCursor (~/.cursor/mcp.json):
{
"mcpServers": {
"figma": { "url": "https://mcp.figma.com/mcp" }
}
}VS Code (.vscode/mcp.json):
{
"servers": {
"figma": { "type": "http", "url": "https://mcp.figma.com/mcp" }
}
}Or enable the desktop server
- Open a design file in the Figma desktop app.
- Switch to Dev Mode (press Shift+D) with nothing selected.
- In the right sidebar, find the MCP server section and click Enable desktop MCP server.
Then connect your client to the local URL, for example in Claude Code:
claude mcp add --transport http figma-desktop http://127.0.0.1:3845/mcpHow to ask for a design
With the remote server, give the agent a link. In Figma, right-click the frame or layer and choose Copy link to selection, then paste it into your prompt:
Build this card as a React component using our existing Button and Avatar components:
https://www.figma.com/design/AbC123/Dashboard?node-id=42-1337The client doesn't open the link in a browser. It pulls the node ID out of it and asks the server for that node. With the desktop server you can skip the link: select the frame in Figma and say "implement my current selection".
The tools behind it
The tool you'll see most is get_design_context. It returns the layer's structure and suggested code, React with Tailwind by default, which the agent then adapts to your stack. Others fill in the details:
get_variable_defsreturns the variables and styles used, so colors and spacing map to your tokens.get_screenshotgives the agent an image to check its result against.get_metadatareturns a lighter outline of a large selection, useful before drilling into one part.get_code_connect_maplinks Figma components to the components in your codebase, if your team uses Code Connect.
The remote server also has write tools, such as generate_figma_design, which are free during the beta. Writing outside your drafts needs a Full seat.
Getting better code out of it
- Select less. Ask for one card or section at a time, not a whole page. Use
get_metadatato outline a big screen first, then request its parts. - Name your layers and use components and variables. The server can only pass on structure that exists in the file.
- Tell the agent your stack, such as "Vue with our CSS modules", since the default output is React and Tailwind.
- Generate project rules once with the
create_design_system_rulesprompt, so every later request follows your conventions.
Check yourself
The remote server at https://mcp.figma.com/mcp. The desktop server needs a Dev or Full seat on a paid plan.
Calling a Figma MCP tool such as get_design_context, using the node ID from the link. Check that the Figma server is connected and enabled in your client.
Make sure the design uses Figma variables, and have the agent call get_variable_defs (or ask it to map values to your tokens) along with get_design_context.