Figma Prototype support?

[ihardyslide]

Describe the bug
Currently when I try to access a prototype file (URL format like: "https://www.figma.com/proto/REDACTED/branch/REDACTED/REDACTED?node-id=REDACTED&starting-point-node-id=REDACTED") from Figma via your MCP tool, I get the following response:

figma-mcp - get_figma_data (MCP)(fileKey: "REDACTED", nodeId: "REDACTED")
  ⎿  Error: Error fetching file: Cannot read properties of null (reading 'components')

Then Claude tries the same without node-id, which results in this:

● figma-mcp - get_figma_data (MCP)(fileKey: "REDACTED")
 Error: Error fetching file: Failed to make request to Figma API: Fetch failed with status 400: Bad Request

Software Versions

• Figma Developer MCP: 0.4.3
• Node.js: v22.14.0
• NPM: 11.4.2
• Operating System: Debian Bullseye
• Client: Claude Code
• Client Version: 1.0.53

To Reproduce
Steps to reproduce the behavior:

1. Setup MCP in Claude Code with claude mcp add -s user figma-mcp -- npx -y figma-developer-mcp --figma-api-key=REDACTED --stdio
2. Ask Claude Code to get infos from specific Figma URL
3. See errors in claude output

Expected behavior
Claude Code should be able to process the call to Figma

[GLips]

Interesting. The prototype link has the same properties (fileKey and nodeId) that the Figma MCP expects. Looks like the result returned from the API was null though. Is it possible your Figma personal access token doesn't have read permissions on the file that's associated with the prototype @ihardyslide?

[ihardyslide]

Hi,

thanks for the response. The prototype is inside the same Project where everything else of our Figma files are and the token has full read access, so it should actually have access to it.
Can it be, that it can't access it because it is inside a Figma-Branch?

Thx & BR

[oshermaayan]

Hi @GLips , we've encountered the same issue. Any ideas on how to solve it? I'm happy to help