Clip Studio MCP

npx add-mcp 'https://clipstudio.ai/api/mcp'

Clip Studio MCP

Servidor Model Context Protocol hospedado para o Clip Studio. Adicione uma URL ao Claude, Cursor, ChatGPT ou qualquer cliente MCP e use os mesmos produtos públicos do Clip Studio que um humano conectado já possui — Video Lab, Topic Shorts, Talking Shorts, Ad Studio, Last Frame, Image Lab, Audio Lab, Story, Ad Lab, biblioteca e ferramentas gratuitas — no mesmo plano do site.

Endpoint: https://clipstudio.ai/api/mcp
Transporte: Streamable HTTP
Marketing: https://clipstudio.ai/mcp
Lista pública de ferramentas: https://clipstudio.ai/mcp.md
Repositório: https://github.com/j-acks0n/clipstudio-mcp
Smithery: https://smithery.ai/servers/clipstudioai/clipstudio

Este repositório é uma listagem de conector (server.json, trechos de instalação, exemplos). O servidor é hospedado. Não há nada para clonar e executar.

Início rápido

Cole a URL. Deixe o ID do cliente OAuth vazio. Entre quando o cliente abrir o Clip Studio e depois aprove.

Conectores Claude Desktop / Claude.ai

Personalizar → Conectores → Adicionar conector personalizado. Cole:

https://clipstudio.ai/api/mcp

Conecte. Deixe o ID do cliente OAuth vazio.

Cursor

Adicione um servidor MCP HTTP em ~/.cursor/mcp.json. O Cursor executa OAuth no primeiro uso.

{
  "mcpServers": {
    "clipstudio": {
      "url": "https://clipstudio.ai/api/mcp"
    }
  }
}

ChatGPT (conector do modo desenvolvedor)

Ative o modo desenvolvedor, adicione um conector MCP personalizado, cole https://clipstudio.ai/api/mcp e conclua a aprovação no Clip Studio.

Windsurf

Edite ~/.codeium/windsurf/mcp_config.json (o campo remoto é serverUrl):

{
  "mcpServers": {
    "clipstudio": {
      "serverUrl": "https://clipstudio.ai/api/mcp"
    }
  }
}

Salve e atualize o MCP no Cascade.

VS Code / Copilot

mcp.json do usuário ou do workspace:

{
  "servers": {
    "clipstudio": {
      "type": "http",
      "url": "https://clipstudio.ai/api/mcp"
    }
  }
}

Paleta de comandos → MCP: Open User Configuration, ou .vscode/mcp.json em um workspace.

Clientes somente stdio

Ponte para Streamable HTTP:

npx -y mcp-remote https://clipstudio.ai/api/mcp

Exemplo de wrapper:

{
  "mcpServers": {
    "clipstudio": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://clipstudio.ai/api/mcp"]
    }
  }
}

Autenticação

OAuth com um clique na primeira chamada. Solicitações não autenticadas — incluindo initialize e tools/list — retornam HTTP 401 com WWW-Authenticate e metadados de recurso protegido. O cliente registra dinamicamente (OAuth 2.1 + PKCE, cliente público). Você entra com a conta do Clip Studio e aprova. Os tokens permanecem no cliente.

Nenhum ID de cliente para colar. Se um humano não puder fazer o trabalho em clipstudio.ai, o agente não poderá fazê-lo aqui.

Como funciona um trabalho pago

1. Cotação (quote_*). Não gera.

2. Se a cota mensal de geração não cobrir a cotação, a ferramenta retorna HTTP 402 com campos JSON numéricos (somente nomes — são chaves de API, não texto de interface):

   {
     "requiredCredits": 120,
     "availableCredits": 0
   }
   

   Em seguida, chame create_checkout_url com um priceId de get_account.offerCheckout. Ele retorna uma URL do Stripe Checkout e não coleta dados de cartão.

3. Gerar (generate_* / start_last_frame / render_storyboard / …). Usa a cota de geração deste mês.

4. Consulte a ferramenta get_* correspondente até o trabalho terminar.

Envie e consulte. Não mantenha a solicitação MCP aberta durante uma renderização completa do provedor.

Exemplos de prompts

