docs: add MCP Apps tutorial and documentation updates by blackgirlbytes · Pull Request #6384 · block/goose

blackgirlbytes · 2026-01-07T22:32:13Z

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.js
examples/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 spec
docs/tutorials/custom-extensions.md - Streamlined MCP Apps section in Advanced Features
docs/getting-started/using-extensions.md - Added link to MCP Apps tutorial in Developing Extensions

Notes

MCP Apps tutorial includes experimental admonition since the spec is still in draft
MCP-UI continues to be supported but MCP Apps is recommended for new extensions
Example app uses Apple-inspired clean design (no gradients/AI aesthetics)

Testing

Docusaurus builds successfully
All links resolve correctly
Example MCP App runs and renders in goose Desktop

- 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

Copilot

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

Copilot · 2026-01-07T22:36:28Z

examples/mcp-app-demo/README.md

+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


According to the project guidelines, use "goose" (lowercase), not "Goose".

Copilot · 2026-01-07T22:36:29Z

examples/mcp-app-demo/README.md

+
+- [MCP Apps Specification](https://github.com/modelcontextprotocol/ext-apps)
+- [Model Context Protocol](https://modelcontextprotocol.io)
+- [Goose Documentation](https://block.github.io/goose)


According to the project guidelines, use "goose" (lowercase), not "Goose".

goose made this example folder..i dont want that.

examples/mcp-app-demo/index.html

- 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

github-actions · 2026-01-07T22:54:48Z

PR Preview Action v1.6.3
Preview removed because the pull request was closed.
2026-01-07 23:10 UTC

Copilot

Pull request overview

Copilot reviewed 6 out of 6 changed files in this pull request and generated no new comments.

Copilot

Pull request overview

Copilot reviewed 6 out of 6 changed files in this pull request and generated no new comments.

* '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)

* 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) ...

* 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) ...

Copilot AI review requested due to automatic review settings January 7, 2026 22:32

blackgirlbytes requested a review from a team as a code owner January 7, 2026 22:32

Copilot started reviewing on behalf of blackgirlbytes January 7, 2026 22:32 View session

Copilot AI reviewed Jan 7, 2026

View reviewed changes

angiejones approved these changes Jan 7, 2026

View reviewed changes

blackgirlbytes added 2 commits January 7, 2026 17:49

docs: rename MCP-UI page to 'Using MCP Apps and MCP-UI'

72a9a5b

- Update title and sidebar label - Combine intro to cover both MCP Apps and MCP-UI - Streamline content and update admonition - Update developer links section

docs: remove examples/mcp-app-demo folder

10c1df2

Tutorial contains all code inline - separate example folder is redundant

Copilot AI review requested due to automatic review settings January 7, 2026 22:53

Copilot started reviewing on behalf of blackgirlbytes January 7, 2026 22:54 View session

Copilot AI reviewed Jan 7, 2026

View reviewed changes

blackgirlbytes added 2 commits January 7, 2026 17:58

docs: change question to statement in developer section

86b8140

docs: move admonition before video

052a286

Copilot AI review requested due to automatic review settings January 7, 2026 22:59

Copilot started reviewing on behalf of blackgirlbytes January 7, 2026 22:59 View session

Copilot AI reviewed Jan 7, 2026

View reviewed changes

blackgirlbytes merged commit e49079e into main Jan 7, 2026
26 checks passed

blackgirlbytes deleted the docs/mcp-apps-tutorial branch January 7, 2026 23:06

github-actions bot mentioned this pull request Jan 13, 2026

chore(release): release version 1.20.0 (minor) #6457

Merged

fbalicchia pushed a commit to fbalicchia/goose that referenced this pull request Jan 13, 2026

docs: add MCP Apps tutorial and documentation updates (block#6384)

06290ab

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

docs: add MCP Apps tutorial and documentation updates#6384

docs: add MCP Apps tutorial and documentation updates#6384
blackgirlbytes merged 5 commits intomainfrom
docs/mcp-apps-tutorial

blackgirlbytes commented Jan 7, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI Jan 7, 2026

Uh oh!

Copilot AI Jan 7, 2026

Uh oh!

blackgirlbytes Jan 7, 2026

Uh oh!

Uh oh!

github-actions bot commented Jan 7, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

blackgirlbytes commented Jan 7, 2026

Summary

Changes

New Content

Documentation Updates

Notes

Testing

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Key Changes

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI Jan 7, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 7, 2026

Choose a reason for hiding this comment

Uh oh!

blackgirlbytes Jan 7, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

github-actions bot commented Jan 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

github-actions bot commented Jan 7, 2026 •

edited

Loading