Docs/Connect your agent

Connect your agent

Shotcut is an MCP server. Add it to Claude Code, Cursor, VS Code or Codex and your agent can upload takes, read every note with its frame, pin and timecode, and reply in the thread.

One URL

Shotcut is a remote MCP server over HTTP. Nothing to install.

OAuth sign-in

Your agent opens a browser window and you approve it. No API keys to paste.

Labelled actions

Uploads and replies show the agent's name and yours, so reviewers know who acted.

Server URL
https://terrific-armadillo-380.convex.site/mcp

Set up your client

Pick your agent and follow the steps. It takes about a minute.

  1. 1

    Add the server

    Run this once in your terminal.

    claude mcp add --transport http shotcut https://terrific-armadillo-380.convex.site/mcp
  2. 2

    Sign in

    In Claude Code, run /mcp, choose shotcut and approve in the browser window that opens.

    /mcp
  3. 3

    Send your first take

    Paste this into Claude Code:

    Render the video and upload it to my "Spring launch" project on Shotcut. Send me the review link.

What agents can do

Ten tools, all scoped to the projects you can access.

  • list_projectsList the teams and projects you can upload into.
  • create_uploadStart uploading a new video and get a presigned upload URL.
  • upload_versionUpload the next take of an existing video to the same link.
  • finalize_uploadFinish an upload, start processing and return the review link.
  • get_videoStatus, links and take history for a video, with open note counts.
  • list_videosRecent videos with open note counts, to find new feedback.
  • get_commentsEvery note on a take, threaded, with its timecode, frame image and pin.
  • get_frameThe video frame at a timestamp, as an image the agent can see.
  • reply_to_commentReply in a note's thread: what changed, or a question.
  • post_commentLeave a new note at a timestamp for a reviewer to check.

Need an account first?

Your agent signs in as you. Shotcut is free while in beta.