• Pré-visualize um Topic Short de 15 segundos sobre por que a maioria das rotinas matinais falha, depois faça a cotação e gere.
• Liste os modelos do Video Lab, faça a cotação de um clipe de 8 segundos 16:9 de um tênis de corrida em pista molhada, gere e consulte até ficar pronto.
• Continue minha história: carregue o projeto mais recente, escreva a próxima parte e renderize.
• Verifique minha cota mensal restante de geração. Se uma cotação retornar 402, abra o checkout em offerCheckout.
• Pesquise um clipe do Ad Studio a partir desta URL de produto, escolha um criador do catálogo, faça a cotação, gere e consulte.

Passo a passo: examples/.

Ferramentas

Os nomes correspondem a https://clipstudio.ai/mcp.md. Ferramentas pagas usam a cota de geração deste mês.

Video Lab

Vídeo de ponta de texto para vídeo e imagem para vídeo. Faça a cotação antes de gerar.

Ferramenta	Descrição
list_video_lab_models	Lista modelos, modos e padrões. Mesmo catálogo de /video-lab.
quote_video_lab	Faz a cotação de uma configuração. Não gera. A geração paga precisa desta cotação.
generate_video_lab	Inicia uma geração paga. Consulte get_video_lab_generation.
list_video_lab_generations	Lista as gerações do Video Lab desta conta.
get_video_lab_generation	Busca uma geração pelo ID do vídeo.
reconcile_video_lab_generation	Atualiza um trabalho do provedor. Não debita novamente.
presign_generation_asset	Cria um slot de upload para uma imagem de origem ou MP4. Depois complete_generation_asset.
complete_generation_asset	Marca um upload de imagem de origem ou MP4 como pronto.

Topic Shorts

Tópico → história + banco de imagens + voz. Modo de legenda padrão current. Modo de transição padrão dynamic.

Ferramenta	Descrição
list_hook_bank	Modelos de ganchos de abertura (Problema, Curiosidade, Confiança, Nicho). Semeia tópico/breve; não é estilo de legenda.
create_topic_short_story	Pré-visualiza batidas, narração e consultas de banco de imagens em inglês. Não renderiza.
quote_topic_short	Faz a cotação de um Topic Short. Não renderiza. Cotado por duração.
generate_topic_short	Gera a partir de um tópico ou storyPlan revisado. Consulte get_topic_short.
get_topic_short	Busca uma geração.

Talking Shorts

URL do produto ou breve → clipe de apresentador. Catálogo de rostos e vozes.

Ferramenta	Descrição
research_talking_short	Pesquisa a partir de uma URL ou breve. Não renderiza.
quote_talking_short	Faz a cotação de um Talking Short. Não renderiza.
generate_talking_short	Inicia um Talking Short pago. Consulte get_talking_short.
get_talking_short	Busca uma geração.
list_talking_short_actors	Lista imagens estáticas do catálogo. Não renderiza.

Ad Studio

Produto → ângulo → roteiro de 5 batidas → criador do catálogo → um clipe vertical.

Ferramenta	Descrição
research_ad_studio	Pesquisa ângulos e um roteiro fixo de 5 batidas. Não renderiza.
quote_ad_studio	Faz a cotação de um trabalho do Ad Studio. Somente criadores do catálogo.
generate_ad_studio	Inicia um clipe pago. Consulte get_ad_studio.
get_ad_studio	Busca uma geração. Envie e consulte.

Last Frame

Reproduza um filme gerado. O último quadro é o cânone.

Ferramenta	Descrição
list_last_frame_games	Lista jogos (Adventure, Heist, Tape e os demais).
list_last_frame_worlds	Lista mundos/mapas do catálogo.
quote_last_frame	Faz a cotação de uma abertura ou próxima cena. Não filma.
start_last_frame	Inicia uma execução e filma a cena de abertura.
get_last_frame_run	Obtém uma execução, incluindo a cena mais recente e as escolhas.
choose_last_frame	Escolhe uma opção numerada. Filma a próxima cena.
type_last_frame	Digita um movimento personalizado. Filma a próxima cena.
timeout_last_frame	Aplica o tempo limite de escolha (temporizador HUD).
end_last_frame_clip	Informa à execução que a cena atual terminou de reproduzir.
arm_last_frame_item	Arma um item de inventário para o próximo movimento (itemIndex é baseado em 0).
create_last_frame_world	Cria um mundo personalizado a partir de uma descrição.

Image Lab

Imagens estáticas com cotação. Mesmo catálogo de /image-lab.

