codex - 💡(How to fix) Fix Figma Make resource links returned by get_design_context cannot be read in Codex App [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openai/codex#18119Fetched 2026-04-17 08:32:34
View on GitHub
Comments
0
Participants
1
Timeline
8
Reactions
0
Author
Participants
Timeline (top)
labeled ×5unlabeled ×3

Error Message

  • resources/read failed for codex_apps ... Mcp error: -32600: Unknown resource: file://figma/make/source/...

Root Cause

  1. Open the Codex App with the Figma plugin connected and authenticated.
  2. Use any Figma Make URL.
  3. Extract the Make fileKey from that URL.
  4. Call get_design_context for that file key.
    • because the Codex tool currently requires a node id, use nodeId = 0:1
  5. Observe that the tool returns resource_links such as:
    • file://figma/make/source/{fileKey}/src/app/App.tsx
  6. Call read_mcp_resource on one of those exact returned URIs.
  7. Observe the failure:
    • Unknown resource: file://figma/make/source/...
RAW_BUFFERClick to expand / collapse

What version of the Codex App are you using (From "About Codex" dialog)?

26.409.20454

What subscription do you have?

Plus

What platform is your computer?

Darwin 25.3.0 arm64 arm

What issue are you seeing?

Figma Make files can be partially initialized in the Codex App, but the returned Make source resources cannot be read afterward.

On the same session:

  • mcp__codex_apps__figma_get_design_context succeeds for a Figma Make file and returns resource_links in the format file://figma/make/source/{fileKey}/...
  • read_mcp_resource on one of those returned URIs fails with:
    • resources/read failed for codex_apps ... Mcp error: -32600: Unknown resource: file://figma/make/source/...

There is a second issue on top of that: the local Figma skill/plugin guidance still assumes that Figma URLs must contain node-id, but Figma Make URLs do not include node-id.

So the current Codex App flow for Figma Make is inconsistent:

  1. get_design_context is able to discover Make source resources
  2. the app/bridge then fails to read those exact returned resources

What steps can reproduce the bug?

  1. Open the Codex App with the Figma plugin connected and authenticated.
  2. Use any Figma Make URL.
  3. Extract the Make fileKey from that URL.
  4. Call get_design_context for that file key.
    • because the Codex tool currently requires a node id, use nodeId = 0:1
  5. Observe that the tool returns resource_links such as:
    • file://figma/make/source/{fileKey}/src/app/App.tsx
  6. Call read_mcp_resource on one of those exact returned URIs.
  7. Observe the failure:
    • Unknown resource: file://figma/make/source/...

Related observations:

  • get_metadata(fileKey="{fileKey}", nodeId="0:1") also timed out after 120s in the same environment.
  • Another MCP client was able to do the same 2-step flow (get_design_context -> read returned file://figma/make/source/... resources) against the same Make file.

What is the expected behavior?

Two things should work consistently for Figma Make files:

  1. Codex App should support Figma Make URLs without requiring a node-id-style workflow in the user-facing skill guidance.
  2. If get_design_context returns file://figma/make/source/... resource URIs, read_mcp_resource should be able to read those returned URIs successfully in the same session.

Additional information

  • Codex CLI on this machine: codex-cli 0.114.0
  • Local bundled Figma plugin version in the app cache: 2.0.7
  • The bundled Figma skill/plugin docs still strongly assume classic design/...?...node-id=... URLs
  • This appears related to, but distinct from:
    • #16718
    • #17106

The issue here is specifically the Figma Make resource hydration/read path:

  • get_design_context returns valid-looking Make source URIs
  • read_mcp_resource cannot resolve those returned URIs in Codex App

extent analysis

TL;DR

The issue can be addressed by updating the Figma plugin to handle Figma Make URLs without requiring a node-id and ensuring that read_mcp_resource can resolve the returned URIs from get_design_context.

Guidance

  • Verify that the get_design_context API is correctly returning resource_links in the format file://figma/make/source/{fileKey}/... for Figma Make files.
  • Check the documentation and implementation of read_mcp_resource to ensure it supports reading resources from Figma Make URLs without a node-id.
  • Update the local Figma skill/plugin guidance to reflect the correct URL format for Figma Make files, which does not include node-id.
  • Test the updated plugin with the same Figma Make file and verify that read_mcp_resource can successfully read the returned URIs.

Example

No code snippet is provided as the issue seems to be related to the plugin's documentation and implementation rather than a specific code error.

Notes

The issue appears to be specific to the Figma Make resource hydration/read path and may not be related to other Figma URL formats. The fact that another MCP client was able to perform the same flow successfully suggests that the issue is with the Codex App's implementation.

Recommendation

Apply a workaround by updating the Figma plugin to correctly handle Figma Make URLs and ensuring that read_mcp_resource can resolve the returned URIs. This should allow the Codex App to consistently support Figma Make files.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

codex - 💡(How to fix) Fix Figma Make resource links returned by get_design_context cannot be read in Codex App [1 participants]