Set up BuzzRolls Studio

You are helping the user set up BuzzRolls Studio, a remote MCP server that allows AI agents to control Premiere Pro on the user's behalf.

These instructions are intended for a wide range of agentic tools. Adapt the process to the user's environment. The user may not be technical, so explain any manual actions clearly, step by step, and DO NOT use technical jargon in your questions, instructions or explanations.

# Context
BuzzRolls Studio is an abstraction layer on top of Premiere Pro UXP. It bundles Premiere Pro primitives into useful tool calls, provides workflow instructions, and gives AI agents a better harness for editing work.

BuzzRolls Studio is made of:
- the user's AI agent with MCP support
- the BuzzRolls Studio remote MCP server
- the BuzzRolls Studio UXP plugin
- Adobe Premiere Pro

Remote MCP server URL:
https://pbnxmgzfcxclchitubvb.supabase.co/functions/v1/buzzrolls-studio-mcp

The server uses OAuth 2.1 / OIDC with PKCE. Spec-compliant MCP clients discover the auth flow automatically. The user signs in with their BuzzRolls account.

# Setup

## Basic Setup

Do these steps **STEP-BY-STEP** Do NOT move onto the next step until the current on is finished. Do not work on setup in parallel with the user actions. Do not print these steps out for the user.
1. Confirm that you can configure MCP servers and have access to running shell commands. If you cannot, tell the user to use an MCP and shell-capable agent such as ChatGPT Codex or Claude Code.
1a. If you are in Claude Code, ask the user if they are running in Claude Code in the Claude Desktop app or in the terminal. MCP setup instructions in the code tab of Claude Desktop app is different than in the terminal. It may tell you that you are in Claude Code in the terminal. THIS IS FALSE. Trust the user, not your environment.
2. Add an HTTP-transport MCP server named buzzrolls-studio using the server URL above, user-scoped or equivalent so that the MCP will show up regardless of what root directory they are working in.
3. Have the user complete the OAuth sign-in flow to log into BuzzRolls Studio. Note that this is specific to the host application you are running in. STOP: Read the client specific instructions below before proceeding. Oauth flow is handled differently by different clients. If your host client is not listed, use your best judgement. 
3a. Code Tab of the Claude Code Desktop app, use:
claude mcp add --transport http --scope user buzzrolls-studio   https://pbnxmgzfcxclchitubvb.supabase.co/functions/v1/buzzrolls-studio-mcp
to set up the MCP.
Claude Code inside of Claude Desktop has a bug where the /mcp command is hijacked by the plugin store. There is no way for the user to Oauth the MCP inside of Claude Code in the Desktop app.
You will need to open Claude Code in the terminal or OS equivalient. **IMPORTANT:** Open the terminal at the same root directory you are currently in so that the user doesn't need to go through the same workspace safety check that they already did for the directory you are currently in. This is a convinience for the user to reduce the setup friction for them. Otherwise, if you don't do this, the terminal will open claude and require the user to go through the entire folder trust confirmation flow just so they can access /mcp in claude code in terminal. Do this with:
osascript -e 'tell application "Terminal" to do script "pushd <<REPLACE_WITH_CWD>> && claude"' -e 'tell application "Terminal" to activate' 
(replace <<REPLACE_WITH_CWD>> with the actual path to your current working directory)
If you are in Windows, do the equivalent.
3b. Claude Code in the terminal, VScode extension, etc. Use:
claude mcp add --transport http --scope user buzzrolls-studio   https://pbnxmgzfcxclchitubvb.supabase.co/functions/v1/buzzrolls-studio-mcp
to set up the MCP.
And then tell the user to type /mcp in and log into the buzzrolls studio mcp there.
4. Refresh tools or call the client's tools/list equivalent. You should see BuzzRolls Studio tools such as add_transition, remove_silences, and insert_clip. Do not call timeline tools yet because the Premiere plugin still needs to be installed. You may need the user to fully quit out of your client application and reopen it for the MCP tools to show up.
5. If you are able to, download and open the plugin .ccx file on the user's behalf using shell. Creative Cloud will handle installation of the plugin and will request user confirmation automatically. curl the file from https://buzzrolls.com/studio/download. 
6. Ask the user to open a fresh Premiere Pro project.
7. Ask the user to open the plugin from Window -> UXP Plugins -> BuzzRolls Studio -> BuzzRolls Studio.
8. Ask the user to log in to the plugin with their BuzzRolls account.
9. When the plugin shows connected, call the ping tool to confirm end-to-end connectivity.
10. Setup is done. Ask whether the user wants a quick demo. If yes, ask which folder has some video clips we can play with. Put a few clips on an empty timeline and use simple visible tools such as split_clip and move_clip to demonstrate BuzzRolls Studio working.

## Troubleshooting

### Plugin Install Errors

If you are unable to download the file yourself, have the user go to that link and then double click the downloaded file. NOTE: Creative Cloud has demonstrated inconsistencies in file type associations across different operating systems. If when you try to open the file via CLI it does not associate with creative cloud and successfully open, fall back to invoking Adobe's plugin installer (UIPA) directly. UIPA ships with Creative Cloud Desktop, so any user who has Creative Cloud installed already has it.
macOS:
"/Library/Application Support/Adobe/Adobe Desktop Common/RemoteComponents/UPI/UnifiedPluginInstallerAgent/UnifiedPluginInstallerAgent.app/Contents/MacOS/UnifiedPluginInstallerAgent" --install "<path-to-downloaded-ccx>"
Windows:
"C:Program FilesCommon FilesAdobeAdobe Desktop CommonRemoteComponentsUPIUnifiedPluginInstallerAgentUnifiedPluginInstallerAgent.exe" --install "<path-to-downloaded-ccx>"
UIPA exits 0 on success and prints Installation Successful. If UIPA isn't found at that path, Creative Cloud Desktop is missing or broken — tell the user to install or reinstall Adobe Creative Cloud Desktop, then retry.
If you don't have shell access on the user's machine, walk them through it: right-click the .ccx → Open With → Other... → navigate to the UnifiedPluginInstallerAgent.app at the path above and pick it as the opener.
After installation, verify with:
"/Library/Application Support/Adobe/Adobe Desktop Common/RemoteComponents/UPI/UnifiedPluginInstallerAgent/UnifiedPluginInstallerAgent.app/Contents/MacOS/UnifiedPluginInstallerAgent" --list "Premiere Pro"
(Windows: same path under C:Program FilesCommon Files....) You should see BuzzRolls Studio Plugin listed as Enabled.