MCP connector
Connect Claude, ChatGPT, Codex, or Cursor to VideoDraft over MCP and generate without leaving the chat.
On this page
What the connector is#
VideoDraft runs a remote Model Context Protocol server over streamable HTTP. Point an MCP-capable client at it and that client can generate video, images, voice, music, and 3D, run a hosted production, and read your projects and media, all against your VideoDraft account.
The web app and the connector share one database and one set of generation routes, so anything an agent makes is immediately visible in Studio, and anything you make in Studio is visible to the agent. There is no mirrored state.
This is separate from the bundled CLI inside VideoDraft ADE. The connector reaches the hosted VideoDraft service from any machine and needs no download.
| Setting | Value |
|---|---|
| Connector name | VideoDraft |
| Server URL | https://app.videodraft.ai/api/mcp |
| Transport | Streamable HTTP |
| Auth | OAuth 2.1 with PKCE, or a personal access token |
| Plans | Every plan, Starter included |
Claude and Claude Code#
- 1In the Claude app, open Customize, then Connectors, then Add custom connector.
- 2Enter the name VideoDraft and the server URL above.
- 3Click Connect and finish the VideoDraft sign-in in your browser.
In Claude Code, add the server from your terminal and then run /mcp inside a session to complete the sign-in.
claude mcp add --transport http videodraft https://app.videodraft.ai/api/mcpCodex#
Codex signs in through the browser like the other clients, so there is no token to paste. Add it from the terminal, or in the Codex app open Settings, then MCP servers, then Add server, and enter the name and URL under Streamable HTTP.
codex mcp add VideoDraft --url https://app.videodraft.ai/api/mcpChatGPT and Cursor#
ChatGPT needs Developer mode, under Settings, then Security and login. Add a connector named VideoDraft, set authentication to OAuth, and use the same server URL.
Cursor reads MCP servers from mcp.json. Open the command palette, search for Open MCP settings, and add the entry below, then restart and sign in.
{
"mcpServers": {
"videodraft": { "url": "https://app.videodraft.ai/api/mcp" }
}
}Tokens, for hosts without OAuth#
Every client above signs in through the browser. If a host cannot do OAuth, mint a personal access token instead and send it as a bearer header. Tokens look like vd_mcp_ followed by 43 characters.
claude mcp add --transport http videodraft \
https://app.videodraft.ai/api/mcp \
--header "Authorization: Bearer vd_mcp_…"A token is shown exactly once
Only its SHA-256 hash is stored, so it cannot be recovered later. Create a new one if you lose it.
What your agent can reach#
The connector exposes tools grouped into lanes. A well-behaved agent calls get_tool_catalog for the lane it needs first, which returns that lane’s tools along with the guidance for using them.
| Lane | Covers |
|---|---|
| assets | Images, video, voice, music, sound effects, dialogue, 3D |
| asset_io | Uploads, downloads, and media descriptions |
| projects | Create, read, update, and version projects |
| project_data | Scenes, shots, styles, visual assets, timeline clips |
| production | Hosted production runs and video export |
| library | Media, generation history, characters, products, styles |
| account | Identity, credit balance, model catalogs, per-model costs |
The server also exposes MCP resources, so an agent can browse without spending a tool call.
- videodraft://guidance for the complete agent guidance
- videodraft://schema/project for the project data schema
- videodraft://projects and videodraft://projects/{project_id} for your projects
Credits, sessions, and access#
Generations spend the same credit balance as Studio and the Mac app. There is no separate connector charge and nothing extra to buy.
- Ask your agent to estimate a job before running it and it reports the cost first. Video, shot-image batches, upscales, and avatar renders are the largest spends.
- Generations made without a project land in their own AI Studio session for that connection, so a conversation’s output stays together.
- Access is scoped to your VideoDraft account. Every call is charged to you and constrained to your projects.
- OAuth access lasts 30 days and refreshes automatically. Revoke it, or any token, from Settings then API Keys, where OAuth grants appear as OAuth: <app>.
- Requests are rate limited to 300 per minute per token.
The connector does not cut
It generates, edits, produces, and exports, and it can arrange the clips, order, and durations on a hosted project timeline. Frame-accurate cutting, color against scopes, captions, and mixing happen in VideoDraft Editor inside the Mac app.