Hosted MCP

Model Context Protocol (MCP) lets an AI assistant use Sovran tools. The hosted server uses your Sovran sign-in. You do not paste an API key into the client.

Before you connect

Open Developer. Check Connection setup and Actions on that host. Connection setup can be available while API access is paused. Connections can be approved in that state, but cannot run actions. Copy the MCP server URL from Connect an AI assistant. The production URL is https://sovran.ai/api/mcp. A development host has its own URL, account, and connections.

Only workspace owners and admins with an active paid plan can approve a connection. Each connection has one workspace and a fixed permission set. MCP uses the same credits, access rules, release stages, and feature limits as the API.

Connect ChatGPT

Open your ChatGPT profile menu. Select Settings, then Plugins.
Select Browse directory. Select Add, then Add custom MCP server.
Enter Sovran for Name. Paste the MCP server URL into Server URL.
Keep OAuth selected. Select the confirmation checkbox. Select Create as a plugin.
Select Continue to Sovran. Sign in with your Sovran account.
Choose one workspace. Keep Read selected. Select other permissions only when needed.
Select Approve connection. Start a chat with Sovran enabled.

Your ChatGPT plan and workspace settings must permit custom MCP servers. The labels can differ by ChatGPT version.

Connect Claude

Open Claude Settings, then Connectors.
Select Add connector, then Add custom connector.
Enter Sovran for the name. Paste the MCP server URL. Select Continue.
Choose Sign in now and Register automatically.
Select Add. Select Connect.
Sign in with your Sovran account.
Choose one workspace. Keep Read selected. Select other permissions only when needed.
Select Approve connection. Enable the connector in your conversation.

Your Claude plan and workspace settings must permit custom connectors. The labels can differ by Claude version.

Choose permissions

Read reads projects, assets, jobs, usage, and the connected profile. It is required.
Write creates and updates content.
Generate generates media and renders videos. Existing credit charges apply.
Delete deletes content that your account can delete.
Publish publishes through accounts connected in Sovran.

The assistant can find operations with task words such as video editor, batch variations, or sequence videos. It can read the shared request and result rules before a call. The editor descriptor includes field rules and small overlay examples. The assistant must use the call tool for the required permission.

releaseAvailable shows whether the API release stage permits an operation on this host. It does not prove that the connection has access. Permissions, the paid plan, feature flags, and runtime rules still apply.

Ask the assistant to list your projects first. An empty workspace returns an empty list. If a call needs more permissions, Sovran returns the required permissions and an HTTP 403 consent challenge before the action runs. Follow the client's sign-in prompt. If no prompt opens, reconnect Sovran in client settings and approve the required permissions with new consent. An existing token cannot gain new permissions or change its workspace.

Jobs, uploads, and downloads

A job request returns its job ID. The assistant can check that job with the read tool. MCP does not wait for a long render.

Upload operations return the existing signed upload instructions. Download operations return signed URLs. Their expiresAt value is the link expiry. It does not delete the saved video. Read the output again to get a fresh link without a new render. The hosted server cannot read local files. It does not send full media files inside MCP messages. Use the CLI for local file transfers.

Changes require the existing request token that prevents duplicate work. Save it with the exact operation, path, query, and body. Replay that exact request only to read its saved acceptance. A confirmed failed job can use its supported retry operation with a separate saved token. Do not retry automatically.

If a job returns requires_action, read its error and nextAction. When retryAllowed is false, do not submit a new retry. If an export submission is uncertain, contact Sovran support with the job ID. A new request token can create duplicate work.

Manage a connection

Open Developer, then Connections under Connect an AI assistant. Check the client, workspace, permissions, approving user, status, last use, and expiry. Hover over or focus a date to see the full time and time zone.

The approving user must remain a workspace owner or admin. If that user loses the required role, the connection shows Blocked. New requests and token refresh fail. Ask a current workspace owner or admin to reconnect and approve access. You can disconnect the blocked connection.

Select Disconnect, then Confirm disconnect, to block new calls and token refresh. The confirmation moves keyboard focus to Cancel. Select Cancel to keep the connection and return focus to Disconnect. Work already accepted can continue. A connection expires 30 days after approval. Start a new connection when it expires.

If MCP access is closed, connections cannot make requests. You can still disconnect a saved connection. Connect Meta or TikTok in Account settings before publishing.