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

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

Connect your agent

Make an agent token

Open Connected agents from your account, or Connect an agent… from a project's menu, which starts with that project.

Give the token a label you'll recognize, like "Claude on my laptop".

Choose what it reaches: only one project, or all your projects in this organization (only then can your agent propose new projects).

Choose how long it works: 1 hour, 1 day, 7 days, 30 days or 90 days. None lasts forever.

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.