codex - ✅(Solved) Fix Codex Desktop does not render MCP Apps inline UI resources even when tool result includes mcp_app_resource_uri [1 pull requests, 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#21019Fetched 2026-05-05 05:54:23
View on GitHub
Comments
0
Participants
1
Timeline
4
Reactions
0
Participants
Timeline (top)
labeled ×3subscribed ×1

Codex Desktop currently appears able to call MCP tools, but it does not render MCP Apps inline iframe UI resources.

A minimal MCP App tool returns a valid mcp_app_resource_uri and _meta resource URI fields, but Codex Desktop never appears to call read-mcp-resource, so the inline UI is not rendered.

Can you confirm whether MCP Apps inline UI is currently supported in Codex Desktop, and if not, when it is expected to be supported?

Root Cause

Codex Desktop currently appears able to call MCP tools, but it does not render MCP Apps inline iframe UI resources.

A minimal MCP App tool returns a valid mcp_app_resource_uri and _meta resource URI fields, but Codex Desktop never appears to call read-mcp-resource, so the inline UI is not rendered.

Can you confirm whether MCP Apps inline UI is currently supported in Codex Desktop, and if not, when it is expected to be supported?

PR fix notes

PR #19884: Add MCP app feature flag

Description (problem / solution / changelog)

Summary

  • Add the enable_mcp_apps feature flag to the codex-features registry
  • Keep it under development and disabled by default

Testing

  • Unit tests for codex-features passed
  • Formatting passed

Changed files

  • codex-rs/core/config.schema.json (modified, +6/-0)
  • codex-rs/features/src/lib.rs (modified, +8/-0)

Code Example

{
  "structuredContent": {
    "title": "Minimal MCP Inline App",
    "inline_resource_uri": "ui://minimal-inline/hello.html"
  },
  "_meta": {
    "ui/resourceUri": "ui://minimal-inline/hello.html",
    "ui.resourceUri": "ui://minimal-inline/hello.html",
    "openai/outputTemplate": "ui://minimal-inline/hello.html",
    "openai/resultCanProduceWidget": true,
    "openai/widgetAccessible": true,
    "ui": {
      "resourceUri": "ui://minimal-inline/hello.html"
    }
  }
}

---

mcp_app_resource_uri: ui://minimal-inline/hello.html
RAW_BUFFERClick to expand / collapse

Summary

Codex Desktop currently appears able to call MCP tools, but it does not render MCP Apps inline iframe UI resources.

A minimal MCP App tool returns a valid mcp_app_resource_uri and _meta resource URI fields, but Codex Desktop never appears to call read-mcp-resource, so the inline UI is not rendered.

Can you confirm whether MCP Apps inline UI is currently supported in Codex Desktop, and if not, when it is expected to be supported?

Environment

  • Codex Desktop: 26.429.30905
  • Bundled Codex CLI/runtime: codex-cli 0.128.0-alpha.1
  • macOS
  • MCP server: local stdio server
  • features.apps = true
  • features.enable_mcp_apps = true was also tested

Reproduction

  1. Register a local MCP server that exposes:

    • a tool: show_minimal_inline_app
    • a resource: ui://minimal-inline/hello.html
  2. The tool returns a successful result with:

{
  "structuredContent": {
    "title": "Minimal MCP Inline App",
    "inline_resource_uri": "ui://minimal-inline/hello.html"
  },
  "_meta": {
    "ui/resourceUri": "ui://minimal-inline/hello.html",
    "ui.resourceUri": "ui://minimal-inline/hello.html",
    "openai/outputTemplate": "ui://minimal-inline/hello.html",
    "openai/resultCanProduceWidget": true,
    "openai/widgetAccessible": true,
    "ui": {
      "resourceUri": "ui://minimal-inline/hello.html"
    }
  }
}
  1. Codex session logs show:
mcp_app_resource_uri: ui://minimal-inline/hello.html
  1. However, Codex Desktop does not render an inline iframe UI and no read-mcp-resource / resource read is observed.

Expected behavior

When an MCP tool result includes a valid MCP App resource URI, Codex Desktop should read the MCP resource and render it inline as an iframe/app UI.

Actual behavior

The MCP tool call succeeds and the session log contains mcp_app_resource_uri, but the Desktop UI only shows the textual tool result. No inline app UI is rendered.

Additional investigation

I inspected the current Desktop bundle and found that MCP Apps rendering appears to be gated by enable_mcp_apps / renderMcpApps.

The public Codex docs mention features.apps, but I could not find public documentation for features.enable_mcp_apps.

The OpenAI Codex repo has PR #19884, "Add MCP app feature flag", which adds enable_mcp_apps as an under-development feature disabled by default: https://github.com/openai/codex/pull/19884

This suggests MCP Apps inline UI may currently be behind an internal/product gate, even though MCP tools and resources are otherwise available.

Question

Is MCP Apps inline UI currently supported in Codex Desktop?

If it is intentionally gated or temporarily disabled, is there a documented way to enable it locally, or an expected release/version where it will be supported?

extent analysis

TL;DR

The issue is likely due to the enable_mcp_apps feature flag being disabled by default, preventing MCP Apps inline UI from rendering in Codex Desktop.

Guidance

  • Check the current status of the enable_mcp_apps feature flag in the Codex Desktop configuration to confirm if it's enabled or disabled.
  • Review the OpenAI Codex repo PR #19884 to understand the development status of the enable_mcp_apps feature.
  • Investigate if there's a local configuration option or a command-line flag to enable enable_mcp_apps for testing purposes.
  • Monitor the Codex Desktop release notes for upcoming versions that may include support for MCP Apps inline UI.

Example

No code snippet is provided as the issue is related to feature flags and configuration.

Notes

The enable_mcp_apps feature flag is currently under development and disabled by default, which might be the cause of the issue. The public documentation for features.enable_mcp_apps is not available, making it difficult to provide a definitive solution.

Recommendation

Apply workaround: Wait for an upcoming release of Codex Desktop that includes support for MCP Apps inline UI, or try to enable the enable_mcp_apps feature flag locally if possible, as the current version seems to have this feature gated.

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…

FAQ

Expected behavior

When an MCP tool result includes a valid MCP App resource URI, Codex Desktop should read the MCP resource and render it inline as an iframe/app UI.

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 - ✅(Solved) Fix Codex Desktop does not render MCP Apps inline UI resources even when tool result includes mcp_app_resource_uri [1 pull requests, 1 participants]