docs: add MCP Apps tutorial and documentation updates #6384
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
- Add new Building MCP Apps tutorial with step-by-step guide - Add mcp-app-demo example (Node.js MCP server with interactive UI) - Update interactive-chat guide with MCP Apps cards and sidebar label - Add MCP-UI transition admonition pointing to MCP Apps - Update custom-extensions tutorial with streamlined MCP Apps section - Update using-extensions with link to MCP Apps tutorial
Contributor
There was a problem hiding this comment.
Pull request overview
This PR adds comprehensive documentation and a working example for building MCP Apps with goose. MCP Apps enable interactive UI applications to render inside goose Desktop, providing an alternative to text-only responses.
Key Changes
- New tutorial with step-by-step instructions for building MCP Apps using JavaScript/Node.js
- Working example MCP App server demonstrating interactive counter, message sending, and theme synchronization
- Documentation updates positioning MCP Apps as the recommended path forward while maintaining MCP-UI support
Reviewed changes
Copilot reviewed 11 out of 12 changed files in this pull request and generated 7 comments.
Show a summary per file
| File | Description |
|---|---|
| examples/mcp-app-demo/server.js | MCP server implementation serving HTML UI via resources and tools |
| examples/mcp-app-demo/package.json | Node.js package configuration with MCP SDK dependency |
| examples/mcp-app-demo/package-lock.json | Dependency lockfile for reproducible builds |
| examples/mcp-app-demo/index.html | Interactive HTML/JS app with counter, messaging, and theme sync |
| examples/mcp-app-demo/README.md | Comprehensive documentation for the example app |
| examples/mcp-app-demo/.gitignore | Excludes node_modules from version control |
| documentation/docs/tutorials/building-mcp-apps.md | Step-by-step tutorial for building MCP Apps |
| documentation/docs/tutorials/custom-extensions.md | Updated to reference MCP Apps and streamline content |
| documentation/docs/getting-started/using-extensions.md | Added links to MCP Apps tutorial |
| documentation/docs/guides/interactive-chat/index.mdx | Updated title and added MCP Apps cards |
| documentation/docs/guides/interactive-chat/category.json | Updated sidebar label to include MCP Apps |
| documentation/docs/guides/interactive-chat/mcp-ui.md | Added transition notice about MCP Apps |
Files not reviewed (1)
- examples/mcp-app-demo/package-lock.json: Language not supported
examples/mcp-app-demo/README.md
Outdated
Comment on lines
133
to
142
| 2. Restart the MCP server (Goose will reconnect) | ||
| 3. Ask Goose to show the demo app again | ||
|
|
||
| ## Security | ||
|
|
||
| MCP Apps run in a sandboxed iframe with: | ||
|
|
||
| - Content Security Policy (CSP) restrictions | ||
| - `sandbox="allow-scripts allow-same-origin"` attribute | ||
| - No direct access to parent window or Goose internals |
There was a problem hiding this comment.
According to the project guidelines, use "goose" (lowercase), not "Goose".
examples/mcp-app-demo/README.md
Outdated
|
|
||
| - [MCP Apps Specification](https://github.com/modelcontextprotocol/ext-apps) | ||
| - [Model Context Protocol](https://modelcontextprotocol.io) | ||
| - [Goose Documentation](https://block.github.io/goose) |
There was a problem hiding this comment.
According to the project guidelines, use "goose" (lowercase), not "Goose".
Contributor
Author
There was a problem hiding this comment.
goose made this example folder..i dont want that.
angiejones
approved these changes
Jan 7, 2026
- Update title and sidebar label - Combine intro to cover both MCP Apps and MCP-UI - Streamline content and update admonition - Update developer links section
Tutorial contains all code inline - separate example folder is redundant
Contributor
|
zanesq
added a commit
that referenced
this pull request
Jan 8, 2026
* 'main' of github.com:block/goose: Fixed fonts (#6389) Update confidence levels prompt injection detection to reduce false positive rates (#6390) Add ML-based prompt injection detection (#5623) docs: update custom extensions tutorial (#6388) fix ResultsFormat error when loading old sessions (#6385) docs: add MCP Apps tutorial and documentation updates (#6384) changed z-index to make sure the search highlighter does not appear on modal overlay (#6386) Handling special claude model response in github copilot provider (#6369) fix: prevent duplicate rendering when tool returns both mcp-ui and mcp-apps resources (#6378) fix: update MCP Apps _meta.ui.resourceUri to use nested format (SEP-1865) (#6372) feat(providers): add streaming support for Google Gemini provider (#6191) Blog: edit links in mcp apps post (#6371) fix: prevent infinite loop of tool-input notifications in MCP Apps (#6374)
michaelneale
added a commit
that referenced
this pull request
Jan 8, 2026
* main: (31 commits) added validation and debug for invalid call tool result (#6368) Update MCP apps tutorial: fix _meta structure and version prereq (#6404) Fixed fonts (#6389) Update confidence levels prompt injection detection to reduce false positive rates (#6390) Add ML-based prompt injection detection (#5623) docs: update custom extensions tutorial (#6388) fix ResultsFormat error when loading old sessions (#6385) docs: add MCP Apps tutorial and documentation updates (#6384) changed z-index to make sure the search highlighter does not appear on modal overlay (#6386) Handling special claude model response in github copilot provider (#6369) fix: prevent duplicate rendering when tool returns both mcp-ui and mcp-apps resources (#6378) fix: update MCP Apps _meta.ui.resourceUri to use nested format (SEP-1865) (#6372) feat(providers): add streaming support for Google Gemini provider (#6191) Blog: edit links in mcp apps post (#6371) fix: prevent infinite loop of tool-input notifications in MCP Apps (#6374) fix: Show platform-specific keyboard shortcuts in UI (#6323) fix: we load extensions when agent starts so don't do it up front (#6350) docs: credit HumanLayer in RPI tutorial (#6365) Blog: Goose Lands MCP Apps (#6172) Claude 3.7 is out. we had some harcoded stuff (#6197) ...
wpfleger96
added a commit
that referenced
this pull request
Jan 9, 2026
* main: (89 commits) fix(google): treat signed text as regular content in streaming (#6400) Add frameDomains and baseUriDomains CSP support for MCP Apps (#6399) fix(ci): add missing dependencies to openapi-schema-check job (#6367) feat: http proxy support Add support for changing working dir and extensions in same window/session (#6057) Sort keys in canonical models (#6403) added validation and debug for invalid call tool result (#6368) Update MCP apps tutorial: fix _meta structure and version prereq (#6404) Fixed fonts (#6389) Update confidence levels prompt injection detection to reduce false positive rates (#6390) Add ML-based prompt injection detection (#5623) docs: update custom extensions tutorial (#6388) fix ResultsFormat error when loading old sessions (#6385) docs: add MCP Apps tutorial and documentation updates (#6384) changed z-index to make sure the search highlighter does not appear on modal overlay (#6386) Handling special claude model response in github copilot provider (#6369) fix: prevent duplicate rendering when tool returns both mcp-ui and mcp-apps resources (#6378) fix: update MCP Apps _meta.ui.resourceUri to use nested format (SEP-1865) (#6372) feat(providers): add streaming support for Google Gemini provider (#6191) Blog: edit links in mcp apps post (#6371) ...
wpfleger96
added a commit
that referenced
this pull request
Jan 9, 2026
* main: (89 commits) fix(google): treat signed text as regular content in streaming (#6400) Add frameDomains and baseUriDomains CSP support for MCP Apps (#6399) fix(ci): add missing dependencies to openapi-schema-check job (#6367) feat: http proxy support Add support for changing working dir and extensions in same window/session (#6057) Sort keys in canonical models (#6403) added validation and debug for invalid call tool result (#6368) Update MCP apps tutorial: fix _meta structure and version prereq (#6404) Fixed fonts (#6389) Update confidence levels prompt injection detection to reduce false positive rates (#6390) Add ML-based prompt injection detection (#5623) docs: update custom extensions tutorial (#6388) fix ResultsFormat error when loading old sessions (#6385) docs: add MCP Apps tutorial and documentation updates (#6384) changed z-index to make sure the search highlighter does not appear on modal overlay (#6386) Handling special claude model response in github copilot provider (#6369) fix: prevent duplicate rendering when tool returns both mcp-ui and mcp-apps resources (#6378) fix: update MCP Apps _meta.ui.resourceUri to use nested format (SEP-1865) (#6372) feat(providers): add streaming support for Google Gemini provider (#6191) Blog: edit links in mcp apps post (#6371) ...
fbalicchia
pushed a commit
to fbalicchia/goose
that referenced
this pull request
Jan 13, 2026
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
This PR adds a new tutorial for building MCP Apps and updates documentation to properly link and reference MCP Apps throughout the docs.
Changes
New Content
documentation/docs/tutorials/building-mcp-apps.md- Step-by-step tutorial for building interactive MCP Apps with JavaScript/Node.jsexamples/mcp-app-demo/- Working example MCP App server with interactive UI (counter + message sender)Documentation Updates
docs/guides/interactive-chat/index.mdx- Added cards for MCP Apps tutorial and blog post, updated heading to "Rich Interactive Chat with MCP Apps and MCP-UI"docs/guides/interactive-chat/_category_.json- Updated sidebar label to "MCP Apps and MCP-UI"docs/guides/interactive-chat/mcp-ui.md- Added transition admonition noting MCP Apps is now the official specdocs/tutorials/custom-extensions.md- Streamlined MCP Apps section in Advanced Featuresdocs/getting-started/using-extensions.md- Added link to MCP Apps tutorial in Developing ExtensionsNotes
Testing