Documentação

API e MCP da DevX Viral

Uma chave criada no painel dá à sua IA, ou ao seu sistema, o mesmo acesso que você tem, dentro do papel e do plano.

O que dá para fazer

1. Crie uma chave

No painel, em Definições → Chaves de API, dê um nome e escolha o papel. A chave aparece uma vez só: copie e guarde. Ela começa com dvx_.

2. Conecte pelo MCP

O servidor fica em https://api.devxviral.com/mcp, com transporte HTTP. No Claude Code:

claude mcp add --transport http devxviral https://api.devxviral.com/mcp \
  --header "Authorization: Bearer dvx_SUA_CHAVE"

No Cursor (ou em qualquer cliente que aceite servidor por URL):

{
  "mcpServers": {
    "devxviral": {
      "url": "https://api.devxviral.com/mcp",
      "headers": { "Authorization": "Bearer dvx_SUA_CHAVE" }
    }
  }
}

O painel mostra esses comandos prontos, com a sua chave, também para o Claude Desktop.

3. Ou chame a API direto

As rotas ficam em https://api.devxviral.com/api/… e aceitam a mesma chave no cabeçalho. A chave age como quem a criou, no workspace dela, com o papel escolhido.

curl https://api.devxviral.com/api/accounts \
  -H "Authorization: Bearer dvx_SUA_CHAVE"

Cobrança e indicações são só leitura pela chave; as chaves e a administração não aceitam chave nenhuma.

Limites por plano

PlanoChamadas por minutoChavesAcesso
Essencial603Leitura
Pro1205Leitura e escrita
Agência30040Leitura e escrita

Algumas ferramentas que custam processamento (ver quadro, exportar, transcrever, buscar referências, enviar e importar) têm também um teto por dia no workspace.

Papéis da chave

  • admin Tudo: ver, publicar, vídeos, contas, membros e definições.
  • editor Ver, publicar, mexer em vídeos e contas. Sem definições nem cobrança.
  • analista Só ler.

A chave nunca tem papel acima de quem a criou.

Erros

  • 401 unauthorized Faltou o cabeçalho Authorization, ou a chave foi revogada.
  • 402 feature_not_in_plan O plano não libera a API, ou a ação escreve e o plano só lê.
  • 403 forbidden O papel da chave não pode fazer essa ação.
  • 429 rate_limited Passou das chamadas por minuto. Espere o tempo do cabeçalho Retry-After.

As ferramentas do MCP

As principais. As marcadas com E escrevem e pedem o Pro ou o Agência; as com E! apagam ou cancelam e pedem confirmar: true.

Conta e painel

  • quem_sou_eu Quem é a chave, qual workspace e qual plano.
  • listar_contas As páginas conectadas, com busca e filtro por rede.
  • ver_saude_das_contas Saúde, entrega e alertas de cada página.
  • ver_painel Os números do painel por período, rede ou página.
  • melhores_horarios Os horários em que as suas páginas rendem mais.
  • listar_reels Os reels publicados, ordenados por viralidade.
  • ver_ranking O ranking da semana, do mês ou geral.
  • buscar_referencias Reels de referência por nicho ou perfil.

Biblioteca e envio

  • listar_biblioteca Vídeos, imagens e áudios, com pastas e busca.
  • enviar_arquivoE Envia um arquivo do seu computador.
  • importar_por_urlE Traz um vídeo de um link direto, do YouTube ou do Google Drive.
  • buscar_imagens Busca imagens livres para usar no vídeo.
  • criar_pastaE Cria uma pasta na biblioteca.
  • mover_para_pastaE Organiza vídeos em pastas.
  • gerar_variacoesE Gera versões diferentes de um vídeo.
  • importar_reelE Traz um reel publicado para a biblioteca.

Publicar e agendar

  • agendar_publicacaoE Um vídeo numa página, num horário.
  • agendar_loteE Vários vídeos em várias páginas, com intervalo e variação por conta.
  • agendar_storiesE Stories em sequência nas páginas.
  • agendar_fotoE Foto ou carrossel no feed.
  • ver_agenda O que está agendado, publicado ou falhou.
  • repetir_publicacaoE Tenta de novo o que falhou.
  • cancelar_publicacaoE! Cancela publicações ou um lote inteiro.
  • criar_rotina_de_storiesE Stories todo dia, sozinhos, a partir de uma pasta.

Cortes e legendas

  • gerar_cortesE Transforma um vídeo longo em cortes prontos no editor.
  • status_dos_cortes Acompanha a geração dos cortes.
  • transcreverE Transcreve a fala de um projeto.
  • gerar_legendasE Legendas com estilo, posição e destaque.

Editor

  • criar_projetoE Abre um projeto com os vídeos escolhidos.
  • descrever_projeto O que tem no projeto: trechos, textos, sons.
  • ver_quadro A imagem de um segundo do vídeo, para a IA conferir.
  • remover_pausasE Corta os silêncios da fala.
  • dividir_clipe / aparar_clipeE Corta e ajusta os trechos.
  • adicionar_clipeE Põe um vídeo na linha do tempo, inclusive como B-roll.
  • adicionar_textoE Título, legenda ou destaque, com estilo e tempo.
  • adicionar_audioE Música ou efeito sonoro.
  • definir_transicaoE Transição entre trechos.
  • aplicar_efeitos_de_videoE Filtro, cor e movimento.
  • animarE Animação por quadros-chave em textos e trechos.
  • aplicar_formatoE Aplica um formato salvo (moldura, textos fixos).
  • seguir_rostoE Câmera que acompanha o rosto.
  • separar_vozE Separa a voz da música.
  • desfazerE Desfaz a última ação da IA.
  • exportarE Gera o vídeo final na biblioteca.