[{"data":1,"prerenderedAt":502},["ShallowReactive",2],{"navigation_docs":3,"-apps-overview":272,"-apps-overview-surround":497},[4,40,70,99,122,151,184,243],{"title":5,"path":6,"stem":7,"children":8,"page":39},"Getting Started","\u002Fgetting-started","1.getting-started",[9,14,19,24,29,34],{"title":10,"path":11,"stem":12,"icon":13},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction","i-lucide-book-open",{"title":15,"path":16,"stem":17,"icon":18},"Installation","\u002Fgetting-started\u002Finstallation","1.getting-started\u002F2.installation","i-lucide-download",{"title":20,"path":21,"stem":22,"icon":23},"Configuration","\u002Fgetting-started\u002Fconfiguration","1.getting-started\u002F3.configuration","i-lucide-settings",{"title":25,"path":26,"stem":27,"icon":28},"MCP Inspector","\u002Fgetting-started\u002Finspector","1.getting-started\u002F4.inspector","i-lucide-circuit-board",{"title":30,"path":31,"stem":32,"icon":33},"Connection","\u002Fgetting-started\u002Fconnection","1.getting-started\u002F5.connection","i-lucide-plug",{"title":35,"path":36,"stem":37,"icon":38},"Agent Skills","\u002Fgetting-started\u002Fagent-skills","1.getting-started\u002F6.agent-skills","i-lucide-sparkles",false,{"title":41,"path":42,"stem":43,"children":44,"page":39},"Tools","\u002Ftools","2.tools",[45,50,55,60,65],{"title":46,"path":47,"stem":48,"icon":49},"Overview","\u002Ftools\u002Foverview","2.tools\u002F0.overview","i-lucide-wrench",{"title":51,"path":52,"stem":53,"icon":54},"Schema, handler & returns","\u002Ftools\u002Fschema-handler","2.tools\u002F1.schema-handler","i-lucide-braces",{"title":56,"path":57,"stem":58,"icon":59},"Annotations & input examples","\u002Ftools\u002Fannotations","2.tools\u002F2.annotations","i-lucide-badge-info",{"title":61,"path":62,"stem":63,"icon":64},"Errors & caching","\u002Ftools\u002Ferrors-caching","2.tools\u002F3.errors-caching","i-lucide-shield",{"title":66,"path":67,"stem":68,"icon":69},"Groups, files & dynamic registration","\u002Ftools\u002Fgroups-organization","2.tools\u002F4.groups-organization","i-lucide-tags",{"title":71,"path":72,"stem":73,"children":74,"page":39},"Resources","\u002Fresources","3.resources",[75,79,84,89,94],{"title":46,"path":76,"stem":77,"icon":78},"\u002Fresources\u002Foverview","3.resources\u002F0.overview","i-lucide-package",{"title":80,"path":81,"stem":82,"icon":83},"Static resources & structure","\u002Fresources\u002Fstatic-and-structure","3.resources\u002F1.static-and-structure","i-lucide-file-stack",{"title":85,"path":86,"stem":87,"icon":88},"Templates & handlers","\u002Fresources\u002Ftemplates-and-handlers","3.resources\u002F2.templates-and-handlers","i-lucide-git-branch",{"title":90,"path":91,"stem":92,"icon":93},"Metadata, content & errors","\u002Fresources\u002Fcontent-metadata-errors","3.resources\u002F3.content-metadata-errors","i-lucide-layers",{"title":95,"path":96,"stem":97,"icon":98},"Groups & organization","\u002Fresources\u002Forganization","3.resources\u002F4.organization","i-lucide-folder-tree",{"title":100,"path":101,"stem":102,"children":103,"page":39},"Prompts","\u002Fprompts","4.prompts",[104,108,113,117],{"title":46,"path":105,"stem":106,"icon":107},"\u002Fprompts\u002Foverview","4.prompts\u002F0.overview","i-lucide-message-square",{"title":109,"path":110,"stem":111,"icon":112},"Authoring & structure","\u002Fprompts\u002Fauthoring","4.prompts\u002F1.authoring","i-lucide-pen-line",{"title":114,"path":115,"stem":116,"icon":93},"Input, handler & messages","\u002Fprompts\u002Finput-handler-messages","4.prompts\u002F2.input-handler-messages",{"title":118,"path":119,"stem":120,"icon":121},"Patterns & advanced","\u002Fprompts\u002Fpatterns-advanced","4.prompts\u002F3.patterns-advanced","i-lucide-line-chart",{"title":123,"path":124,"stem":125,"children":126,"page":39},"Handlers","\u002Fhandlers","5.handlers",[127,131,136,141,146],{"title":46,"path":128,"stem":129,"icon":130},"\u002Fhandlers\u002Foverview","5.handlers\u002F0.overview","i-lucide-server",{"title":132,"path":133,"stem":134,"icon":135},"Default & custom handlers","\u002Fhandlers\u002Fdefault-and-custom","5.handlers\u002F1.default-and-custom","i-lucide-toggle-left",{"title":137,"path":138,"stem":139,"icon":140},"Structure & options","\u002Fhandlers\u002Fstructure-and-options","5.handlers\u002F2.structure-and-options","i-lucide-sliders-horizontal",{"title":142,"path":143,"stem":144,"icon":145},"Examples & routing","\u002Fhandlers\u002Fexamples-routing","5.handlers\u002F3.examples-routing","i-lucide-route",{"title":147,"path":148,"stem":149,"icon":150},"Sharing & practices","\u002Fhandlers\u002Fsharing-practices","5.handlers\u002F4.sharing-practices","i-lucide-share-2",{"title":152,"path":153,"stem":154,"children":155,"page":39},"Apps","\u002Fapps","6.apps",[156,160,165,170,174,179],{"title":46,"path":157,"stem":158,"icon":159},"\u002Fapps\u002Foverview","6.apps\u002F0.overview","i-lucide-app-window",{"title":161,"path":162,"stem":163,"icon":164},"Authoring & defineMcpApp","\u002Fapps\u002Fauthoring","6.apps\u002F1.authoring","i-lucide-code-2",{"title":166,"path":167,"stem":168,"icon":169},"useMcpApp() bridge","\u002Fapps\u002Fuse-mcp-app","6.apps\u002F2.use-mcp-app","i-lucide-message-circle",{"title":171,"path":172,"stem":173,"icon":64},"CSP & build pipeline","\u002Fapps\u002Fcsp-and-wiring","6.apps\u002F3.csp-and-wiring",{"title":175,"path":176,"stem":177,"icon":178},"Testing & publishing","\u002Fapps\u002Ftesting-publishing","6.apps\u002F4.testing-publishing","i-lucide-rocket",{"title":180,"path":181,"stem":182,"icon":183},"Patterns & limits","\u002Fapps\u002Fpatterns-reference","6.apps\u002F5.patterns-reference","i-lucide-book-marked",{"title":185,"path":186,"stem":187,"children":188,"page":39},"Advanced Topics","\u002Fadvanced","7.advanced",[189,194,199,204,208,213,218,223,228,233,238],{"title":190,"path":191,"stem":192,"icon":193},"Custom Paths","\u002Fadvanced\u002Fcustom-paths","7.advanced\u002F1.custom-paths","i-lucide-folder",{"title":195,"path":196,"stem":197,"icon":198},"Logging","\u002Fadvanced\u002Flogging","7.advanced\u002F10.logging","i-lucide-scroll-text",{"title":200,"path":201,"stem":202,"icon":203},"MCP Apps Internals","\u002Fadvanced\u002Fmcp-apps-internals","7.advanced\u002F11.mcp-apps-internals","i-lucide-cog",{"title":205,"path":206,"stem":207,"icon":64},"Middleware","\u002Fadvanced\u002Fmiddleware","7.advanced\u002F2.middleware",{"title":209,"path":210,"stem":211,"icon":212},"TypeScript","\u002Fadvanced\u002Ftypescript","7.advanced\u002F3.typescript","i-lucide-type",{"title":214,"path":215,"stem":216,"icon":217},"Hooks","\u002Fadvanced\u002Fhooks","7.advanced\u002F4.hooks","i-lucide-webhook",{"title":219,"path":220,"stem":221,"icon":222},"MCP Evals","\u002Fadvanced\u002Fevals","7.advanced\u002F5.evals","i-lucide-flask-conical",{"title":224,"path":225,"stem":226,"icon":227},"Sessions","\u002Fadvanced\u002Fsessions","7.advanced\u002F6.sessions","i-lucide-database",{"title":229,"path":230,"stem":231,"icon":232},"Dynamic Definitions","\u002Fadvanced\u002Fdynamic-definitions","7.advanced\u002F7.dynamic-definitions","i-lucide-toggle-right",{"title":234,"path":235,"stem":236,"icon":237},"Code Mode","\u002Fadvanced\u002Fcode-mode","7.advanced\u002F8.code-mode","i-lucide-code",{"title":239,"path":240,"stem":241,"icon":242},"Elicitation","\u002Fadvanced\u002Felicitation","7.advanced\u002F9.elicitation","i-lucide-message-square-quote",{"title":244,"path":245,"stem":246,"children":247,"page":39},"Examples","\u002Fexamples","8.examples",[248,253,258,263,268],{"title":249,"path":250,"stem":251,"icon":252},"Authentication","\u002Fexamples\u002Fauthentication","8.examples\u002F1.authentication","i-lucide-shield-check",{"title":254,"path":255,"stem":256,"icon":257},"API Integration","\u002Fexamples\u002Fapi-integration","8.examples\u002F2.api-integration","i-lucide-globe",{"title":259,"path":260,"stem":261,"icon":262},"Common Patterns","\u002Fexamples\u002Fcommon-patterns","8.examples\u002F3.common-patterns","i-lucide-lightbulb",{"title":264,"path":265,"stem":266,"icon":267},"File Operations","\u002Fexamples\u002Ffile-operations","8.examples\u002F4.file-operations","i-lucide-file",{"title":269,"path":270,"stem":271,"icon":107},"Prompt Examples","\u002Fexamples\u002Fprompt-examples","8.examples\u002F5.prompt-examples",{"id":273,"title":152,"body":274,"description":480,"extension":481,"links":482,"meta":491,"navigation":492,"path":157,"seo":493,"stem":158,"__hash__":496},"docs\u002F6.apps\u002F0.overview.md",{"type":275,"value":276,"toc":475},"minimark",[277,282,291,319,325,359,418,422,466],[278,279,281],"h2",{"id":280},"what-are-mcp-apps","What are MCP Apps?",[283,284,285,286,290],"p",{},"MCP Apps are ",[287,288,289],"strong",{},"interactive HTML widgets"," returned by an MCP tool and rendered inline by compatible hosts. Instead of streaming back text, your tool ships a small UI that the user can read, scroll, filter, and click — connected back to your server through a typed message bridge.",[283,292,293,294,301,302,306,307,310,311,314,315,318],{},"They follow the ",[295,296,300],"a",{"href":297,"rel":298},"https:\u002F\u002Fmodelcontextprotocol.io",[299],"nofollow","MCP UI proposal (SEP-1865)",": a tool returns a ",[303,304,305],"code",{},"text\u002Fhtml;profile=mcp-app"," resource referenced by ",[303,308,309],{},"ui:\u002F\u002F",", the host loads it inside a sandboxed ",[303,312,313],{},"iframe",", and the iframe talks back over ",[303,316,317],{},"postMessage",".",[283,320,321,324],{},[303,322,323],{},"@nuxtjs\u002Fmcp-toolkit"," makes that authoring experience feel like writing a regular Nuxt page:",[326,327,328,339,350,356],"ul",{},[329,330,331,332,335,336,318],"li",{},"One ",[287,333,334],{},"Vue SFC"," per app in ",[303,337,338],{},"app\u002Fmcp\u002F",[329,340,341,342,345,346,349],{},"A ",[303,343,344],{},"defineMcpApp"," macro inside ",[303,347,348],{},"\u003Cscript setup>"," declares the tool, schema, and server handler.",[329,351,341,352,355],{},[303,353,354],{},"useMcpApp()"," composable gives you reactive data, host context, and a typed bridge to the host.",[329,357,358],{},"The toolkit bundles the SFC into a single self-contained HTML file at build time and serves it from your MCP endpoint.",[360,361,364,367,411],"prompt",{":actions":362,"description":363,"icon":159},"[\"copy\",\"cursor\",\"windsurf\"]","Scaffold a new MCP App (Vue SFC)",[283,365,366],{},"Create a new MCP App in my Nuxt app using @nuxtjs\u002Fmcp-toolkit.",[326,368,369,372,380,383,386,393,396,399,402,405,408],{},[329,370,371],{},"Create a Vue SFC in app\u002Fmcp\u002F (e.g. app\u002Fmcp\u002Fcolor-picker.vue)",[329,373,374,375],{},"Use defineMcpApp({ description, inputSchema, handler }) inside ",[376,377],"script",{"setup":378,"lang":379},"","ts",[329,381,382],{},"inputSchema uses Zod; handler runs server-side and returns { structuredContent }",[329,384,385],{},"handler can call any Nuxt API route via $fetch — keep heavy data work on the server",[329,387,388,389],{},"In the template, call useMcpApp",[390,391,392],"t-payload",{},"() to get { data, loading, hostContext, sendPrompt, callTool, openLink }",[329,394,395],{},"data is hydrated from structuredContent on first render — no extra request",[329,397,398],{},"Use sendPrompt(text) to push a follow-up into the chat that triggers another tool\u002Fapp",[329,400,401],{},"Use callTool(name, params) to re-invoke an MCP tool and refresh data in place",[329,403,404],{},"Use openLink(url) to ask the host to open a URL outside the iframe",[329,406,407],{},"Add CSP allow-lists with csp: { resourceDomains, connectDomains } if you load images or call external APIs",[329,409,410],{},"Make the layout fluid (no fixed heights); hosts often render the iframe inline at variable widths",[283,412,413,414],{},"Docs: ",[295,415,416],{"href":416,"rel":417},"https:\u002F\u002Fmcp-toolkit.nuxt.dev\u002Fapps\u002Foverview",[299],[278,419,421],{"id":420},"guides","Guides",[423,424,425,433,453,460,463],"card-group",{},[426,427,429,430,432],"card",{"color":428,"icon":164,"title":161,"to":162},"neutral","Quick start, ",[303,431,338],{}," layout, the macro, server handler, and shared types.",[426,434,435,438,439,438,442,438,445,448,449,452],{"color":428,"icon":169,"title":166,"to":167},[303,436,437],{},"data",", ",[303,440,441],{},"hostContext",[303,443,444],{},"sendPrompt",[303,446,447],{},"callTool",", and ",[303,450,451],{},"openLink"," inside the iframe.",[426,454,455,456,459],{"color":428,"icon":64,"title":171,"to":172},"Allow-listed domains, ",[303,457,458],{},"openai\u002FwidgetCSP",", and how the HTML bundle is wired.",[426,461,462],{"color":428,"icon":178,"title":175,"to":176},"Local dev, which hosts work, HTTPS deployment, ChatGPT and Claude.",[426,464,465],{"color":428,"icon":183,"title":180,"to":181},"UI patterns, what you cannot do in the iframe, and a compact API table.",[283,467,468,469,471,472,474],{},"The rest of this section assumes you are comfortable with ",[295,470,41],{"href":47}," (Zod, handlers) and have read ",[295,473,30],{"href":31}," for MCP URLs in dev and production.",{"title":378,"searchDepth":476,"depth":476,"links":477},2,[478,479],{"id":280,"depth":476,"text":281},{"id":420,"depth":476,"text":421},"Build interactive UI widgets that AI hosts render alongside chat — written as Vue SFCs, served as MCP UI resources.","md",[483,486,488,490],{"label":484,"icon":164,"to":162,"color":428,"variant":485},"Authoring","subtle",{"label":487,"icon":169,"to":167,"color":428,"variant":485},"useMcpApp bridge",{"label":489,"icon":64,"to":172,"color":428,"variant":485},"CSP & pipeline",{"label":175,"icon":178,"to":176,"color":428,"variant":485},{},{"title":46,"icon":159},{"title":494,"description":495},"MCP Apps","Author MCP UI Apps as Vue Single-File Components. Auto-bundled, served from a real Nuxt endpoint, and rendered inside MCP Apps-compatible hosts.","mH-Vab6-Gye1gkpRcPc1ZAM_TTtAR6mXGcn_VnAqkAE",[498,500],{"title":147,"path":148,"stem":149,"description":499,"icon":150,"children":-1},"Cross-handler tool sharing, file layout, use cases, and next steps.",{"title":161,"path":162,"stem":163,"description":501,"icon":164,"children":-1},"SFC location, quick start, the defineMcpApp macro, server handler, and shared types.",1777306539873]