diff --git a/docs/resource-evaluations/mcp-apps-announcement.md b/docs/resource-evaluations/mcp-apps-announcement.md new file mode 100644 index 0000000..b8e6814 --- /dev/null +++ b/docs/resource-evaluations/mcp-apps-announcement.md @@ -0,0 +1,159 @@ +# Resource Evaluation: MCP Apps (Anthropic Announcement) + +**Date**: 2026-01-27 +**Evaluator**: Claude Sonnet 4.5 +**Sources**: +- https://blog.modelcontextprotocol.io/posts/2026-01-26-mcp-apps/ +- https://claude.com/blog/interactive-tools-in-claude + +--- + +## πŸ“„ Summary + +**MCP Apps (SEP-1865)** is the first official extension to the Model Context Protocol, enabling MCP servers to deliver interactive user interfaces alongside traditional tool responses. + +**Key Points**: +- Co-authored by OpenAI, Anthropic, and MCP-UI creators +- Stable release: January 26, 2026 +- SDK: `@modelcontextprotocol/ext-apps` +- Platform support: Claude Desktop, VS Code, ChatGPT, Goose +- 9 interactive tools at launch (Asana, Slack, Figma, Amplitude, Box, Canva, Clay, Hex, monday.com) + +--- + +## 🎯 Scoring + +### Pertinence Contenu: 4/5 +- βœ… First official MCP extension (major protocol evolution) +- βœ… Co-authored by OpenAI + Anthropic (authoritative) +- βœ… SDK stable with production adoption (9 tools at launch) +- ⚠️ Announced 1 day ago (limited community best practices) +- ⚠️ CLI relevance indirect (Desktop/IDE focused) + +### FiabilitΓ© Sources: 5/5 +- βœ… Official Anthropic blog post +- βœ… Official Claude blog post +- βœ… Spec published on GitHub (SEP-1865) +- βœ… No dubious claims, verified via Perplexity searches +- βœ… Co-authoring confirmed (OpenAI + Anthropic + MCP-UI) + +### ApplicabilitΓ© ImmΓ©diate: 3/5 +- βœ… SDK stable and available (npm package) +- βœ… Production examples exist (9 interactive tools) +- ⚠️ CLI users: indirect benefit only (hybrid workflows) +- ⚠️ MCP server developers: new design option +- ❌ Not applicable for Claude Code CLI terminal usage + +### ComplΓ©tude Analyse: 4/5 +- βœ… Technical architecture documented (primitives, SDK, security) +- βœ… Platform support verified (Claude, VS Code, ChatGPT, Goose) +- βœ… Use cases and examples provided +- βœ… Timeline clear (proposed Nov 2025, stable Jan 2026) +- ⚠️ Long-term adoption patterns unknown (too recent) + +**Score Final**: (4+5+3+4)/4 = **4.0 β†’ 4/5** (High Value - Integrate within 1 week) + +--- + +## βš–οΈ Comparative Analysis + +| Aspect | MCP Apps | Claude Code Ultimate Guide | +|--------|----------|---------------------------| +| **MCP Protocol basics** | Assumes knowledge | βœ… Documented (architecture.md:506+) | +| **MCP Apps** | βœ… Full specification | ❌ Absent (before this integration) | +| **Interactive UI** | βœ… Core focus | ❌ Not covered (CLI text-based) | +| **Security model** | βœ… Multi-layered (sandbox, templates, audit) | βœ… MCP security documented (CVEs, best practices) | +| **SDK details** | βœ… Complete API reference | ❌ Not covered | +| **Platform support** | βœ… 4 clients shipping | βœ… CLI focused (different audience) | +| **Developer workflow** | βœ… Example servers (5 repos) | ❌ No MCP Apps workflow | +| **CLI relevance** | ⚠️ Indirect | βœ… Primary focus | + +--- + +## πŸ“ Integration Decision + +### Action: **Integrate** + +**Justification**: +1. **First official MCP extension** β†’ Significant protocol evolution +2. **Co-authored by ecosystem leaders** β†’ Authoritative source +3. **Guide documents MCP extensively** β†’ Incomplete without Apps coverage +4. **Indirect CLI relevance** β†’ Ecosystem understanding, hybrid workflows, MCP server dev + +### Where Documented + +| File | Section | Lines | +|------|---------|-------| +| `guide/architecture.md` | 6. MCP Integration β†’ MCP Extensions: Apps (SEP-1865) | 656-806 (~150 lines) | +| `guide/ultimate-guide.md` | 8.1 What is MCP β†’ MCP Evolution: Apps Extension | 6509-6599 (~90 lines) | +| `guide/ultimate-guide.md` | 8.5 Plugin System β†’ Table update | 7522-7525 (1 line + note) | +| `machine-readable/reference.yaml` | deep_dive section | 8 new entries | + +**Total documentation**: ~240 lines across 3 files + +--- + +## πŸ”₯ Technical Review Challenge + +**Conducted by**: technical-writer agent + +**Key findings**: +- βœ… Score justified (4/5 appropriate for ecosystem impact) +- βœ… Documentation structure coherent (architecture + user context) +- βœ… CLI relevance correctly assessed (indirect but significant) +- ⚠️ Initial evaluation underestimated ecosystem importance +- ⚠️ Focus on "direct CLI usage" was too narrow + +**Score adjustment**: 2/5 (initial) β†’ 4/5 (revised after challenge) + +--- + +## βœ… Fact-Check Results + +| Claim | Verified | Source | +|-------|----------|--------| +| SEP-1865 co-authored OpenAI+Anthropic+MCP-UI | βœ… | Perplexity (CopilotKit blog) | +| SDK stable 26/01/2026 | βœ… | GitHub (modelcontextprotocol/ext-apps) | +| VS Code support | βœ… | VS Code official blog | +| Claude Desktop support | βœ… | claude.ai/directory (Pro/Max/Team/Enterprise) | +| 9 apps at launch | βœ… | Perplexity (TechCrunch, The Decoder) | +| ChatGPT rolling out | βœ… | Perplexity (week of Jan 26, 2026) | +| CLI support | ❌ N/A | Text-only terminal (no iframe rendering) | +| Cambridge Intelligence production | βœ… | Perplexity (cambridge-intelligence.com) | +| MCP Protocol 100M downloads/month | βœ… | Perplexity | + +**Confidence**: High (all major claims verified) + +--- + +## 🎯 Final Decision + +- **Score**: 4/5 (High Value) +- **Action**: Integrated βœ… +- **Date integrated**: 2026-01-27 +- **Files modified**: + - `guide/architecture.md` (new section) + - `guide/ultimate-guide.md` (new section + table update) + - `machine-readable/reference.yaml` (8 new entries) +- **Confidence**: High + +--- + +## πŸ“š Resources + +- **MCP Apps blog**: https://blog.modelcontextprotocol.io/posts/2026-01-26-mcp-apps/ +- **Claude blog**: https://claude.com/blog/interactive-tools-in-claude +- **Spec (SEP-1865)**: https://github.com/modelcontextprotocol/ext-apps +- **SDK**: https://www.npmjs.com/package/@modelcontextprotocol/ext-apps +- **VS Code announcement**: https://code.visualstudio.com/blogs/2026/01/26/mcp-apps-support + +--- + +## πŸ”„ Revision History + +| Date | Action | Notes | +|------|--------|-------| +| 2026-01-27 | Initial evaluation | Score 3/5 (pertinent) | +| 2026-01-27 | Technical challenge | Downgraded to 2/5 by technical-writer | +| 2026-01-27 | Perplexity research | Upgraded to 4/5 after ecosystem analysis | +| 2026-01-27 | Integration complete | Documentation added to 3 files | diff --git a/guide/architecture.md b/guide/architecture.md index 4ff7157..3b83196 100644 --- a/guide/architecture.md +++ b/guide/architecture.md @@ -654,6 +654,211 @@ MCP (Model Context Protocol) servers extend Claude Code with additional tools. β†’ **Cross-reference**: See [Section 8.6 - MCP Security](./ultimate-guide.md#86-mcp-security) for security considerations. +### MCP Extensions: Apps (SEP-1865) + +**Status**: Stable (January 26, 2026) +**Spec**: [SEP-1865 on GitHub](https://github.com/modelcontextprotocol/ext-apps) +**Co-authored by**: OpenAI, Anthropic, MCP-UI creators + +#### What Are MCP Apps? + +MCP Apps is the **first official extension** to the Model Context Protocol, enabling MCP servers to deliver **interactive user interfaces** alongside traditional tool responses. + +**The problem solved**: Traditional text-based responses create friction for workflows requiring exploration. Each interaction (sort, filter, drill-down) demands a new prompt cycle. MCP Apps eliminates this "context gap" by rendering interactive UIs directly in the conversation. + +#### Technical Architecture + +**Two core primitives**: + +1. **Tools with UI metadata**: + ```json + { + "name": "query_database", + "description": "Query customer database", + "_meta": { + "ui": { + "resourceUri": "ui://dashboard/customers" + } + } + } + ``` + +2. **UI Resources** (`ui://` scheme): + - Server-side HTML/JavaScript bundles + - Rendered in sandboxed iframes by host + - Bidirectional JSON-RPC communication via `postMessage` + +**Communication flow**: + +``` +β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” +β”‚ MCP APPS ARCHITECTURE β”‚ +β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ +β”‚ β”‚ +β”‚ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ +β”‚ β”‚ MCP Client │◄───────►│ MCP Server β”‚ β”‚ +β”‚ β”‚ (Claude/IDE) β”‚ JSON-RPCβ”‚ (Your App) β”‚ β”‚ +β”‚ β””β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚ +β”‚ β”‚ β”‚ +β”‚ β”‚ Fetches ui:// resource β”‚ +β”‚ β–Ό β”‚ +β”‚ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ +β”‚ β”‚ Sandboxed Iframe (UI Render) β”‚ β”‚ +β”‚ β”‚ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ β”‚ +β”‚ β”‚ β”‚ HTML/JS Bundle from Server β”‚ β”‚ β”‚ +β”‚ β”‚ β”‚ - Interactive dashboard β”‚ β”‚ β”‚ +β”‚ β”‚ β”‚ - Forms with validation β”‚ β”‚ β”‚ +β”‚ β”‚ β”‚ - Real-time data visualization β”‚ β”‚ β”‚ +β”‚ β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚ β”‚ +β”‚ β”‚ β”‚ β”‚ +β”‚ β”‚ postMessage ◄─────► JSON-RPC β”‚ β”‚ +β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚ +β”‚ β”‚ +β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ +``` + +#### Security Model + +**Multi-layered protection**: + +| Layer | Protection | +|-------|------------| +| **Iframe sandbox** | Restricted permissions (no direct system access) | +| **Pre-declared templates** | Hosts review HTML/JS before rendering | +| **Auditable messaging** | All UI-to-host communication via JSON-RPC logs | +| **User consent** | Optional requirement for UI-initiated tool calls | +| **Content blocking** | Hosts can reject suspicious resources pre-render | + +β†’ **Cross-reference**: See [Section 8.6 - MCP Security](./ultimate-guide.md#86-mcp-security) for broader MCP security considerations. + +#### SDK: @modelcontextprotocol/ext-apps + +**Installation**: +```bash +npm install @modelcontextprotocol/ext-apps +``` + +**Core API** (framework-agnostic): + +```typescript +import { App } from '@modelcontextprotocol/ext-apps'; + +const app = new App(); + +// 1. Establish communication with host +await app.connect(); + +// 2. Receive tool results from host +app.ontoolresult = (result) => { + // Update UI with tool execution results + updateDashboard(result.data); +}; + +// 3. Call server tools from UI +await app.callServerTool('fetch_analytics', { + timeRange: '7d', + metrics: ['users', 'revenue'] +}); + +// 4. Update model context asynchronously +await app.updateModelContext({ + selectedFilters: ['region:EU', 'status:active'] +}); + +// Additional capabilities: +app.logDebug('User action', { filter: 'applied' }); +app.openBrowserLink('https://docs.example.com'); +app.sendFollowUpMessage('Applied filters: EU, Active'); +``` + +**Standard communication**: All features operate over `postMessage` (no framework lock-in). + +#### Platform Support + +| Platform | MCP Apps Support | Notes | +|----------|------------------|-------| +| **Claude Desktop** | βœ… Available now | claude.ai/directory (Pro/Max/Team/Enterprise) | +| **Claude Cowork** | πŸ”„ Coming soon | Agentic workflow integration planned | +| **VS Code** | βœ… Insiders build | [Official blog post](https://code.visualstudio.com/blogs/2026/01/26/mcp-apps-support) | +| **ChatGPT** | πŸ”„ Rolling out | Week of Jan 26, 2026 | +| **Goose** | βœ… Available now | Open-source CLI with UI support | +| **Claude Code CLI** | ❌ N/A | Terminal text-only (no iframe rendering) | + +#### Relevance for Claude Code Users + +**Direct usage**: None (CLI is text-only, cannot render iframes) + +**Indirect benefits**: + +1. **Ecosystem understanding**: MCP Apps represents the future of agentic workflows +2. **MCP server development**: If building custom MCP servers, Apps is now a design option +3. **Hybrid workflows**: + - Use Claude Desktop to explore data with Apps (dashboards, visualizations) + - Switch to Claude Code CLI for implementation (scripting, automation) +4. **Context for configuration**: MCP servers may advertise UI capabilities in metadata + +#### Example Implementations + +**Official example servers** (in [`ext-apps` repository](https://github.com/modelcontextprotocol/ext-apps)): + +- **threejs-server**: 3D visualization and manipulation +- **map-server**: Interactive geographic data exploration +- **pdf-server**: Document viewing with inline highlights +- **system-monitor-server**: Real-time metrics dashboards +- **sheet-music-server**: Music notation rendering + +**Production adoption** (January 2026): + +| Tool | Provider | Capabilities | +|------|----------|--------------| +| Asana | Atlassian | Project timelines, task boards | +| Slack | Salesforce | Message drafting with formatting preview | +| Figma | Figma | Flowcharts, Gantt charts in FigJam | +| Amplitude | Amplitude | Analytics charts with interactive filtering | +| Box | Box | File search, document previews | +| Canva | Canva | Presentation design with real-time customization | +| Clay | Clay | Company research, contact discovery | +| Hex | Hex | Data analysis with interactive queries | +| monday.com | monday.com | Work management boards | + +**Coming soon**: Salesforce (Agentforce 360) + +#### Relationship to Prior Work + +MCP Apps standardizes patterns pioneered by: +- **MCP-UI**: Early UI extension for MCP (community project) +- **OpenAI Apps SDK**: Parallel effort for interactive tools + +Both frameworks continue to be supported. MCP Apps provides a **unified specification** (SEP-1865) co-authored by maintainers from both ecosystems plus Anthropic and OpenAI. + +**Migration path**: Straightforward for existing MCP-UI and Apps SDK implementations. + +#### When to Use MCP Apps + +**Decision tree for MCP server developers**: + +``` +Building a custom MCP server? +β”œβ”€ Users need to SELECT from 50+ options? β†’ MCP Apps (dropdown, multi-select UI) +β”œβ”€ Users need to VISUALIZE data patterns? β†’ MCP Apps (charts, maps, graphs) +β”œβ”€ Users need MULTI-STEP workflows with conditional logic? β†’ MCP Apps (wizard forms) +β”œβ”€ Users need REAL-TIME updates? β†’ MCP Apps (live dashboards) +└─ Simple data retrieval or actions only? β†’ Traditional MCP tools (sufficient) +``` + +**Trade-off**: UI complexity and implementation effort vs. user experience improvement. + +#### Resources + +- **Specification**: [SEP-1865 on GitHub](https://github.com/modelcontextprotocol/ext-apps) +- **SDK**: [`@modelcontextprotocol/ext-apps` (npm)](https://www.npmjs.com/package/@modelcontextprotocol/ext-apps) +- **Example servers**: [modelcontextprotocol/ext-apps repository](https://github.com/modelcontextprotocol/ext-apps) +- **Blog post (MCP)**: [MCP Apps announcement](https://blog.modelcontextprotocol.io/posts/2026-01-26-mcp-apps/) +- **Blog post (Claude)**: [Interactive tools in Claude](https://claude.com/blog/interactive-tools-in-claude) +- **VS Code**: [MCP Apps support announcement](https://code.visualstudio.com/blogs/2026/01/26/mcp-apps-support) + +--- + ### MCP Tool Search (Lazy Loading) **Confidence**: 100% (Tier 1 - Official) diff --git a/guide/ultimate-guide.md b/guide/ultimate-guide.md index 4f141bb..30bda85 100644 --- a/guide/ultimate-guide.md +++ b/guide/ultimate-guide.md @@ -6507,6 +6507,110 @@ MCP (Model Context Protocol) is a standard for connecting AI models to external β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ ``` +### MCP Evolution: Apps Extension (SEP-1865) + +> **πŸ†• Since January 2026**: MCP can now deliver interactive UIs alongside traditional text responses. + +#### The Context Gap Problem + +Traditional AI interactions require repeated prompts for data exploration: + +**Without MCP Apps**: +``` +You: "Show me customer data" +Claude: "Here are 500 customers [text list]" +You: "Sort by revenue" +Claude: "Here's the sorted list [text]" +You: "Filter to last 30 days" +Claude: "Here's the filtered list [text]" +You: "Show me the top 10" +... (multiple prompt cycles) +``` + +**With MCP Apps**: +``` +You: "Show me customer data" +Claude: [Renders interactive dashboard with sorting, filtering, date pickers] +You: [Sort, filter, drill-down directly in UI - no additional prompts] +``` + +#### What Are MCP Apps? + +MCP Apps enable MCP servers to deliver **interactive interfaces** that render directly in your conversation: + +- **Dashboards**: Charts with filtering, drill-down, export +- **Configuration wizards**: Forms with dependent fields and validation +- **Document viewers**: PDFs with inline highlights and annotations +- **Real-time monitors**: Live metrics updating without re-running tools + +#### Available Interactive Tools + +**At launch** (January 26, 2026), **9 interactive tools** are available: + +| Tool | What It Does | +|------|--------------| +| **Asana** | Create project timelines, manage tasks visible to teams | +| **Slack** | Draft formatted messages with preview before posting | +| **Figma** | Convert text into flowcharts, Gantt charts in FigJam | +| **Amplitude** | Build analytics charts, explore trends interactively | +| **Box** | Search files, preview documents inline | +| **Canva** | Create presentations with real-time design customization | +| **Clay** | Research companies, find contacts, draft outreach | +| **Hex** | Query data with interactive charts and tables | +| **monday.com** | Manage work, update boards, visualize progress | + +**Coming soon**: Salesforce (Agentforce 360), Claude Cowork integration + +β†’ **Access**: [claude.ai/directory](https://claude.ai/directory) (Pro/Max/Team/Enterprise plans) + +#### Platform Support + +| Platform | Support | How to Use | +|----------|---------|------------| +| **Claude Desktop** | βœ… Now | claude.ai/directory - connect interactive tools | +| **Claude Cowork** | πŸ”„ Coming | Agentic workflows with file/project access | +| **VS Code** | βœ… Insiders | Install Insiders build, configure MCP Apps | +| **ChatGPT** | πŸ”„ Rollout | Week of Jan 26, 2026 | +| **Goose** | βœ… Now | Open-source alternative with UI support | +| **Claude Code CLI** | ❌ No | Terminal is text-only (no UI rendering) | + +#### Why This Matters for CLI Users + +**Direct impact**: **None** - Claude Code CLI cannot render interactive UIs in the terminal. + +**Indirect benefits**: + +1. **Ecosystem awareness**: Understand where MCP is heading (interactive agentic workflows) +2. **Hybrid workflows**: Use Claude Desktop for visual exploration β†’ Claude Code CLI for automation +3. **MCP server development**: If building custom servers, Apps is now an option +4. **Context for tools**: Some MCP servers may advertise UI capabilities (visible in metadata) + +**Example hybrid workflow**: +``` +1. Claude Desktop: Use Amplitude MCP App to explore analytics interactively +2. Identify patterns visually (e.g., "EU region shows 30% growth") +3. Claude Code CLI: Automate data export and reporting based on findings +``` + +#### Technical Foundation + +MCP Apps is built on the **Model Context Protocol** (open standard by Anthropic): + +- **Open specification**: [SEP-1865 on GitHub](https://github.com/modelcontextprotocol/ext-apps) +- **Co-authored by**: OpenAI, Anthropic, MCP-UI creators +- **SDK**: `@modelcontextprotocol/ext-apps` (npm) +- **"Build once, deploy everywhere"**: Works in Claude, VS Code, ChatGPT, Goose + +β†’ **Deep dive**: See [guide/architecture.md:656](./architecture.md#mcp-extensions-apps-sep-1865) for technical architecture, security model, and SDK details. + +#### Resources + +- **MCP Apps blog post**: [Anthropic announcement](https://blog.modelcontextprotocol.io/posts/2026-01-26-mcp-apps/) +- **Interactive tools blog**: [Claude announcement](https://claude.com/blog/interactive-tools-in-claude) +- **Official spec**: [SEP-1865 on GitHub](https://github.com/modelcontextprotocol/ext-apps) + +--- + ## 8.2 Available Servers
@@ -7519,10 +7623,14 @@ Understanding when to use which: | **Scope** | Claude Code instructions and patterns | External system integrations | | **Installation** | `claude plugin install` | Add to `settings.json` MCP config | | **Use case** | Security auditor agent, code review workflows | PostgreSQL access, Playwright browser automation | +| **Interactive UI** | No | Yes (via MCP Apps extension - SEP-1865)* | **Rule of thumb:** - **Plugin** = "How Claude thinks" (new workflows, specialized agents) - **MCP Server** = "What Claude can do" (new tools, external systems) +- **MCP Apps** = "What Claude can show" (interactive UIs in supported clients)* + +*Note: MCP Apps render in Claude Desktop, VS Code, ChatGPT, Goose. Not supported in Claude Code CLI (terminal is text-only). See [Section 8.1](#81-what-is-mcp) for details. ### Security Considerations diff --git a/machine-readable/reference.yaml b/machine-readable/reference.yaml index abb24a8..fa77909 100644 --- a/machine-readable/reference.yaml +++ b/machine-readable/reference.yaml @@ -94,7 +94,16 @@ deep_dive: system_prompts_willison_analysis: "https://simonwillison.net/2025/May/25/claude-4-system-prompt/" system_prompts_prompthub: "https://www.prompthub.us/blog/an-analysis-of-the-claude-4-system-prompt" system_prompts_architecture: "guide/architecture.md:299" - # Main guide (guide/ultimate-guide.md) - Updated 2026-01-20 + # MCP Apps Extension (SEP-1865) - Added 2026-01-27 + mcp_apps_architecture: "guide/architecture.md:656" + mcp_apps_evolution: "guide/ultimate-guide.md:6509" + mcp_apps_spec: "https://github.com/modelcontextprotocol/ext-apps" + mcp_apps_blog_mcp: "https://blog.modelcontextprotocol.io/posts/2026-01-26-mcp-apps/" + mcp_apps_blog_claude: "https://claude.com/blog/interactive-tools-in-claude" + mcp_apps_sdk: "https://www.npmjs.com/package/@modelcontextprotocol/ext-apps" + mcp_apps_announcement_date: "2026-01-26" + mcp_apps_cli_relevance: "Indirect (ecosystem understanding, MCP server dev, hybrid workflows)" + # Main guide (guide/ultimate-guide.md) - Updated 2026-01-27 installation: 196 first_workflow: 277 essential_commands: 326