Set up Blackmagic’s official Resolve MCP with Claude, Codex, or ChatGPT desktop, then pair it with Aspect.
Blackmagic Design includes a native MCP server with DaVinci Resolve Studio 21.1. It runs on the computer with Resolve and exposes the application’s scripting API to an AI assistant. This guide covers that bundled server, rather than a separately maintained community server.Blackmagic documents File → Setup AI Assistants in the Resolve 21.1 reference manual, in “Using DaVinci Resolve with AI Assistants.” Download Studio through Blackmagic’s support center.
Connect from the File menu
Install DaVinci Resolve Studio 21.1 or later and the desktop assistant you intend to use on the same computer. You can connect them from Resolve without opening a terminal.
1
Open Setup AI Assistants
Open Resolve, click File in the top menu, and choose Setup AI Assistants… near the bottom of the dropdown.
Choose Setup AI Assistants from Resolve's File menu.
2
Check the configured assistants
Read the AI Assistants Configured confirmation to see which assistants Resolve found. The list depends on what is installed on your computer. This example includes Codex in ChatGPT.If Claude Desktop opens an extension installer, finish that installation too.
Resolve lists the assistants it configured and asks you to restart them.
3
Restart and check the connection
Click OK, then quit and reopen the assistant you want to use. Open the intended Resolve project and ask: “Tell me the name of my open Resolve project and how many timelines it contains. Do not change anything yet.”Confirm that it identifies the right project before asking for an edit.
The sections below cover individual client settings and terminal setup. Use them if your assistant is not configured by the File menu option, or when managing a connection manually.
Local scripting settings
For a local scripting connection, check Preferences → System → General → External scripting and use Local when required. You do not need to open network scripting for an assistant running on the same computer. Keep Automatic scripted actions at Allow safe unless a specific workflow requires something else.The available setup targets depend on the installed Resolve and client versions.
Claude Desktop
Use Resolve’s setup command first. If you need to install the bundled extension manually, open Claude → Settings → Extensions → Advanced settings → Install Extension and select Blackmagic’s DaVinciResolve.mcpb file.On a standard macOS installation, it is at:
This package is authored by Blackmagic Design and starts the ResolveMCP executable from the installed Studio application. It uses Claude Desktop’s extension runtime; it does not require installing a third-party Python MCP project. See Claude’s local-extension instructions.
Terminal setup for Codex and Claude Code
The native executable speaks MCP over standard input and output, usually called STDIO. Configure it as a local command with no server arguments.
Check the actual installation path, especially on Windows if you chose another drive. These are filesystem paths, not HTTP server URLs.For Codex on macOS:
codex mcp add davinci_resolve -- "/Applications/DaVinci Resolve/DaVinci Resolve.app/Contents/Applications/ResolveMCP"codex mcp list
For Claude Code on macOS:
claude mcp add --transport stdio --scope user davinci_resolve -- "/Applications/DaVinci Resolve/DaVinci Resolve.app/Contents/Applications/ResolveMCP"claude mcp list
Use the matching executable path for your operating system. If the connection already exists, inspect or edit it rather than adding a duplicate. Start a fresh session after setup. The native binary uses Resolve’s bundled runtime; a separate Python installation and legacy PYTHONPATH configuration are not needed for this connection.See the current Codex MCP configuration and Claude Code MCP documentation.
ChatGPT desktop
In the ChatGPT desktop app, open Settings → MCP servers → Add server. Choose STDIO, name the connection davinci_resolve, and enter the full executable path from the table above. Leave arguments empty, save, and restart the connection.Use a conversation that has access to the local computer and its MCP tools. Confirm that get_resolve_status is available before asking for an edit. OpenAI’s MCP guide describes the shared local-host configuration and current surface support.
ChatGPT web does not read this computer’s MCP configuration. A cloud-only chat cannot launch a local ResolveMCP executable from its path. Use a supported desktop/local-computer workflow for Resolve, or an explicitly configured private connection for your environment. Aspect’s remote MCP and Resolve’s local MCP are separate connections.
Verify the connection before editing
Start with this request:
Use the Resolve MCP to report whether Resolve is running and its version.Read the available scripting API for project and timeline inspection.Tell me whether a project is open and how many timelines it contains.Do not create or change a project yet.
The server provides get_resolve_status, get_whats_new, search_scripting_api, get_scripting_api, and get_scripting_docs. If Resolve is closed, launch_resolve can start it. Let the application finish opening before inspecting a project.For an agent using run_script, this is a read-only example after discovering the relevant API:
result = { "version": resolve.GetVersionString(), "project_open": project is not None, "timeline_count": project.GetTimelineCount() if project else 0,}
resolve and project are provided by the server. Assign result to return structured data. This example was checked with the official server on macOS and Resolve Studio 21.1.0.17. That check confirms the connection and read-only scripting, rather than every editing operation on every platform.
How the agent performs an edit
The official server exposes a small set of general tools. Most editing work goes through run_script after the agent discovers the current scripting API. It does not need a separate MCP tool for every timeline operation.For example, the API includes MediaPool.AppendToTimeline, MediaPool.RelinkClips, and MediaPoolItem.LinkProxyMedia. Have the agent inspect the current signatures before writing a script. Some interface actions may not have a scripting equivalent.Ask for a named working timeline and specific changes, then inspect the result in Resolve. Start with a short assembly or a few clips before applying a long batch of edits. A successful script call should be followed by a check that the intended clips, ranges, and tracks actually changed.run_script has access to Resolve but blocks general filesystem, network, and process operations. It can still change a project. run_script_unsafe adds system access and is unnecessary for ordinary API-only inspection or timeline operations. Keep file transfers in the Aspect CLI and use the narrower script tool when it can do the job.
Pair Resolve with Aspect
Connect Aspect MCP to the same assistant and install the Aspect CLI. The two servers handle different parts of the work:
Aspect MCP finds relevant footage, transcript passages, scene descriptions, and review notes.
Aspect supplies proxy files and originals through the mounted project. The CLI starts pins and reports their state.
Resolve MCP turns those local media paths and selected ranges into editing operations in Resolve.
After pinning completes, Resolve uses the originals for finishing. Aspect can hold the review render and its feedback.
Follow Agentic Video Editing for the complete folder-copy, proxy, pinning, and relink workflow.
Use Aspect MCP to find the interview selects for this brief and recordsource paths and time ranges. Read the Aspect workflow for Resolve.Prepare compatible proxies on the mount and start pinning the originals.In Resolve, create a new working timeline and assemble a short first pass.Check proxy matches and report any offline clips. Before final delivery,verify original pins are synced and confirm the timeline uses originals.
Common setup problems
Setup AI Assistants is missing: check that this is the Studio edition and a version with the bundled MCP server.
The server starts but Resolve cannot be reached: open Resolve fully, check local scripting access, and restart the connection.
Tools are absent after installation: restart the AI client and inspect its server list. Check whether workspace settings allow local extensions or MCP servers.
The agent uses old scripting methods: ask it to read the installed API through search_scripting_api or get_scripting_api before retrying.
Media is offline: confirm the mount path exists on the editing computer. An aspect:// address identifies a cloud location; Resolve imports the corresponding filesystem path from the mount.
⌘I
{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"Aspect","description":"Set up Aspect, upload and mount shared media, work with your video editor, and automate workflows with the CLI, MCP server, and API.","colors":{"primary":"#EE6FF7","light":"#F39BFA","dark":"#A62DB3"},"logo":{"light":"https://mintcdn.com/aspect-7de5ca94/xmUmLcgC8F5EMvyb/logo/light.svg?fit=max\u0026auto=format\u0026n=xmUmLcgC8F5EMvyb\u0026q=85\u0026s=03760fb650bf9889ae5a108369bc0f84","dark":"https://mintcdn.com/aspect-7de5ca94/xmUmLcgC8F5EMvyb/logo/dark.svg?fit=max\u0026auto=format\u0026n=xmUmLcgC8F5EMvyb\u0026q=85\u0026s=0862721361a00b21318e0d4196a71957"},"favicon":"https://mintcdn.com/aspect-7de5ca94/xmUmLcgC8F5EMvyb/favicon.ico?fit=max\u0026auto=format\u0026n=xmUmLcgC8F5EMvyb\u0026q=85\u0026s=b2f7b670ccd5ab19b830d059adfef644","appearance":{"default":"light","strict":true},"background":{"color":{"light":"#FFFFFF","dark":"#0A0A0C"}},"navbar":{"links":[{"icon":{"style":"brands","name":"discord"},"href":"https://discord.gg/NGca2AjGvM","label":"Discord community"}]},"footer":{"socials":{"github":"https://github.com/aspect-hq","linkedin":"https://www.linkedin.com/company/aspectinc","x":"https://x.com/aspectinc_","instagram":"https://www.instagram.com/aspectratioinc","youtube":"https://www.youtube.com/@Aspect-Inc"}},"search":{"prompt":"Search documentation..."},"seo":{"metatags":{"twitter:site":"@aspectinc_"},"organization":{"id":"https://aspect.inc/#organization","name":"Aspect","legalName":"Aspect Ratio, Inc.","url":"https://aspect.inc","logo":"https://aspect.inc/favicon-512.png","sameAs":["https://www.linkedin.com/company/aspectinc","https://x.com/aspectinc_","https://www.instagram.com/aspectratioinc/","https://www.youtube.com/@Aspect-Inc"]}},"fonts":{"heading":{"family":"Geist","weight":500},"body":{"family":"Geist","weight":400}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"YouTube tutorials","icon":{"style":"brands","name":"youtube"},"href":"https://www.youtube.com/@Aspect-Inc"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"aspect-7de5ca94","hasAudioNarration":false,"actualSubdomain":"aspect-7de5ca94","customDomains":["aspect.inc"],"gitSource":{"type":"github","owner":"aspect-hq","repo":"aspect-platform","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6afce7ce95c23b69d00f073f","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":103},{"language":"default","tag":"API Endpoints","count":99},{"language":"default","tag":"Platform","count":39},{"language":"default","tag":"FAQs","count":16},{"language":"default","tag":"CLI","count":15},{"language":"default","tag":"Workflows","count":13},{"language":"default","tag":"Assets","count":12},{"language":"default","tag":"Workspaces","count":11},{"language":"default","tag":"Metadata","count":10},{"language":"default","tag":"Collections","count":9}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"@font-face{font-family:\"JetBrains Mono\";font-style:normal;font-weight:100 800;font-display:swap;src:url(\"/fonts/jetbrains-mono-latin.woff2\") format(\"woff2\")}html:root{--content-width: 40rem;--gray-50: 248 248 250;--gray-100: 232 232 238;--gray-200: 216 216 224;--gray-300: 192 192 206;--gray-400: 149 149 168;--gray-500: 111 111 136;--gray-600: 75 75 100;--gray-700: 56 56 80;--gray-800: 36 36 60;--gray-900: 28 28 52;--gray-950: 15 15 38;--font-family-mono-custom: \"JetBrains Mono\", ui-monospace, monospace}[data-layout-item=\"search-entry\"]{display:none}.nav-anchor[href=\"https://www.youtube.com/@Aspect-Inc\"]{flex-direction:row-reverse;justify-content:space-between;gap:0.75rem;min-height:2.75rem;margin:0 0.5rem;padding:0.25rem 0.875rem;border:1px solid rgb(var(--gray-200));border-radius:0.75rem;background-color:#ffffff;color:rgb(var(--gray-700));font-size:0.875rem;font-weight:500;line-height:1.5rem;text-wrap:balance;text-decoration:none}.nav-anchor[href=\"https://www.youtube.com/@Aspect-Inc\"]:hover{border-color:rgb(var(--gray-300));background-color:rgb(var(--gray-50));color:rgb(var(--gray-950))}.nav-anchor[href=\"https://www.youtube.com/@Aspect-Inc\"]:focus-visible{outline:2px solid rgb(var(--primary));outline-offset:3px}.nav-anchor[href=\"https://www.youtube.com/@Aspect-Inc\"]>svg{flex:none;width:1.25rem;height:1.25rem;background-color:#ff0000}@media (min-width: 64rem){#navigation-items{top:0}#navigation-items>[data-component-part=\"scroll-area-viewport\"]{padding-top:0.5rem}#navigation-items .nav-anchors+div{margin-top:1.5rem}.nav-anchor[href=\"https://www.youtube.com/@Aspect-Inc\"]{min-height:2.25rem}#navbar div:has(>a>.nav-logo){flex:0 0 calc(16.5rem - 1.75rem - 1rem)}#navbar div:has(>div>div>.nav-tabs),#navbar div:has(>div>.nav-tabs){flex:1;min-width:0;margin-left:0}#navbar div:has(>div>.nav-tabs)>nav{margin-left:auto}#navbar .nav-tabs{align-items:center;gap:0.25rem}#navbar .nav-tabs-item{height:2.25rem;padding:0 0.875rem;border-radius:0.625rem;color:rgb(var(--gray-600));white-space:nowrap}#navbar .nav-tabs-item:hover{color:rgb(var(--gray-950))}#navbar .nav-tabs-item[data-active=\"true\"]{background-color:#ffffff;color:rgb(var(--gray-950))}#navbar .nav-tabs-item:focus-visible{outline:2px solid rgb(var(--primary));outline-offset:2px}}#content-container{border-color:rgb(var(--gray-100))}#footer a[href^=\"https://www.mintlify.com?utm_campaign=poweredBy\"]{display:none}#page-title{color:rgb(var(--gray-950));font-weight:500;letter-spacing:-0.045em;line-height:1.05}#content :is(h2,h3,h4){color:rgb(var(--gray-950));font-weight:600;letter-spacing:-0.01em;line-height:1.05}#content a.link{color:rgb(var(--primary-dark));text-decoration:none;border-bottom:0;padding-bottom:0.15em;background-image:radial-gradient(circle, currentColor 0.75px, transparent 0.85px);background-size:5px 4px;background-position:0 100%;background-repeat:repeat-x;-webkit-box-decoration-break:clone;box-decoration-break:clone;transition:color 150ms ease, background-position 150ms ease}.dark #content a.link{color:rgb(var(--primary-light))}#content a.link:active{background-position:0 calc(100% - 0.1em)}@media (prefers-reduced-motion: reduce){#content a.link{transition:none}}@media (forced-colors: active){#content a.link{background-image:none;text-decoration:underline dotted;text-decoration-thickness:1.5px;text-underline-offset:0.2em}}code,pre,kbd,samp,.font-mono{font-family:var(--font-family-mono-custom)}#content :not(pre)>code{word-break:normal;overflow-wrap:normal}::selection{color:#ffffff;background-color:#000000}"}]}
{"page":{"pagePath":"mcp/davinci-resolve","slug":"/mcp/davinci-resolve","pageMetadata":{"title":"Connect DaVinci Resolve","description":"Set up Blackmagic's official Resolve MCP with Claude, Codex, or ChatGPT desktop, then pair it with Aspect.","og:title":"Use DaVinci Resolve MCP with Aspect","href":"/mcp/davinci-resolve"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Set up Blackmagic’s official Resolve MCP with Claude, Codex, or ChatGPT desktop, then pair it with Aspect.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Frame,Heading,Note,OptimizedImage,Step,Steps,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Blackmagic Design includes a native MCP server with `,_jsx(_components.strong,{children:`DaVinci Resolve Studio 21.1`}),`. It runs on the computer with Resolve and exposes the application’s scripting API to an AI assistant. This guide covers that bundled server, rather than a separately maintained community server.`]}),`\n`,_jsxs(_components.p,{children:[`Blackmagic documents `,_jsx(_components.strong,{children:`File → Setup AI Assistants`}),` in the `,_jsx(_components.a,{href:`https://documents.blackmagicdesign.com/UserManuals/DaVinci_Resolve_21.1_Reference_Manual.pdf`,children:`Resolve 21.1 reference manual`}),`, in “Using DaVinci Resolve with AI Assistants.” Download Studio through `,_jsx(_components.a,{href:`https://www.blackmagicdesign.com/support/family/davinci-resolve-and-fusion`,children:`Blackmagic’s support center`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`connect-from-the-file-menu`,children:`Connect from the File menu`}),`\n`,_jsxs(_components.p,{children:[`Install DaVinci Resolve `,_jsx(_components.strong,{children:`Studio 21.1 or later`}),` and the desktop assistant you intend to use on the same computer. You can connect them from Resolve without opening a terminal.`]}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Open Setup AI Assistants`,children:[_jsxs(_components.p,{children:[`Open Resolve, click `,_jsx(_components.strong,{children:`File`}),` in the top menu, and choose `,_jsx(_components.strong,{children:`Setup AI Assistants…`}),` near the bottom of the dropdown.`]}),_jsx(Frame,{caption:`Choose Setup AI Assistants from Resolve's File menu.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/aspect-7de5ca94/tG142j6y1L41VD2P/images/davinci-resolve/setup-ai-assistants-menu.png?fit=max\u0026auto=format\u0026n=tG142j6y1L41VD2P\u0026q=85\u0026s=084c6245a569460855da02258b95f01c`,alt:`DaVinci Resolve's File menu with Setup AI Assistants near the bottom of the dropdown.`,width:`1195`,height:`1055`,\"data-og-width\":`1195`,\"data-og-height\":`1055`,\"data-path\":`images/davinci-resolve/setup-ai-assistants-menu.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/aspect-7de5ca94/tG142j6y1L41VD2P/images/davinci-resolve/setup-ai-assistants-menu.png?w=280\u0026fit=max\u0026auto=format\u0026n=tG142j6y1L41VD2P\u0026q=85\u0026s=0284ddf61ff6a41185b5db5675241f94 280w, https://mintcdn.com/aspect-7de5ca94/tG142j6y1L41VD2P/images/davinci-resolve/setup-ai-assistants-menu.png?w=560\u0026fit=max\u0026auto=format\u0026n=tG142j6y1L41VD2P\u0026q=85\u0026s=2a64c1116aa297d533939f545cfbd2b8 560w, https://mintcdn.com/aspect-7de5ca94/tG142j6y1L41VD2P/images/davinci-resolve/setup-ai-assistants-menu.png?w=840\u0026fit=max\u0026auto=format\u0026n=tG142j6y1L41VD2P\u0026q=85\u0026s=7a7521c0f28aa1d472c7a3355857acf9 840w, https://mintcdn.com/aspect-7de5ca94/tG142j6y1L41VD2P/images/davinci-resolve/setup-ai-assistants-menu.png?w=1100\u0026fit=max\u0026auto=format\u0026n=tG142j6y1L41VD2P\u0026q=85\u0026s=2d873287e4e2a7dae6c6939d74f3409b 1100w, https://mintcdn.com/aspect-7de5ca94/tG142j6y1L41VD2P/images/davinci-resolve/setup-ai-assistants-menu.png?w=1650\u0026fit=max\u0026auto=format\u0026n=tG142j6y1L41VD2P\u0026q=85\u0026s=0c88ba44c42fecd6f1d78af0420657f1 1650w, https://mintcdn.com/aspect-7de5ca94/tG142j6y1L41VD2P/images/davinci-resolve/setup-ai-assistants-menu.png?w=2500\u0026fit=max\u0026auto=format\u0026n=tG142j6y1L41VD2P\u0026q=85\u0026s=e080998e947c8163227a58a79c6cc028 2500w`})})]}),_jsxs(Step,{title:`Check the configured assistants`,children:[_jsxs(_components.p,{children:[`Read the `,_jsx(_components.strong,{children:`AI Assistants Configured`}),` confirmation to see which assistants Resolve found. The list depends on what is installed on your computer. This example includes `,_jsx(_components.strong,{children:`Codex in ChatGPT`}),`.`]}),_jsxs(_components.p,{children:[`If `,_jsx(_components.strong,{children:`Claude Desktop`}),` opens an extension installer, finish that installation too.`]}),_jsx(Frame,{caption:`Resolve lists the assistants it configured and asks you to restart them.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/aspect-7de5ca94/tG142j6y1L41VD2P/images/davinci-resolve/ai-assistants-configured.png?fit=max\u0026auto=format\u0026n=tG142j6y1L41VD2P\u0026q=85\u0026s=717212b77eac739340578d2f64930f59`,alt:`The AI Assistants Configured dialog showing configured assistants and the instruction to restart them.`,width:`1126`,height:`771`,\"data-og-width\":`1126`,\"data-og-height\":`771`,\"data-path\":`images/davinci-resolve/ai-assistants-configured.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/aspect-7de5ca94/tG142j6y1L41VD2P/images/davinci-resolve/ai-assistants-configured.png?w=280\u0026fit=max\u0026auto=format\u0026n=tG142j6y1L41VD2P\u0026q=85\u0026s=0078bab1e7781744b9b44e7d75d0f524 280w, https://mintcdn.com/aspect-7de5ca94/tG142j6y1L41VD2P/images/davinci-resolve/ai-assistants-configured.png?w=560\u0026fit=max\u0026auto=format\u0026n=tG142j6y1L41VD2P\u0026q=85\u0026s=f59e47e8b4bc60abece051ef86613239 560w, https://mintcdn.com/aspect-7de5ca94/tG142j6y1L41VD2P/images/davinci-resolve/ai-assistants-configured.png?w=840\u0026fit=max\u0026auto=format\u0026n=tG142j6y1L41VD2P\u0026q=85\u0026s=a6c3b5e0f9c1c087ccb49c0c21e14d1a 840w, https://mintcdn.com/aspect-7de5ca94/tG142j6y1L41VD2P/images/davinci-resolve/ai-assistants-configured.png?w=1100\u0026fit=max\u0026auto=format\u0026n=tG142j6y1L41VD2P\u0026q=85\u0026s=1cb31244aae7e81482e7e8dfd13aa14e 1100w, https://mintcdn.com/aspect-7de5ca94/tG142j6y1L41VD2P/images/davinci-resolve/ai-assistants-configured.png?w=1650\u0026fit=max\u0026auto=format\u0026n=tG142j6y1L41VD2P\u0026q=85\u0026s=6cdd8e7898b0cea35054f5a1df783bb1 1650w, https://mintcdn.com/aspect-7de5ca94/tG142j6y1L41VD2P/images/davinci-resolve/ai-assistants-configured.png?w=2500\u0026fit=max\u0026auto=format\u0026n=tG142j6y1L41VD2P\u0026q=85\u0026s=93ee061a438f294c3d0bedab86d38dcc 2500w`})})]}),_jsxs(Step,{title:`Restart and check the connection`,children:[_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`OK`}),`, then quit and reopen the assistant you want to use. Open the intended Resolve project and ask: “Tell me the name of my open Resolve project and how many timelines it contains. Do not change anything yet.”`]}),_jsx(_components.p,{children:`Confirm that it identifies the right project before asking for an edit.`})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`The sections below cover individual client settings and `,_jsx(_components.a,{href:`#terminal-setup-for-codex-and-claude-code`,children:`terminal setup`}),`. Use them if your assistant is not configured by the File menu option, or when managing a connection manually.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`local-scripting-settings`,children:`Local scripting settings`}),`\n`,_jsxs(_components.p,{children:[`For a local scripting connection, check `,_jsx(_components.strong,{children:`Preferences → System → General → External scripting`}),` and use `,_jsx(_components.strong,{children:`Local`}),` when required. You do not need to open network scripting for an assistant running on the same computer. Keep `,_jsx(_components.strong,{children:`Automatic scripted actions`}),` at `,_jsx(_components.strong,{children:`Allow safe`}),` unless a specific workflow requires something else.`]}),`\n`,_jsx(_components.p,{children:`The available setup targets depend on the installed Resolve and client versions.`}),`\n`,_jsx(Heading,{level:`2`,id:`claude-desktop`,children:`Claude Desktop`}),`\n`,_jsxs(_components.p,{children:[`Use Resolve’s setup command first. If you need to install the bundled extension manually, open `,_jsx(_components.strong,{children:`Claude → Settings → Extensions → Advanced settings → Install Extension`}),` and select Blackmagic’s `,_jsx(_components.code,{children:`DaVinciResolve.mcpb`}),` file.`]}),`\n`,_jsx(_components.p,{children:`On a standard macOS installation, it is at:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`/Applications/DaVinci Resolve/DaVinci Resolve.app/Contents/Resources/DaVinciResolve.mcpb`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`This package is authored by Blackmagic Design and starts the `,_jsx(_components.code,{children:`ResolveMCP`}),` executable from the installed Studio application. It uses Claude Desktop’s extension runtime; it does not require installing a third-party Python MCP project. See `,_jsx(_components.a,{href:`https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop`,children:`Claude’s local-extension instructions`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`terminal-setup-for-codex-and-claude-code`,children:`Terminal setup for Codex and Claude Code`}),`\n`,_jsxs(_components.p,{children:[`The native executable speaks MCP over `,_jsx(_components.strong,{children:`standard input and output`}),`, usually called `,_jsx(_components.strong,{children:`STDIO`}),`. Configure it as a local command with no server arguments.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Operating system`}),_jsx(_components.th,{children:`Default executable`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`macOS`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/Applications/DaVinci Resolve/DaVinci Resolve.app/Contents/Applications/ResolveMCP`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Windows`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`C:\\\\Program Files\\\\Blackmagic Design\\\\DaVinci Resolve\\\\ResolveMCP.exe`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Linux`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/opt/resolve/bin/ResolveMCP`})})]})]})]}),`\n`,_jsx(_components.p,{children:`Check the actual installation path, especially on Windows if you chose another drive. These are filesystem paths, not HTTP server URLs.`}),`\n`,_jsx(_components.p,{children:`For Codex on macOS:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`codex`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mcp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` add`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` davinci_resolve`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"/Applications/DaVinci Resolve/DaVinci Resolve.app/Contents/Applications/ResolveMCP\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`codex`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mcp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` list`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`For Claude Code on macOS:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`claude`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mcp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` add`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --transport`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` stdio`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --scope`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` user`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` davinci_resolve`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"/Applications/DaVinci Resolve/DaVinci Resolve.app/Contents/Applications/ResolveMCP\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`claude`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mcp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` list`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Use the matching executable path for your operating system. If the connection already exists, inspect or edit it rather than adding a duplicate. Start a fresh session after setup. The native binary uses Resolve’s bundled runtime; a separate Python installation and legacy `,_jsx(_components.code,{children:`PYTHONPATH`}),` configuration are not needed for this connection.`]}),`\n`,_jsxs(_components.p,{children:[`See the current `,_jsx(_components.a,{href:`https://learn.chatgpt.com/docs/extend/mcp`,children:`Codex MCP configuration`}),` and `,_jsx(_components.a,{href:`https://code.claude.com/docs/en/mcp`,children:`Claude Code MCP documentation`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`chatgpt-desktop`,children:`ChatGPT desktop`}),`\n`,_jsxs(_components.p,{children:[`In the ChatGPT desktop app, open `,_jsx(_components.strong,{children:`Settings → MCP servers → Add server`}),`. Choose `,_jsx(_components.strong,{children:`STDIO`}),`, name the connection `,_jsx(_components.code,{children:`davinci_resolve`}),`, and enter the full executable path from the table above. Leave arguments empty, save, and restart the connection.`]}),`\n`,_jsxs(_components.p,{children:[`Use a conversation that has access to the local computer and its MCP tools. Confirm that `,_jsx(_components.code,{children:`get_resolve_status`}),` is available before asking for an edit. `,_jsx(_components.a,{href:`https://learn.chatgpt.com/docs/extend/mcp`,children:`OpenAI’s MCP guide`}),` describes the shared local-host configuration and current surface support.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`ChatGPT web does not read this computer’s MCP configuration. A cloud-only chat cannot launch a local `,_jsx(_components.code,{children:`ResolveMCP`}),` executable from its path. Use a supported desktop/local-computer workflow for Resolve, or an explicitly configured private connection for your environment. Aspect’s remote MCP and Resolve’s local MCP are separate connections.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`verify-the-connection-before-editing`,children:`Verify the connection before editing`}),`\n`,_jsx(_components.p,{children:`Start with this request:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Use the Resolve MCP to report whether Resolve is running and its version.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Read the available scripting API for project and timeline inspection.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Tell me whether a project is open and how many timelines it contains.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Do not create or change a project yet.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`The server provides `,_jsx(_components.code,{children:`get_resolve_status`}),`, `,_jsx(_components.code,{children:`get_whats_new`}),`, `,_jsx(_components.code,{children:`search_scripting_api`}),`, `,_jsx(_components.code,{children:`get_scripting_api`}),`, and `,_jsx(_components.code,{children:`get_scripting_docs`}),`. If Resolve is closed, `,_jsx(_components.code,{children:`launch_resolve`}),` can start it. Let the application finish opening before inspecting a project.`]}),`\n`,_jsxs(_components.p,{children:[`For an agent using `,_jsx(_components.code,{children:`run_script`}),`, this is a read-only example after discovering the relevant API:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`result `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"version\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: resolve.GetVersionString(),`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"project_open\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: project `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`is`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` not`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` None`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"timeline_count\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: project.GetTimelineCount() `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` project `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`else`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`resolve`}),` and `,_jsx(_components.code,{children:`project`}),` are provided by the server. Assign `,_jsx(_components.code,{children:`result`}),` to return structured data. This example was checked with the official server on macOS and Resolve Studio `,_jsx(_components.strong,{children:`21.1.0.17`}),`. That check confirms the connection and read-only scripting, rather than every editing operation on every platform.`]}),`\n`,_jsx(Heading,{level:`2`,id:`how-the-agent-performs-an-edit`,children:`How the agent performs an edit`}),`\n`,_jsxs(_components.p,{children:[`The official server exposes a small set of general tools. Most editing work goes through `,_jsx(_components.code,{children:`run_script`}),` after the agent discovers the current scripting API. It does not need a separate MCP tool for every timeline operation.`]}),`\n`,_jsxs(_components.p,{children:[`For example, the API includes `,_jsx(_components.code,{children:`MediaPool.AppendToTimeline`}),`, `,_jsx(_components.code,{children:`MediaPool.RelinkClips`}),`, and `,_jsx(_components.code,{children:`MediaPoolItem.LinkProxyMedia`}),`. Have the agent inspect the current signatures before writing a script. Some interface actions may not have a scripting equivalent.`]}),`\n`,_jsx(_components.p,{children:`Ask for a named working timeline and specific changes, then inspect the result in Resolve. Start with a short assembly or a few clips before applying a long batch of edits. A successful script call should be followed by a check that the intended clips, ranges, and tracks actually changed.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`run_script`}),` has access to Resolve but blocks general filesystem, network, and process operations. It can still change a project. `,_jsx(_components.code,{children:`run_script_unsafe`}),` adds system access and is unnecessary for ordinary API-only inspection or timeline operations. Keep file transfers in the Aspect CLI and use the narrower script tool when it can do the job.`]}),`\n`,_jsx(Heading,{level:`2`,id:`pair-resolve-with-aspect`,children:`Pair Resolve with Aspect`}),`\n`,_jsxs(_components.p,{children:[`Connect `,_jsx(_components.a,{href:`/mcp/index`,children:`Aspect MCP`}),` to the same assistant and install the `,_jsx(_components.a,{href:`/cli/installation`,children:`Aspect CLI`}),`. The two servers handle different parts of the work:`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Aspect MCP finds relevant footage, transcript passages, scene descriptions, and review notes.`}),`\n`,_jsx(_components.li,{children:`Aspect supplies proxy files and originals through the mounted project. The CLI starts pins and reports their state.`}),`\n`,_jsx(_components.li,{children:`Resolve MCP turns those local media paths and selected ranges into editing operations in Resolve.`}),`\n`,_jsx(_components.li,{children:`After pinning completes, Resolve uses the originals for finishing. Aspect can hold the review render and its feedback.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Follow `,_jsx(_components.a,{href:`/workflows/agentic-video-editing`,children:`Agentic Video Editing`}),` for the complete folder-copy, proxy, pinning, and relink workflow.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Use Aspect MCP to find the interview selects for this brief and record`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`source paths and time ranges. Read the Aspect workflow for Resolve.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Prepare compatible proxies on the mount and start pinning the originals.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`In Resolve, create a new working timeline and assemble a short first pass.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Check proxy matches and report any offline clips. Before final delivery,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`verify original pins are synced and confirm the timeline uses originals.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`2`,id:`common-setup-problems`,children:`Common setup problems`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Setup AI Assistants is missing:`}),` check that this is the Studio edition and a version with the bundled MCP server.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The server starts but Resolve cannot be reached:`}),` open Resolve fully, check local scripting access, and restart the connection.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Tools are absent after installation:`}),` restart the AI client and inspect its server list. Check whether workspace settings allow local extensions or MCP servers.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The agent uses old scripting methods:`}),` ask it to read the installed API through `,_jsx(_components.code,{children:`search_scripting_api`}),` or `,_jsx(_components.code,{children:`get_scripting_api`}),` before retrying.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Media is offline:`}),` confirm the mount path exists on the editing computer. An `,_jsx(_components.code,{children:`aspect://`}),` address identifies a cloud location; Resolve imports the corresponding filesystem path from the mount.`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Connect DaVinci Resolve","description":"Set up Blackmagic's official Resolve MCP with Claude, Codex, or ChatGPT desktop, then pair it with Aspect.","og:title":"Use DaVinci Resolve MCP with Aspect","href":"/mcp/davinci-resolve"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Connect from the File menu","slug":"connect-from-the-file-menu","depth":2,"children":[]},{"title":"Local scripting settings","slug":"local-scripting-settings","depth":2,"children":[]},{"title":"Claude Desktop","slug":"claude-desktop","depth":2,"children":[]},{"title":"Terminal setup for Codex and Claude Code","slug":"terminal-setup-for-codex-and-claude-code","depth":2,"children":[]},{"title":"ChatGPT desktop","slug":"chatgpt-desktop","depth":2,"children":[]},{"title":"Verify the connection before editing","slug":"verify-the-connection-before-editing","depth":2,"children":[]},{"title":"How the agent performs an edit","slug":"how-the-agent-performs-an-edit","depth":2,"children":[]},{"title":"Pair Resolve with Aspect","slug":"pair-resolve-with-aspect","depth":2,"children":[]},{"title":"Common setup problems","slug":"common-setup-problems","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/aspect-7de5ca94/d6e653a541a6f5f6/support.js","/docs/_mintlify/custom/aspect-7de5ca94/683dfb2a13e5a3bc/default-host-noindex.js","/docs/_mintlify/custom/aspect-7de5ca94/9110cd2679fd46b6/posthog.js"],"subdomain":"aspect-7de5ca94","siteName":"Aspect","title":"Use DaVinci Resolve MCP with Aspect","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-08T00:57:37.334Z","originalFileLocation":"mcp/davinci-resolve.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Set up Blackmagic\u0026#x27;s official Resolve MCP with Claude, Codex, or ChatGPT desktop, then pair it with Aspect.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Aspect\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/aspect-7de5ca94/DwpsuAgLm7KZxAfg/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/aspect-7de5ca94/DwpsuAgLm7KZxAfg/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/aspect-7de5ca94/DwpsuAgLm7KZxAfg/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/aspect-7de5ca94/DwpsuAgLm7KZxAfg/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/aspect-7de5ca94/DwpsuAgLm7KZxAfg/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/aspect-7de5ca94/DwpsuAgLm7KZxAfg/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/aspect-7de5ca94/DwpsuAgLm7KZxAfg/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/aspect-7de5ca94/DwpsuAgLm7KZxAfg/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/aspect-7de5ca94/DwpsuAgLm7KZxAfg/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Use DaVinci Resolve MCP with Aspect\">\u003cmeta data-mint-head property=\"og:description\" content=\"Set up Blackmagic\u0026#x27;s official Resolve MCP with Claude, Codex, or ChatGPT desktop, then pair it with Aspect.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Aspect\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://aspect.inc/docs/mcp/davinci-resolve\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://aspect-7de5ca94.mintlify.site/docs/_mintlify/api/og/v2?division=Editor+integrations\u0026amp;title=Connect+DaVinci+Resolve\u0026amp;description=Set+up+Blackmagic%27s+official+Resolve+MCP+with+Claude%2C+Codex%2C+or+ChatGPT+desktop%2C+then+pair+it+with+Aspect.\u0026amp;theme=5038da6332b3b66c065a2f54\u0026amp;signature=5aab2f1d42da17b7d1ab997dfd74c2c329dd7d5936897f93adc463f251709929\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Use DaVinci Resolve MCP with Aspect\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Set up Blackmagic\u0026#x27;s official Resolve MCP with Claude, Codex, or ChatGPT desktop, then pair it with Aspect.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://aspect-7de5ca94.mintlify.site/docs/_mintlify/api/og/v2?division=Editor+integrations\u0026amp;title=Connect+DaVinci+Resolve\u0026amp;description=Set+up+Blackmagic%27s+official+Resolve+MCP+with+Claude%2C+Codex%2C+or+ChatGPT+desktop%2C+then+pair+it+with+Aspect.\u0026amp;theme=5038da6332b3b66c065a2f54\u0026amp;signature=5aab2f1d42da17b7d1ab997dfd74c2c329dd7d5936897f93adc463f251709929\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/aspect-7de5ca94/DwpsuAgLm7KZxAfg/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Aspect\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#EE6FF7\">\u003clink data-mint-head rel=\"canonical\" href=\"https://aspect.inc/docs/mcp/davinci-resolve\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/mcp/davinci-resolve.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://aspect.inc/#organization\",\"name\":\"Aspect\",\"legalName\":\"Aspect Ratio, Inc.\",\"url\":\"https://aspect.inc\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://aspect.inc/favicon-512.png\"},\"sameAs\":[\"https://www.linkedin.com/company/aspectinc\",\"https://x.com/aspectinc_\",\"https://www.instagram.com/aspectratioinc/\",\"https://www.youtube.com/@Aspect-Inc\"]},{\"@type\":\"WebSite\",\"@id\":\"https://aspect.inc/docs#website\",\"name\":\"Aspect\",\"url\":\"https://aspect.inc/docs\",\"publisher\":{\"@id\":\"https://aspect.inc/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://aspect.inc/docs/mcp/davinci-resolve#webpage\",\"url\":\"https://aspect.inc/docs/mcp/davinci-resolve\",\"name\":\"Connect DaVinci Resolve\",\"description\":\"Set up Blackmagic's official Resolve MCP with Claude, Codex, or ChatGPT desktop, then pair it with Aspect.\",\"dateModified\":\"2026-10-08T00:57:37.334Z\",\"isPartOf\":{\"@id\":\"https://aspect.inc/docs#website\"},\"breadcrumb\":{\"@id\":\"https://aspect.inc/docs/mcp/davinci-resolve#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://aspect.inc/docs/mcp/davinci-resolve#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Aspect\",\"item\":\"https://aspect.inc/docs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Connect DaVinci Resolve\",\"item\":\"https://aspect.inc/docs/mcp/davinci-resolve\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://aspect.inc/docs/mcp/davinci-resolve#article\",\"headline\":\"Connect DaVinci Resolve\",\"name\":\"Connect DaVinci Resolve\",\"description\":\"Set up Blackmagic's official Resolve MCP with Claude, Codex, or ChatGPT desktop, then pair it with Aspect.\",\"url\":\"https://aspect.inc/docs/mcp/davinci-resolve\",\"mainEntityOfPage\":{\"@id\":\"https://aspect.inc/docs/mcp/davinci-resolve#webpage\"},\"dateModified\":\"2026-10-08T00:57:37.334Z\",\"publisher\":{\"@id\":\"https://aspect.inc/#organization\"},\"isPartOf\":{\"@id\":\"https://aspect.inc/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Aspect\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Aspect\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/mcp/davinci-resolve.md","siteName":"Aspect","nav":{"global":{"anchors":[{"anchor":"YouTube tutorials","icon":{"style":"brands","name":"youtube"},"href":"https://www.youtube.com/@Aspect-Inc"}]},"tabs":[{"tab":"Platform","pages":[{"title":"Platform","href":""}]},{"tab":"Workflows","pages":[{"title":"Workflows","href":"/workflows/avid-media-composer"}]},{"tab":"FAQs","pages":[{"title":"FAQs","href":"/faqs/getting-started"}]},{"tab":"CLI","pages":[{"title":"CLI","href":"/cli"}]},{"tab":"MCP","groups":[{"group":"Get started","pages":[{"title":"Aspect MCP","href":"/mcp"},{"title":"Search and organize media","href":"/mcp/search-and-organize"},{"title":"Canvases and generation","description":"Generate images, video, audio, or text with Aspect MCP, connect canvas nodes, and retrieve completed results.","href":"/mcp/canvases-and-generation"}]},{"group":"Editor integrations","pages":[{"title":"Connect DaVinci Resolve","href":"/mcp/davinci-resolve"}]},{"group":"Reference","pages":[{"title":"Tool reference","description":"Find Aspect MCP tools for media search, files, transcripts, canvases, generation, review, and permissions.","href":"/mcp/tools"},{"title":"Troubleshooting","href":"/mcp/troubleshooting"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference"}]}]},"basePath":"","title":"Use DaVinci Resolve MCP with Aspect","deploymentId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","buildId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-BrWhOrIJ.js","DynamicMarkdown-CsgNpZb1.js","zoom-image-lightbox-BVW4Axcm.js","lightbox-handle-r17bVUz3.js"]}