From 6a06b0624731046c7c519a3e4dec1ff2cfceaf2e Mon Sep 17 00:00:00 2001 From: Matthew Podwysocki Date: Tue, 24 Feb 2026 12:03:53 -0500 Subject: [PATCH 1/2] Reframe docs: MCP Apps primary, MCP-UI compatibility MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Update ENABLE_MCP_UI section to clearly state MCP Apps is the primary interactive preview investment; MCP-UI maintained for Goose compatibility - Fix incorrect claim that Claude Desktop doesn't support interactive previews — it supports MCP Apps (and has since the ext-apps integration) - Add client compatibility table showing MCP Apps vs MCP-UI vs text URL - Clarify that ENABLE_MCP_UI only controls the MCP-UI UIResource; MCP Apps support is always active Co-Authored-By: Claude Sonnet 4.6 --- README.md | 28 +++++++++++++++++----------- 1 file changed, 17 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index 250cece..7e93ac6 100644 --- a/README.md +++ b/README.md @@ -1271,25 +1271,31 @@ By default, the server returns generic error messages. With verbose errors enabl #### ENABLE_MCP_UI -**MCP-UI Support (Enabled by Default)** +**Interactive Previews: MCP Apps (primary) & MCP-UI (compatibility)** -MCP-UI allows tools that return URLs to also return interactive iframe resources that can be embedded directly in supporting MCP clients. **This is enabled by default** and is fully backwards compatible with all MCP clients. +This server actively invests in **MCP Apps** as its primary interactive preview protocol, delivering self-contained HTML app panels directly inside the chat. MCP Apps is supported by Claude Desktop, VS Code with GitHub Copilot, and Claude Code — no configuration needed. + +**MCP-UI** (`@mcp-ui/server`) is also maintained for backwards compatibility with clients like Goose. It is not being removed, but new interactive preview development is focused on MCP Apps. **Supported Tools:** -- `preview_style_tool` - Embeds Mapbox style previews -- `geojson_preview_tool` - Embeds geojson.io visualizations -- `style_comparison_tool` - Embeds side-by-side style comparisons +- `preview_style_tool` - Interactive Mapbox style preview panel +- `geojson_preview_tool` - Interactive GeoJSON visualization panel +- `style_comparison_tool` - Side-by-side style comparison panel -**How it Works:** +**Client support:** -- Tools return **both** a text URL (always works) and a UIResource for iframe embedding -- Clients that don't support MCP-UI (like Claude Desktop) simply ignore the UIResource and use the text URL -- Clients that support MCP-UI (like Goose) can render the iframe for a richer experience +| Client | Protocol | Experience | +| --------------------------- | ----------- | ----------------------- | +| Claude Desktop | MCP Apps ✅ | Interactive HTML panel | +| VS Code with GitHub Copilot | MCP Apps ✅ | Interactive HTML panel | +| Claude Code | MCP Apps ✅ | Interactive HTML panel | +| Goose | MCP-UI ✅ | Embedded iframe preview | +| Other clients | — | Text URL | **Disabling MCP-UI (Optional):** -If you want to disable MCP-UI support: +MCP Apps support is always active. If you want to disable the MCP-UI UIResource (used by Goose): Via environment variable: @@ -1303,7 +1309,7 @@ Or via command-line flag: node dist/esm/index.js --disable-mcp-ui ``` -**Note:** You typically don't need to disable this. The implementation is fully backwards compatible and doesn't affect clients that don't support MCP-UI. See [mcpui.dev](https://mcpui.dev) for compatible clients. +**Note:** You typically don't need to disable this. All clients receive a usable text URL regardless; interactive previews are a progressive enhancement on top. #### CLIENT_NEEDS_RESOURCE_FALLBACK From 97c6bec3118f926cff9c430073c9f141b61149f1 Mon Sep 17 00:00:00 2001 From: Matthew Podwysocki Date: Tue, 24 Feb 2026 12:05:52 -0500 Subject: [PATCH 2/2] Update compatible clients: Goose supports MCP Apps too Co-Authored-By: Claude Sonnet 4.6 --- README.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 7e93ac6..d15f02c 100644 --- a/README.md +++ b/README.md @@ -1285,13 +1285,13 @@ This server actively invests in **MCP Apps** as its primary interactive preview **Client support:** -| Client | Protocol | Experience | -| --------------------------- | ----------- | ----------------------- | -| Claude Desktop | MCP Apps ✅ | Interactive HTML panel | -| VS Code with GitHub Copilot | MCP Apps ✅ | Interactive HTML panel | -| Claude Code | MCP Apps ✅ | Interactive HTML panel | -| Goose | MCP-UI ✅ | Embedded iframe preview | -| Other clients | — | Text URL | +| Client | MCP Apps | MCP-UI | +| --------------------------- | -------- | ------ | +| Claude Desktop | ✅ | | +| VS Code with GitHub Copilot | ✅ | | +| Claude Code | ✅ | | +| Goose | ✅ | ✅ | +| Other clients | | | **Disabling MCP-UI (Optional):**