ShortSync

npx add-mcp 'https://www.shortsync.app/api/mcp'

Conecte o ShortSync ao seu aplicativo de IA

Permita que o Claude Desktop, Cursor ou qualquer cliente de IA compatível com MCP leia seus dados do ShortSync e aja em seu nome, usando o Model Context Protocol.

O que é MCP? O Model Context Protocol é um padrão aberto que permite que um cliente de IA converse com um aplicativo em seu nome. Quando você conecta o ShortSync, a IA pode chamar um conjunto selecionado de ferramentas, como listar seus workspaces ou suas postagens agendadas futuras. Cada chamada é limitada à sua conta.

1

Adicione o ShortSync ao seu cliente de IA

O endpoint MCP é https://www.shortsync.app/api/mcp. Adicione-o como um conector personalizado no seu cliente de IA. As etapas abaixo mostram o Claude; Cursor, Continue e outros clientes MCP aceitam a mesma URL.

Claude (aplicativo web ou desktop)

Abra Configurações → Conectores, clique em Adicionar no canto superior direito e escolha Adicionar conector personalizado.

Dê a ele o nome ShortSync MCP (ou qualquer outro que você preferir), cole a URL do endpoint e clique em Adicionar. Deixe os campos OAuth Client ID / Secret vazios — o ShortSync usa Dynamic Client Registration, então o Claude os negocia automaticamente.

Arquivo de configuração do Claude Desktop (avançado)

Prefere editar o arquivo de configuração diretamente? Adicione isto ao seu claude_desktop_config.json. No macOS: ~/Library/Application Support/Claude/claude_desktop_config.json. No Windows: %APPDATA%\Claude\claude_desktop_config.json.

{
  "mcpServers": {
    "shortsync": {
      "type": "http",
      "url": "https://www.shortsync.app/api/mcp"
    }
  }
}

Reinicie o Claude Desktop após editar o arquivo.

2

Complete a conexão

Na primeira vez que o Claude chamar o ShortSync, ele abrirá um navegador para você fazer login (se ainda não estiver conectado) e mostrará uma tela de consentimento listando exatamente o que o aplicativo está solicitando. Clique em Permitir para completar a conexão.

Enviando vídeos e miniaturas do Claude.ai

As ferramentas create_video_upload e create_post_thumbnail_upload retornam uma URL pré-assinada apontando para amazonaws.com. Por padrão, o sandbox de execução de código do Claude.ai bloqueia esse host, então o PUT falha com host_not_allowed. Para permitir que o Claude envie os bytes por você, permita o host uma vez:

1. No Claude.ai, abra Configurações → Capacidades → Execução de código e criação de arquivos.
2. Ative Execução de código e criação de arquivos na nuvem e Permitir saída de rede.
3. Em Domínios adicionais permitidos, adicione *.amazonaws.com e clique em Adicionar.
4. Inicie uma nova conversa. A lista de permissões é aplicada quando o sandbox é criado, então conversas existentes mantêm as regras antigas e ainda serão bloqueadas.

Cursor, Claude Desktop e outros clientes que executam chamadas de ferramentas na sua própria máquina não precisam disso — eles podem acessar o S3 diretamente.

Ferramentas disponíveis

Uma seleção curada de ações do ShortSync é exposta via MCP. Novas ferramentas são adicionadas ao longo do tempo; peça ao seu cliente de IA para executar tools/list para o inventário atual. Até hoje:

Conta e workspace

Onde você tem acesso e o que está conectado.

Ferramenta	Escopo	Finalidade
get_user_profile	leitura	Retorna as informações da sua conta ShortSync.
list_organizations	leitura	Lista as organizações das quais você participa e seu papel.
list_workspaces	leitura	Lista os workspaces que você pode acessar.
list_platform_connections	leitura	Lista quais plataformas estão conectadas em um workspace.
list_pinterest_boards	leitura	Lista os boards na conta Pinterest conectada ao workspace, para escolher um boardId.
list_discord_channels	leitura	Lista os canais Discord conectados a um workspace, para escolher channelIds. Postagens sem channelIds vão para os canais padrão.

Vídeos e pastas

