Integrations
Calling Sume from automation platforms, serverless functions, agent frameworks, and MCP clients. Each uses plain HTTPS or remote MCP, not a connector.
VS Code 1.141 background shells and a long Sume render
VS Code 1.141 tracks background shells for agent sessions. Start a Sume render, keep the job id, and use sume jobs watch instead of repeating the paid create.
VS Code user MCP config: a read-only and a Write Sume profile
VS Code's MCP: Open User Configuration edits per-user servers. Keep OAuth read-only Sume in your everyday setup and an API key entry only where paid jobs run.
VS Code MCP: Reset Trust after you grant Sume the Write scope
Write on Sume's consent page changes the server's abilities, not VS Code's trust decision. MCP: Reset Trust makes VS Code ask again; mcp_health shows scopes.
Perplexity MCP authorization field with Sume: one-hour token
Perplexity passes the authorization value to the MCP server as an access token. A Sume OAuth token lasts one hour with no refresh, so use an API key unattended.
Perplexity Agent API MCP tool: server_label rules for Sume
Perplexity MCP tool: server_label must match ^[a-zA-Z0-9_-]{1,64}$. A Sume entry that passes, with authorization, headers and allowed_tools.
VS Code Settings Sync and MCP servers: keep the Sume key out
VS Code can sync MCP config when the MCP Servers sync option is on. Keep the Sume API key out of the file with an input variable, or use OAuth instead.
Claude Code: local Sume entry vs claude.ai connector, who wins
Claude Code ranks a local Sume MCP entry above a claude.ai connector. That decides whether you get the API key's full tool set or OAuth's read-only one.
MCP tool error or JSON-RPC error: where Sume's failures land
Sume returns tool failures as results with isError true and keeps JSON-RPC errors for protocol faults, per the 2025-11-25 MCP spec. Here is the split.
Claude Code maxResultSizeChars 500,000 vs Sume's 256 KiB output cap
Raising Claude Code's per-tool result limit to 500,000 characters does not change what Sume returns: the server caps one MCP result at 262,144 bytes.
MCP spec: tool annotations are untrusted. What that means for Sume
The MCP spec says clients must treat tool annotations as untrusted unless they come from a trusted server. Treat Sume as trusted only for your own workspace.
MCP spec: token in the header on every request, never the URL
The 2025-11-25 MCP spec forbids access tokens in the URL query string and wants a Bearer header on every request. Keep the Sume key in headers, not the URL.
Does Copilot's MCP policy apply to Pro+ or Max? Sume hosted MCP
GitHub's MCP servers in Copilot policy covers Business and Enterprise, off by default. Free, Pro, Pro+ and Max users can add Sume's hosted MCP server directly.
Sume MCP read_busy 503: four concurrent reads per owner
read_busy is a retryable 503 from Sume's MCP host. Reads inside tools, including jobs_wait polls, are capped at 4 at once per owner, 512 across the host.
Gemini CLI authProviderType: connect Sume with dynamic_discovery
Gemini CLI defaults authProviderType to dynamic_discovery. For Sume that means OAuth discovery, not Google credentials. What each of the three values does.
Devin Desktop ${file:} interpolation for the Sume API key
Devin Desktop expands ${file:/path} and ${env:NAME} in mcp_config.json. Put the Sume API key in a file outside the config; the 100-tool cap still applies.
Cursor mcp.json for Sume: a URL and nothing else
The Cursor entry for hosted Sume MCP is one url field with no key in the file; OAuth sign-in happens in the client and the consent page lives on the MCP host.
Caption a MAI-Voice-2.1 narrated video: script_text keeps spelling
Burn captions on a clip voiced by MAI-Voice-2.1 or Flash: send the video URL and script_text, and Sume times the words. $0.20 for a clip up to 60 seconds.
ENABLE_TOOL_SEARCH=false in Claude Code loads every Sume tool up front
Setting ENABLE_TOOL_SEARCH=false or a custom ANTHROPIC_BASE_URL turns off Claude Code tool search. What that does to a Sume MCP session.
Claude Code tells Claude when an MCP server fails: Sume down vs auth
With tool search on, Claude Code reports failed MCP servers to the model. How to read that when Sume's server will not connect, 401 or 403.
Can GLM-5.3 call Sume's hosted MCP? Function calling, not MCP
Z.ai's GLM-5.3 page lists function calling and does not mention MCP. How a GLM agent reaches Sume through an MCP client or through plain HTTP.
LinkedIn wants a text-only SRT; Sume burns captions, so build one
LinkedIn video ad captions must be a text-only SRT. Sume burns captions into pixels and has no SRT export. Build the file from video-inspect segments.
Kling lists MCP and CLI tools for batch video; Sume's hosted MCP
Kling's home page mentions MCP and CLI tools for batch generation. Sume's hosted MCP at mcp.sume.com has generate_video; its Kling row is kling-3 only.
Codex 0.161: denied reads stay denied, so a Sume upload may fail
Codex 0.161.0 lets approved filesystem escalation widen writes while keeping denied reads. Why a local file upload to Sume can still fail, and how to fix it.
Gemini CLI 0.64 preview moves settings to V2: recheck Sume
The 0.64.0 preview moves settings from V1 to V2. After you upgrade, confirm the Sume hosted MCP server still connects with a free read before any paid call.
Airtable counts failed runs too: a 100-item Sume batch on Free
Airtable counts a run each time a trigger fires, even if actions fail. If each of 100 Sume deliveries triggers one, the Free plan's 100 monthly runs are gone.
n8n test URL or production URL: which goes in a Sume webhook_url
Put the n8n Production URL in Sume's webhook_url. The Test URL only works while the editor is listening, so a holiday batch would burn retries against it.
Sume with Zapier, Make or n8n: no app in the docs, so use HTTP
Sume's docs list no Zapier, Make or n8n app. Start Formats over HTTP, receive results on a webhook_url, and poll as a backup. Limits of each tool.
Claude Code plugin userConfig: prompt for the Sume API key once
A plugin can ask for a sensitive value and reuse it as ${user_config.KEY} in an MCP header. A Sume plugin manifest that keeps the key out of settings.json.
Codex account-scoped MCP grant cleanup and Sume's 1-hour token
Codex 0.161.0 adds account-scoped grant cleanup for enterprise MCP authentication. How that sits with Sume's one-hour OAuth token and its revoke endpoint.
Airtable keeps run history 2 weeks on Free: store your Sume receipts
Airtable run history lasts 2 weeks on Free, 3 years on Enterprise. Save the Sume run id and output URL in the record so a holiday audit does not depend on it.
Airtable Free has no Run a script action: start Sume runs elsewhere
Airtable says Run a script is not available on Free. Start Sume Format runs from a service you control, and let Airtable receive results as plain records.
Zapier Catch Hook URL is the same in test and live: test Sume safely
Zapier's Catch Hook URL does not change between test and live. Use Sume's webhook.test delivery to check the Zap before a real run sends a real result into it.
Make takes 300 webhook requests per 10 seconds: a Sume queue fits
Make accepts 300 incoming requests per 10 seconds. A 100-item Sume queue with per-item webhooks and 16 in flight stays far below that. When 429 and 400 matter.
One Sume webhook endpoint for job and run events: route on event
Job and run webhooks share one HMAC scheme but not one payload. A 27-line TypeScript handler verifies once, routes on event, and answers 204 to the rest.
Stdlib Python Sume webhook receiver: http.server, 204 for webhook.test
A 29-line http.server receiver that refuses an empty secret, checks sume-v1 in a 300-second window, takes the two-signature header, and 204s webhook.test.
Haiku 5.5 in Cursor with Sume MCP: a 150k request costs 8x a 90k one
Cursor adds Claude Haiku 5.5 from Settings > Models. Its price steps up above 100k input tokens: 90k costs $0.009 and 150k costs $0.075 before output.
Can an MCP OAuth token double as a Sume API key? No
Sume says hosted MCP takes an OAuth token or an API key, never one for the other. Do not paste a token into x-api-key or mint a key as a workaround.
One Sume MCP URL in Claude Code, Cursor and VS Code: keys compared
One https://mcp.sume.com/mcp URL, three shapes: claude mcp add --transport http, Cursor's mcpServers url, and VS Code's servers with type http.
VS Code mcp.json: put the Sume API key in a password input
In VS Code, declare a promptString input with password true and reference it as ${input:id} in the x-api-key header, so the Sume key never lands in mcp.json.
VS Code mcp.json for Sume: set type http, not sse
VS Code accepts type http or sse for a remote MCP server. Sume documents a streamable HTTP endpoint at https://mcp.sume.com/mcp, so use type http and a url.
Unattended agent on Sume MCP: API key or OAuth consent?
A cron or CI agent cannot click a consent page. Sume's docs give OAuth to interactive clients and API-key remote MCP to automation, with caps set per call.
Sume MCP with Write off: what an OAuth agent can still do
With OAuth read-only (mcp:read), an agent on Sume's hosted MCP can still read jobs, assets and the catalog and scrape pages. Writes and paid tools fail.
Codex bearer_token_env_var for Sume MCP: keep the key out of config
Codex can read a bearer token from an environment variable, so your Sume API key never lands in config.toml. Setup, the OAuth alternative, and what to check.
Codex tool_timeout_sec is 60: size Sume jobs_wait to fit under it
Codex stops a tool call after 60 seconds by default. Sume jobs_wait holds at most 55 seconds, so one slice fits. Here is the loop and the config.
Xcode and JetBrains Copilot: connect Sume MCP with requestInit headers
Copilot in Xcode and JetBrains sends remote MCP auth through requestInit headers. Here is the Sume API key entry, what it unlocks, and how to test it.
n8n MCP Client Tool with Sume: Bearer auth and tool selection
n8n's MCP Client Tool offers Bearer, header and OAuth2 auth and a Selected tools mode. Set it up against Sume's mcp.sume.com/mcp, and know the endpoint caveat.
Sume MCP idempotency_key: retry a timed-out paid call safely
Reuse the same idempotency_key to retry a paid Sume MCP call that timed out. A new key makes a new job. A reused key with a different payload returns 409.
Image 1.0 and Video 1.0 are not on Sume's hosted MCP: what to call
images_create and videos_create are REST-only. On hosted MCP the router tools generate_image and generate_video cover stills and clips. Fallback and checks.