Second Studio

用于品牌解说视频和参考驱动型剪辑的托管式视频 MCP 服务器。

托管 MCP 服务器

npx add-mcp 'https://secondstudio.dev/mcp'

可安装到 Claude Code、Codex、Cursor 等客户端

文档

Connect an agent (MCP)

Connect an agent (MCP)

Second Studio speaks the Model Context Protocol, so any MCP-capable agent can use it with your API key. The server is hosted, so there is nothing to install: a URL and a header.

Use the agent key in agent configuration. It cannot approve posts, so an agent can never release its own drafts. Keep it in the SECOND_STUDIO_API_KEY environment variable, never in chat or a repo:

export SECOND_STUDIO_API_KEY="ss_live_..."

The fastest setup is the one prompt at /setup.txt: paste it into any agent.

Hosted server

URL: https://secondstudio.dev/mcp · Transport: Streamable HTTP · Auth: Authorization: Bearer $SECOND_STUDIO_API_KEY

Claude Code

claude mcp add --transport http second-studio https://secondstudio.dev/mcp --header "Authorization: Bearer $SECOND_STUDIO_API_KEY"

Cursor (.cursor/mcp.json), Windsurf and other clients with a JSON config

{
  "mcpServers": {
    "second-studio": {
      "type": "http",
      "url": "https://secondstudio.dev/mcp",
      "headers": { "Authorization": "Bearer ${env:SECOND_STUDIO_API_KEY}" }
    }
  }
}

Claude Desktop (claude_desktop_config.json, through the mcp-remote bridge; put your key in place of MY_KEY, the file stays on your computer):

{
  "mcpServers": {
    "second-studio": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://secondstudio.dev/mcp", "--header", "Authorization: Bearer ${SECOND_STUDIO_API_KEY}"],
      "env": { "SECOND_STUDIO_API_KEY": "MY_KEY" }
    }
  }
}

ChatGPT and other apps with connectors: add a custom MCP connector with the URL above and the same Authorization header, or sign in with OAuth (below). API keys keep working either way.

No MCP support: call the REST API at https://secondstudio.dev/v1 with the same header. GET /v1/me checks the key.

Sign in from Claude or ChatGPT

Directory connectors (Claude and ChatGPT) can sign the person in instead of asking them to paste an API key. The MCP address stays https://secondstudio.dev/mcp. A request with no token gets 401 and a WWW-Authenticate header that points at the protected-resource document:

https://secondstudio.dev/.well-known/oauth-protected-resource

That document names the authorization server on the same host. Its metadata is at https://secondstudio.dev/.well-known/oauth-authorization-server (RFC 8414). The same document is also at https://secondstudio.dev/.well-known/oauth-protected-resource/mcp.

