Skip to main content
Shubham Patel
Shubham Patel
New Member
July 29, 2026
Question

Figma [get_screenshot] MCP Server Claude Code Edit Access Error

 Why getting this error as Figma MCP says for get_screenshot read only access is needed.


Figma [get_screenshot]
OUT

Looks like you don't have edit access to this file. The file owner can share it with you and make you an editor.
[Resource link: rate-limits-access.md] file://figma/docs/rate-limits-access.md
Figma Debug UUID: 0256d728-3a1d-4b09-922c-3bbc9a6633f5


 

 

3 replies

Jaycee Lewis
Figmate
Jaycee Lewis
Figmate
July 29, 2026

Hey ​@Shubham Patel 👋 Thanks for flagging this. Let’s dig in together. 

I have a request and a few questions to help narrow things down:

  • Run whoami and share the output 
  • Which plan/team does the file actually live in? (Where is the file is parented?) 
  • Remote or desktop MCP server? 
  • To confirm, you have edit (not just view) access on that specific file? My gut says the error is generic and not MCP specific in this case

Talk soon! — Jaycee

 

Jens Geyer
Jens Geyer
New Member
October 13, 2026

Hi ​@Jaycee Lewis , we get exactly the same error with get_metadata/get_screenshot and can answer your questions for our case:

1. whoami: one plan, tier "starter", seat "View", role "admin"
2. File location: in a plan of another organization (whoami lists no plan other than ours)
3. Remote server (https://mcp.figma.com/mcp), used from Claude Code
4. We first only had "can view" via a link we were sent: both calls were rejected immediately with the same message as in the original post (debug UUIDs
fc3b696c-5c21-4ede-95af-2bf8c5534d3b and d24736d5-8b44-406d-8eea-67bf3a097358, 2026-09-23 08:29:58 UTC). Later someone granted us "can edit" on request (we don't know
at which level - file, project or team), and the identical calls on the same file work. Plan and seat in whoami are the same before and after.

So for us view-only access isn't enough, although the Help Center lists "edit or view only permissions" as the requirement. Is edit access really required for read
tools, or is something else checked (e.g. membership in the file's plan, as described in https://forum.figma.com/report-a-problem-6/mcp-not-working-51611)? Either way
the message names "edit access", which may be misleading.

Jaycee Lewis
Figmate
Jaycee Lewis
Figmate
October 13, 2026

Hey hey ​@Jens Geyer 🤩 Thank you for the details. Always super helpful. I took this to my team to get us clarity.

I feel like we have a few questions at work here:

  • Why did granting edit access to a file belonging to an outside org work with those MCP calls if the dev docs tell us “Confirm permissions: Ensure the user belongs to the plan to which the file being accessed belongs to as well”?
  • Why did the whoami not change after edit access was updated?

Could you check with the person who granted edit access whether they changed permissions on the file itself, a project, or a team? It would also help to confirm whether you were added to the team or organization containing the file at the same time.

Thanks! —Jaycee

Terms & ConditionsAccessibility statement