# Build your first story with an assistant

You will connect an assistant to Bitebox and ask it to build a short story. The story plays one clip, shows two choices, and ends on a different clip for each choice. Then you review the story in Canvas and undo a change.

This quickstart uses your own clips, so it runs no models and spends no credits.

## Before you start

You need:

- A Bitebox account that can open Canvas at `canvas.bitebox.gg`.
- An assistant that supports remote MCP servers with sign-in, such as Claude, ChatGPT or Cursor.
- Three short video clips at public `https://` addresses: one opening scene and one clip for each ending. Each file can be up to 64 MB. Portrait 9:16 clips look best on a phone.

## Connect and approve

1. Add Bitebox to your assistant. Follow the steps for your assistant in [Connect an assistant](/docs/mcp/connect).
2. Sign in to Bitebox when your assistant asks.
3. On the consent screen, keep the defaults: **Documents** set to **Read and edit**, **Media** set to **Use and upload**, **Preview** on, and **History** set to **Read version history**.
4. Set **Generate** to **Off**. With generation off, the assistant cannot run models or spend credits.
5. Click **Allow**.

You can add a daily generate budget later with **Edit** on the Canvas MCP tab. The budget limits what the assistant can spend each day; it does not give credits. [Sign-in, consent and access](/docs/mcp/access) explains each setting.

Your assistant keeps its own sign-in. Do not paste a token, a sign-in code or a callback address into the chat.

Ask your assistant to call `workspace_context`. If it answers with what you allowed, you are connected.

## Ask your agent

> Help me build a short Bitebox story called "The door". First, inspect my workspace with workspace_context. Create a new project. Import these three clips: [opening clip link], [first ending link], [second ending link]. Play the opening clip first, then show two choices, "Open the door" and "Walk away", that each lead to one ending clip. Check every path with playthrough_simulate and tell me what each path reaches. Explain the proposed changes and ask before you run a model or publish.

Review the paths your assistant reports before you continue.

The assistant does these steps:

1. It calls `workspace_context` and `project_create`.
2. It calls `media_import_url` once for each clip. Each call answers a hosted Bitebox address for that clip.
3. It calls `scene_add` once for each address. Each call adds one scene that plays that clip. The call for the opening clip also marks that scene as the start.
4. It adds the two choices to the opening clip with `choice_add`. Each choice is wired to its ending.
5. It calls `playthrough_simulate`.

## Check your result

`playthrough_simulate` should report two paths. Each path starts on the opening clip and reaches a different ending. It also names the path a viewer takes when they do not choose, and it lists no dead ends.

To watch the story, ask for a preview link. `preview_url` gives a link that lasts fifteen minutes. It opens your story's play page, as viewers will see it, playing the version you have not published yet. If previews on the play page are not on yet, the link opens the reference player instead.

If the report shows a dead end or a node that no path reaches, ask the assistant to fix that wire and run the check again. If a tool answers with a refusal code, read [Troubleshooting](/docs/mcp/troubleshooting).

## Review and undo in Canvas

1. Open Canvas and open your new project from **My Projects** on your home page.
2. Look at the canvas. The three scenes and the Choice Overlay are there. Play the story to check both choices.
3. Open the Projects menu and select **Earlier versions**. Each change the assistant saved is a separate save in this list.
4. Select a save from before the choices, then select **Restore as new save**. Select **Restore** to confirm. Canvas adds the restored version as a new save. The earlier saves stay in the list. Unsaved canvas edits are not kept.
5. To get the choices back, restore the newer save the same way.

You can also ask the assistant to undo. It lists saves with `document_revisions` and restores one with `document_restore`. A restore never deletes history. [Restore an earlier version](/docs/mcp/build#restore) has the details.

## Next step

Read the [Builder guide](/docs/mcp/build) to add more scenes, generate clips within a daily budget, and prepare your story to publish.

---
Source commit: 9ccaa86d41d7 · Build date: 2026-11-17T03:27:39.423Z