The flow is OAuth 2.1 with PKCE (S256):

  1. The app registers itself (POST https://secondstudio.dev/oauth/register). Only Claude and ChatGPT callback URLs are accepted, plus a localhost callback for the MCP Inspector and for Claude Code.
  2. The person signs in with the same Clerk sign-in as the portal (https://secondstudio.dev/signin/) and picks a workspace.
  3. The app exchanges the code at POST https://secondstudio.dev/oauth/token and refreshes it there. Access tokens last one hour. Refresh tokens rotate. The authorization request and the code exchange must send resource=https://secondstudio.dev/mcp (RFC 8707). A refresh must send the same resource if it sends one.
  4. Call the MCP server with Authorization: Bearer and the access token. Revoke a token at POST https://secondstudio.dev/oauth/revoke.

The connection acts in the workspace you picked, with your role or a lower one. It is never an admin and never the owner. An admin who connects an app gets a creator key. A manager, creator, or reviewer keeps that role. The key is an agent key, so it cannot approve posts unless the person is a reviewer. It uses that person's monthly credit cap or monthly budget when they have one. Otherwise the key's own monthly cap is the starter credit amount. Credits still come out of the workspace balance. An API key and a connector can be used at the same time.

Disconnect an app under Agent keys in the portal. That revokes its tokens immediately. Your other API keys stay active.

Allowed callbacks, matched exactly (a loopback port may differ, per the native-app rule):

AppRedirect URI
Claude (web, desktop, mobile)https://claude.ai/api/mcp/auth_callback and https://claude.com/api/mcp/auth_callback
ChatGPThttps://chatgpt.com/connector_platform_oauth_redirect, or https://chatgpt.com/connector/oauth/<id>
MCP Inspectorhttp://localhost:<port>/oauth/callback or http://127.0.0.1:<port>/oauth/callback
Claude Codehttp://localhost:<port>/callback or http://127.0.0.1:<port>/callback

Uploads go to a one-time upload URL from upload_asset, and agents poll get_job until a job finishes.

Tools

ToolWhat it doesCredits
whoamiAccount, key scope and settingsn/a
get_creditsBalance, prices and packsn/a
buy_creditsStripe Checkout link for a pack (pack), a custom amount (pack: "custom", credits 200 to 50,000 at $0.10 each, $20 minimum) or a plan (plan). A person opens the link and pays.n/a
upload_file (local)Upload a file from diskn/a
create_upload_url + register_asset (remote)Upload in two stepsn/a
get_asset, list_assets, delete_assetManage filesn/a
fetch_videoA reference from a social URL. Direct hosts are 1 credit. Proxied hosts such as Instagram are 3, plus 1 per extra 25 MB1 or 3
analyze_styleReference video to a reusable style2 for the first minute, then 1 per extra minute (10 min max)
get_style, list_stylesRead styles, including the full specn/a
list_templates, get_template, save_template, delete_templateSocial videos saved to replicatefree (3 with analyze)
list_clip_templatesBuilt-in clip looks (secondstudio_home and the rest). Not saved social videos.free
create_clip_job, get_clip_job, list_clip_jobsRanked clips from a long video. template_id picks a clip look.1 per minute + 1 per clip
rerender_clipRender one clip again. template_id re-encodes when the look changes.1
create_editYour clips cut to a style5
record_urlRecord a public web app3
record_repoBuild a private GitHub repository and record its key flows. Optional repo_id and skill_ids add path notes. 4 more credits when it signs in. If a job fails because of a problem on our side, we usually refund the credits automatically. Refunds are made in credits, not money. See the Terms for details20 for up to 3 flows, 4 per extra flow
connect_githubAdmin: link to install the GitHub App on chosen repositoriesfree
repo_connect, repo_listConnect a repository the app can already read, and list themfree
repo_indexRead a repository into docs and skills. estimate: true is a free quote12 + 0.12/file, cap 400. A later commit is 6 + 0.12 per changed file, and at least 2.5x of the planning cost
repo_index_status, repo_docs_getIndex status and the docs (paths, no code quotes)free
create_character, get_character, list_characters, delete_characterStored identities you can reuse by idlike one image
create_brand, get_brand, list_brands, delete_brandBrand kits for explainer videosn/a
write_scriptAn editable scene-by-scene explainer script from a brief. Optional repo_id and skill_ids2
create_explainerA rendered, branded explainer video from a brief or script. Optional repo_id and skill_ids12 first minute, +7 per extra minute
generate_imageCharacter sheets, characters, locations, props, scenes, productsGPT Image 6 / 16 / 48 at 1K / 2K / 4K. A character sheet is twice that
generate_iconsA set of icons from a brand kit and its style skills. brand_id picks the kit. Omit it to use the primary kit. estimate: true is free5 per icon
regenerate_iconOne icon again, keeping the set's style lock5
list_icon_sets, get_icon_setRead icon sets and their SVG and PNG filesfree
generate_videoVideo shots, from text, an image or references (+ a voice track)quoted per request
generate_voicePerformed voiceover2 minimum, then 1 per 250 characters
lipsyncRe-time a mouth to an audio track15 min, 1.25 per second
get_job, list_jobsJob status and outputsn/a
list_social_accountsConnected accountsn/a
connect_social_accountA link to connect a new accountn/a
create_post, list_postsDraft and track posts1 per post
create_post_approval, get_post_approval, list_post_approvalsEmail a preview for approval. The approver confirms on a page. on_approve: publish posts only when the account scheduler is onfree until a publish is approved
create_post_approval_digestOne email for up to 20 posts, with buttons on eachfree until a publish is approved
list_crewThe crew: preset robots and the tools each bundlesfree
get_robotOne robot's skills, tools, endpoints and starter promptfree
list_modelsImage, video and swap models and what each supportsn/a
create_skill, upload_skill, list_skills, get_skill, update_skill, delete_skillYour skills library for image, video, audio, text, character, style and other skills, with files. upload_skill imports a SKILL.md or .zip. Ids or slugs work. Pass skill_ids to generate_image, generate_video, generate_voice and the restfree
skill_regenerateRewrite one codebase skill. Pinned, custom, and edited skills get a proposal4
skill_versions, skill_restoreList versions and restore one, including a codebase skill deleted within 30 daysfree
edit_imageMasked edit of a real photo, rest untouchedper image
swap_character, motion_transferKeep the footage, change the subjectquoted
finalize_video, cancel_job, upscale_videoDrafts → keeper, cancel (credits come back if the job has not started on a worker yet; after that the reservation is kept). Refunds are made in credits, not money. 2160p resamplequoted / n/a / 3
libraryEverything the team can reuse by id, with who made it, plus foldersn/a
list_foldersLibrary folders (id, name, auto, count). auto is true when the studio created the foldern/a
move_to_folderMove up to 100 videos and images into a folder (folder_id null sends them to Unfiled). Does not delete themn/a
list_members, invite_member, update_member, remove_member, create_member_key, list_keys, revoke_key, pause_key, resume_keyTeam members, roles, keys, credit and dollar caps, claim links (admin). A paused key cannot resume itself.n/a
list_invites, invite_by_email, create_invite_link, revoke_inviteInvite by email (joins on Google sign-in) or by expiring link (admins; managers into their team)none
my_memberships, list_teams, create_team, update_team, delete_team, set_member_teamTeams and managers (governance accounts; admin to change)none
list_budgets, allocate_budget, set_member_allowance, revoke_budget, set_key_credit_cap, list_auditMember and team credit budgets, a weekly or monthly allowance per person, per-key caps, audit log (admins; managers inside their team)none
list_providers, connect_provider, disconnect_providerYour own Higgsfield / ElevenLabs keys (admin, where enabled)n/a
list_voices, clone_voice, delete_voiceYour workspace's voices and clones from your sampleslike voice
analyze_brandA suggested brand kit from your boards1
import_brand_from_urlImport a brand from its guidelines page or brand book PDF: logo, colors, fonts, voice and tone, taglines, do's and don'ts, imagery notes. Fills a kit you pick or creates one, and every field stays editable. Default mode: "apply" saves straight away; mode: "review" returns a draft and saves nothing until you approve it. Also on the Brand tab in the dashboard, which always reviews first.1
approve_brand_importSave a mode: "review" import draft as the brand kit.0
discard_brand_importDrop a mode: "review" import draft. Nothing is saved.0
brand_from_websiteBrand guidelines from your public website (colors, font, tone, audience, products, voice rules), saved to a brand kit without overwriting your edits. New accounts with a work email get one free scan of their domain at signup.1
report_issue, list_reportsFile a bug, feature request or question; follow the responsen/a
feedback, /feedback promptSend product feedback to the team (10 per hour per key)0

The /feedback prompt (MCP prompt feedback) asks what you want to share, then sends it with the feedback tool. It is free.

When you create a video or image, pass one of these. A folder name that does not exist is created. Names All and Unfiled are reserved.

Field
folderName, or an id from list_folders. This is the only field that creates a normal folder (auto: false).
projectProject name. Used when folder is omitted. Wins over campaign if both are set.
campaignCampaign name. Same place in line as project.
productProduct name. Used when folder, project, and campaign are omitted.

If you pass none of them, the item is filed from the brand name, then the style or template name, then a kind default such as Videos, Explainers, Edits, Recordings, References, or Images. That folder is marked auto so a person can rename or merge it. estimate: true does not create a folder. list_folders returns each folder's id, name, auto, and count. move_to_folder moves videos and images; folder_id null sends them back to Unfiled.

The same fields exist on generate_video, generate_image, create_explainer, create_edit, fetch_video, record_url, record_repo, swap_character, motion_transfer, upscale_video, finalize_video, and edit_image.

Approving posts is deliberately not a tool. A person approves with the admin key: see Posting.

Example prompts

  • "Analyze ./refs/viral.mp4 and tell me what makes its editing work."
  • "Make three 15-second edits of ./footage in the style of that reference, with different hooks."
  • "Record our pricing page at https://example.com/pricing on mobile, then cut it to my saved style."
  • "Draft the best one to our TikTok for tomorrow 6pm Eastern."