Ferramenta	Descrição
list_image_lab_models	Lista modelos, modos e proporções de aspecto.
quote_image_lab	Faz a cotação de uma imagem estática. Não gera. A geração paga precisa desta cotação.
generate_image_lab	Inicia uma imagem estática paga. Consulte get_image_lab_generation.
list_image_lab_generations	Lista as gerações do Image Lab desta conta.
get_image_lab_generation	Busca uma geração e a atualiza do provedor.

Audio Lab

Roteiro → narração para download com vozes do Clip Studio.

Ferramenta	Descrição
list_audio_lab_voices	Lista vozes de narração (sotaque e localidade).
quote_audio_lab	Faz a cotação de um roteiro. Não gera.
generate_audio_lab	Inicia narração paga. Consulte get_audio_lab_generation.
list_audio_lab_generations	Lista as gerações do Audio Lab desta conta.
get_audio_lab_generation	Busca uma geração e a atualiza do provedor.

Story

História completa → partes → filme. Continue minha história no mesmo projectId.

Ferramenta	Descrição
list_storyboard_themes	Lista temas visuais (permanece entre as partes).
list_storyboard_voices	Lista vozes de narração (permanece entre as partes).
estimate_storyboard	Estima a próxima parte a partir de um roteiro. Não renderiza.
create_storyboard	Inicia um projeto a partir de uma história completa. Não escreve uma parte nem filma.
get_storyboard	Busca um projeto, ou omita projectId para listar os recentes.
generate_storyboard_part	Escreve a próxima parte em um projeto existente. Não filma.
render_storyboard	Filma a parte mais recente. Consulte get_storyboard.

Ad Lab

Site → layouts estáticos, pacote de dicas, pacote Proof ou filme Explain.

Ferramenta	Descrição
import_ad_website	Lê um site público em um perfil de empresa.
quote_ad	Faz a cotação de um layout estático. Não gera.
generate_ad	Gera imagens estáticas (layout 9:16, 1:1, 4:5 ou 16:9). Consulte get_ad_generation.
quote_ad_tip_pack	Faz a cotação de um pacote de dicas. Não gera.
generate_ad_tip_pack	Gera um pacote de dicas. Consulte get_ad_generation.
quote_ad_proof_pack	Faz a cotação de um pacote Proof. Não gera.
generate_ad_proof_pack	Gera um pacote Proof. Consulte get_ad_generation.
quote_ad_explain	Faz a cotação de um filme Explain. Não gera.
generate_ad_explain	Gera um filme Explain a partir de uma foto de produto e um breve.
list_ad_generations	Lista trabalhos. Opcional companyId ou kind tip_pack, proof_pack, explain.
get_ad_generation	Busca um trabalho.

Biblioteca

Clipes que você já gerou. Publicar é uma página pública do Clip Studio, não postagem automática em redes sociais.

Ferramenta	Descrição
list_library	Lista clipes na biblioteca.
get_clip	Busca um clipe da biblioteca.
publish_generation	Publica uma geração concluída em uma página pública.
unpublish_generation	Despublica uma geração que você tornou pública.
get_generation_publication	Se uma geração é pública e sua URL pública, se for.
list_public_generations	Lista publicações públicas. Opcional kind, model, limit.
get_public_generation	Busca uma publicação pública pelo ID do clipe.

Ferramentas gratuitas

Copiar, ganchos, breves e ferramentas de planejamento em /tools. Não gera vídeo.

Ferramenta	Descrição
list_free_tools	Lista ferramentas gratuitas públicas.
run_free_tool	Executa uma ferramenta gratuita (slug + input).

Conta

Auxiliares de plano, uso e cobrança.

Ferramenta	Descrição
list_public_products	Lista produtos públicos que um agente pode usar por meio deste servidor.
get_account	Plano e uso da conta conectada, incluindo IDs de preço offerCheckout após um 402.
create_checkout_url	Cria uma URL do Stripe Checkout para um priceId. Não coleta dados de cartão.

Links

• Produto: https://clipstudio.ai/mcp
• Preços: https://clipstudio.ai/pricing
• Suporte: https://clipstudio.ai/support
• E-mail: support@clipstudio.ai
• Smithery: https://smithery.ai/servers/clipstudioai/clipstudio
• Entrada do registro: server.json (ai.clipstudio/mcp) — veja PUBLISHING.md

Mantendo isso em sincronia

A lista de ferramentas espelha https://clipstudio.ai/mcp.md. Quando essa página mudar, atualize as tabelas aqui manualmente. Veja scripts/sync-tools.md. Este repositório não importa o código-fonte privado do Clip Studio.