Gerencie a biblioteca: envie novos vídeos ou imagens, organize-os em pastas.

Ferramenta	Escopo	Finalidade
list_video_uploads	leitura	Lista seus uploads de vídeo em workspaces acessíveis.
list_folders	leitura	Lista pastas em um workspace, incluindo informações de hierarquia.
create_video_upload	escrita	Reserva um NOVO slot na biblioteca e retorna uma URL PUT S3 pré-assinada para você enviar os bytes diretamente. Não é para definir uma capa em uma postagem existente. Use create_post_thumbnail_upload para isso.
create_video_upload_from_url	escrita	Baixa um vídeo ou imagem de uma URL https pública como uma NOVA entrada na biblioteca. Não é para definir uma capa em uma postagem existente. Use update_post com custom_thumbnail_url em vez disso.
finalize_video_upload	escrita	Confirma que um PUT de create_video_upload foi concluído e vincula o novo video_upload_id que você pode passar para create_post_draft.
create_folder	escrita	Cria uma pasta em um workspace, opcionalmente aninhada sob uma pasta pai.
update_folder	escrita	Renomeia ou move (reparenta) uma pasta.
delete_folder	escrita	Exclui uma pasta; os vídeos dentro dela ficam sem pasta.
move_video_to_folder	escrita	Arquiva um upload de vídeo em uma pasta ou o remove de qualquer pasta.
create_carousel	escrita	Agrupa 2-50 itens já enviados em um único carrossel. Retorna um upload_id que você passa para create_post_draft. Limites por plataforma (ex.: IG 10, TikTok 35, X 4) são aplicados na hora da publicação.

Postagens e miniaturas

Transforme itens da biblioteca em rascunhos, edite legendas e capas antes de publicar.

Ferramenta	Escopo	Finalidade
get_post_details	leitura	Retorna legenda, título, descrição e status de uma única postagem.
create_concept	escrita	Registra uma ideia de conteúdo em um workspace antes de haver um upload para anexar. Passe uma data planejada para colocá-la no calendário de conteúdo.
create_post_draft	escrita	Cria um rascunho de postagem para uma única plataforma a partir de um upload existente.
create_post_drafts	escrita	Versão em lote — cria rascunhos de postagens para várias plataformas em uma única chamada em vez de chamar create_post_draft por plataforma.
update_post	escrita	Edita legenda, título, descrição, primeiro comentário, miniatura personalizada (URL de imagem, frame de linha do tempo ou um upload de imagem existente) e configurações por plataforma em qualquer postagem ainda não publicada.
batch_update_posts	escrita	Versão em lote — atualiza legenda, título, descrição, primeiro comentário e configurações de plataforma em várias postagens em uma única chamada. Não suporta miniaturas.
replace_post_media	escrita	Troca o vídeo ou imagem por trás de uma postagem ainda não publicada por outro upload no workspace, mantendo seu agendamento e legendas. Passe apply_to_batch para trocar todas as postagens agendadas junto com ela.
create_post_thumbnail_upload	escrita	Retorna uma URL PUT S3 pré-assinada limitada ao slot de miniatura personalizada de uma postagem específica. Não cria uma entrada na biblioteca; ideal para arquivos de imagem locais destinados apenas como capa.
finalize_post_thumbnail	escrita	Confirma que um PUT de create_post_thumbnail_upload foi concluído e vincula a imagem como custom_thumbnail_url da postagem.

Publicação e agendamento

Coloque um rascunho na fila para publicação imediata ou agende-o para um horário futuro.

Ferramenta	Escopo	Finalidade
list_scheduled_posts	leitura	Lista postagens agendadas futuras, das mais próximas primeiro.
schedule_post	escrita	Agenda um rascunho de postagem de vídeo para publicar em um horário específico.
batch_schedule_posts	escrita	Versão em lote — agenda vários rascunhos de postagens para o mesmo horário em uma única chamada em vez de chamar schedule_post por postagem.
cancel_scheduled_post	escrita	Cancela uma postagem agendada e a retorna para rascunho.
publish_now	escrita	Publica um rascunho ou postagem agendada imediatamente.
batch_publish_now	escrita	Versão em lote do publish_now. Publica várias postagens imediatamente em uma única chamada: passe IDs de postagens ou um ID de upload (opcionalmente limitado a algumas plataformas) para publicar todos os seus rascunhos.

