MCP Apps
    Preparing search index...

    Type Alias AppOptions

    AppOptions: ProtocolOptions & {
        allowUnsafeEval?: boolean;
        autoResize?: boolean;
        strict?: boolean;
    }

    Options for configuring App behavior.

    Extends ProtocolOptions from the MCP SDK with App-specific configuration.

    Type Declaration

    • OptionalallowUnsafeEval?: boolean

      Allow code paths that require CSP unsafe-eval (e.g. new Function()).

      Views typically run under a strict CSP without unsafe-eval. Zod's JIT object parser uses new Function() and throws on the first message parse under such a policy. By default (allowUnsafeEval: false) the App constructor sets z.config({ jitless: true }) so the SDK works out of the box under the spec's default CSP. Set allowUnsafeEval: true to skip that and keep the faster JIT path when the host's CSP permits unsafe-eval.

      false
      
    • OptionalautoResize?: boolean

      Automatically report size changes to the host using ResizeObserver.

      When enabled, the App monitors document.body and document.documentElement for size changes and automatically sends ui/notifications/size-changed notifications to the host.

      true
      
    • Optionalstrict?: boolean

      Throw on detected misuse instead of logging a console warning.

      Currently this affects calling host-bound methods (e.g. callServerTool, sendMessage) before connect has completed the ui/initialize handshake. With strict: false (default) a console.warn is emitted; with strict: true an Error is thrown.

      Throwing will become the default in a future release.

      false
      

    ProtocolOptions from @modelcontextprotocol/sdk for inherited options