BotDojoDocs
Search BotDojo Docs
Search every guide

Try “stop a run,” “connect an app,” or “daily briefing.”

Browse Guides
GuidesWorkspaceBuild and share an app
Guides · Workspace

Build and share an app

Create an HTML Model Context Protocol (MCP) App in a workspace, validate its connection-powered states, and share it as an authenticated artifact.

2 min readLast reviewed July 27, 2026

#Build and validate the workspace app

Preview the workspace HTML file and interact with its visible controls before creating an artifact.
Screenshot previewPreview the workspace HTML file and interact with its visible controls before creating an artifact.
Northstar Logistics workspace HTML app rendered in Preview mode with sample sales data
  1. 01

    Describe the viewer and job

    Tell the agent who will use the app, what decision it supports, and which connection tools it may call.

  2. 02

    Create the HTML file

    Ask the agent to save a self-contained app in Workspace Files.

  3. 03

    Inspect source and Preview

    Review HTML source, then exercise the rendered interface in Preview.

  4. 04

    Test every state

    Confirm loading, success, empty, error, permission-denied, and mutation-confirmation behavior.

#Create and share the artifact

Use authenticated account sharing when an app depends on the viewing user’s connection permissions.
Screenshot previewUse authenticated account sharing when an app depends on the viewing user’s connection permissions.
Share Artifact dialog with the authenticated Acme account sharing option and link
  1. 01

    Create the artifact

    Copy the validated HTML workspace file into a new artifact.

  2. 02

    Choose authenticated sharing

    Use a project or account share when the app needs connection tools.

  3. 03

    Test as the viewer

    Sign in as an intended viewer and confirm their connections and permissions produce the expected result.

  4. 04

    Update deliberately

    After changing the workspace file, update the artifact and repeat the viewer check.

Build MCP AppsAsk the workspace agent to create an HTML app, connect it to permitted tools, validate every state, and prepare it for sharing.ArtifactsBuild, update, view, and share reviewed copies of workspace files, including authenticated Model Context Protocol (MCP) Apps.