# Connect your agent

Your own AI agent (Claude, Codex, or any app that speaks MCP) can read your StoryCut projects and propose changes: a Short cut from your main video, a rewritten section, a sketch for a story panel. It never changes anything itself. You preview each proposal in place in StoryCut and accept all of it, some of its changes, or none.

## Make an agent token

1. Open **Connected agents** from your account, or **Connect an agent…** from a project's menu, which starts with that project.
2. Give the token a label you'll recognize, like "Claude on my laptop".
3. Choose what it reaches: **only one project**, or **all your projects in this organization** (only then can your agent propose new projects).
4. Choose how long it works: 1 hour, 1 day, 7 days, 30 days or 90 days. None lasts forever.
5. Choose **Create token**.

StoryCut shows the token once and doesn't keep it, so connect your agent before you choose **Done**. Anyone with the token can read what it reaches until it expires or you revoke it.

## Connect it

StoryCut gives you two ways, each with the token in it:

- **Ask your agent to connect.** Copy the message and paste it into a conversation with your agent. It tells the agent how to add StoryCut to itself, and to check the connection by listing your projects.
- **Run in a terminal,** for Claude Code: a `claude mcp add` command that adds StoryCut as an MCP server.

Any other MCP app needs a streamable HTTP server at `https://www.storycut.xyz/api/v1/mcp`, with the header `Authorization: Bearer` and your token.

## What your agent can do

- **Read** the projects its token reaches: timelines, sections, story beats and tracks, story panels, recordings with their clips and markers, filming plans, research boards, and the transcripts of your takes.
- **Propose** changes, made of the same operations as your own edits. Each proposal has a link that opens it previewed in StoryCut, where you edit it, accept what you want, or ask your agent to revise it.
- **Read these docs,** with its `read_docs` tool, so it can answer how-to questions in StoryCut's own words.

Your footage never reaches your agent: it stays on your computer, and your agent works on the structure, the words, the timings, sketches and transcripts.

## Revoke a token

On **Connected agents**, revoke a token whenever you like. Its agent can't read or propose anything after that, and the proposals it already made stay for you to review. A token also stops working when it expires, or if you leave the organization.