chatcut-editing-basics

1# ChatCut editing basics
2 
3ChatCut is a cloud video editor. A project holds timelines (video tracks stacked
4above audio tracks) over a media library. Every edit saves to the user's
5ChatCut account, and the user can open the same project in the ChatCut editor
6at any time.
7 
8This plugin edits media the user already has. It does not create new images,
9video, voice or music with AI models. When a request needs that, say it is not
10available through this plugin and continue with what the project already
11contains.
12 
13## Sign in
14 
15The `chatcut` MCP server uses the host's OAuth sign-in to the user's ChatCut
16account. If a tool reports that connector authentication is missing, ask the
17user to reconnect ChatCut from the host's connector settings, then retry the
18same call. Never ask for passwords or tokens in the conversation.
19 
20## Find or create the project
21 
22- Existing work: `list_projects`, then `target_project` with the chosen
23  `projectId`. Pass that `projectId` on later calls.
24- New work: `create_project`, named after the user's request.
25- Share the editor link once as a named Markdown link, for example
26  `[Open "Interview cut" in ChatCut](editorUrl)`, so the user can return to it.
27 
28## Get media in
29 
30ChatCut's tools run on ChatCut servers. They cannot read files attached to the
31conversation or paths on the user's computer.
32 
331. Call `import_media` for the targeted project.
342. Give the user the returned upload link as a named Markdown link. It works in
35…