Analytics

Resumos de métricas de postagens publicadas do cache de sincronização local. Cobre YouTube, TikTok, Instagram, Facebook, LinkedIn, Threads, Bluesky, Pinterest, Snapchat e Mastodon. Quando os dados têm mais de uma hora, a leitura também inicia uma sincronização em segundo plano, então perguntar novamente alguns minutos depois retorna números atualizados. Os números podem diferir do painel ao vivo no Instagram, Facebook e YouTube; veja a descrição de cada ferramenta para a ressalva.

Ferramenta	Escopo	Finalidade
get_workspace_analytics	leitura	Totais resumidos de analytics de postagens publicadas em uma janela móvel.
get_video_analytics	leitura	Métricas para um upload de vídeo, somadas entre plataformas.
get_folder_analytics	leitura	Métricas para uma pasta, consolidadas entre vídeos e subpastas.
get_post_analytics	leitura	Métricas para uma postagem de plataforma (uma postagem = uma plataforma).
explain_post_analytics_state	leitura	Explica por que os analytics de uma postagem estão como estão (sincronização ausente, plataforma não suportada, etc.).
sync_analytics	escrita	Atualize os analytics das plataformas conectadas agora ou verifique o progresso de uma sincronização em execução.

Caixa de entrada (comentários e DMs)

Leia e aja sobre o engajamento recebido em todas as contas conectadas.

Ferramenta	Escopo	Finalidade
list_inbox_conversations	leitura	Lista threads da caixa de entrada (comentários + DMs) com filtros de ordenação, busca e respondidas/não respondidas.
list_inbox_connections	leitura	Quais contas de plataforma estão conectadas à caixa de entrada e seus sinalizadores de capacidade de resposta/DM/curtida.
get_conversation_messages	leitura	Retorna as mensagens em uma thread da caixa de entrada, das mais antigas primeiro.
resolve_linkedin_mention	leitura	Resolve uma menção @ do LinkedIn no perfil subjacente para que uma resposta possa marcá-lo corretamente.
sync_inbox	escrita	Puxe novas threads e mensagens de cada conexão habilitada para DM.
load_more_comments	escrita	Pagine mais fundo no histórico de comentários de um vídeo/postagem específico.
reply_to_comment	escrita	Publica uma resposta a um comentário ou thread de DM.
mark_conversations_seen	escrita	Marca em lote threads da caixa de entrada como lidas para o workspace.
mark_conversations_spam	escrita	Alterna em massa o sinalizador local de moderação de spam em threads da caixa de entrada.
like_conversation	escrita	Curte ou descurte uma thread de comentário de nível superior do Instagram ou Facebook.
like_message	escrita	Curte ou descurte uma resposta de comentário aninhada do Instagram ou Facebook.

Pessoas do workspace

CRM leve para as pessoas com quem você trabalha neste workspace.

Ferramenta	Escopo	Finalidade
list_workspace_people	leitura	Lista pessoas salvas neste workspace com suas informações de contato e papel.
upsert_workspace_person	escrita	Cria ou atualiza um registro de pessoa no workspace.

Faltando uma ferramenta que você precisa? Envie um e-mail para hilma@shortsync.app com o que você deseja fazer e eu a adicionarei.

Revogar acesso

Você pode desconectar qualquer aplicativo de IA a qualquer momento em Configurações → API e MCP. A revogação é imediata; a próxima chamada de ferramenta desse aplicativo falhará e o usuário terá que reconectar.

Limites

• Tokens de acesso duram 1 hora; tokens de atualização duram 30 dias.
• Chamadas de ferramentas são limitadas a 60 por minuto por token, além da sua cota existente por plano.
• Disponível em todos os planos, incluindo o Gratuito. Ferramentas caras (uploads, sincronizações de analytics) ainda contam contra sua cota mensal.

MCP é diferente da API REST do ShortSync. Para acesso programático com uma chave Bearer estática, veja API → Primeiros passos.