Embed an MCP app inside a live Shiny session

When called inside a Shiny server context, this helper auto-registers a live host instance and returns ready-to-render UI. Outside a live session, provide an id and pair the result with mcp_host_server().

Usage

mcp_embed(
  app,
  id = NULL,
  trigger = NULL,
  debounce_ms = NULL,
  height = "auto"
)

Arguments

app

An McpApp object.

id

Optional DOM or module id.

trigger

Interaction mode: "debounce", "change", "submit", or "manual". Defaults to the app's own declaration (mcp_app(trigger = )), falling back to "debounce".

debounce_ms

Debounce interval in milliseconds. Defaults to the app's own declaration, falling back to 250.

height

Preferred initial height.