Documentación

API y MCP de DevX Viral

Una clave creada en el panel le da a tu IA, o a tu sistema, el mismo acceso que tienes, dentro del rol y del plan.

Qué se puede hacer

1. Crea una clave

En el panel, en Ajustes → Claves de API, ponle un nombre y elige el rol. La clave aparece una sola vez: cópiala y guárdala. Empieza con dvx_.

2. Conecta por MCP

El servidor está en https://api.devxviral.com/mcp, con transporte HTTP. En Claude Code:

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

En Cursor (o en cualquier cliente que acepte un servidor por URL):

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

El panel muestra estos comandos listos, con tu clave, también para Claude Desktop.

3. O llama a la API directo

Las rutas están en https://api.devxviral.com/api/… y aceptan la misma clave en el encabezado. La clave actúa como quien la creó, en su workspace, con el rol elegido.

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

Facturación y referidos son solo lectura con la clave; las claves y la administración no aceptan ninguna clave.

Límites por plan

PlanLlamadas por minutoClavesAcceso
Esencial603Lectura
Pro1205Lectura y escritura
Agencia30040Lectura y escritura

Algunas herramientas que cuestan procesamiento (ver cuadro, exportar, transcribir, buscar referencias, enviar e importar) también tienen un tope diario por workspace.

Roles de la clave

  • admin Todo: ver, publicar, videos, cuentas, miembros y ajustes.
  • editor Ver, publicar, trabajar con videos y cuentas. Sin ajustes ni facturación.
  • analista Solo leer.

La clave nunca tiene un rol por encima de quien la creó.

Errores

  • 401 unauthorized Falta el encabezado Authorization, o la clave fue revocada.
  • 402 feature_not_in_plan El plan no incluye la API, o la acción escribe y el plan solo lee.
  • 403 forbidden El rol de la clave no puede hacer esta acción.
  • 429 rate_limited Pasaste las llamadas por minuto. Espera el tiempo del encabezado Retry-After.

Las herramientas del MCP

Las principales. Las marcadas con E escriben y piden Pro o Agencia; las marcadas con E! borran o cancelan y piden confirmar: true.

Cuenta y panel

  • quem_sou_eu De quién es la clave, qué workspace y qué plan.
  • listar_contas Las páginas conectadas, con búsqueda y filtro por red.
  • ver_saude_das_contas Salud, entrega y alertas de cada página.
  • ver_painel Los números del panel por período, red o página.
  • melhores_horarios Los horarios en que tus páginas rinden más.
  • listar_reels Los reels publicados, ordenados por viralidad.
  • ver_ranking El ranking de la semana, del mes o general.
  • buscar_referencias Reels de referencia por nicho o perfil.

Biblioteca y envío

  • listar_biblioteca Videos, imágenes y audios, con carpetas y búsqueda.
  • enviar_arquivoE Envía un archivo desde tu computadora.
  • importar_por_urlE Trae un video de un link directo, de YouTube o de Google Drive.
  • buscar_imagens Busca imágenes libres para usar en el video.
  • criar_pastaE Crea una carpeta en la biblioteca.
  • mover_para_pastaE Organiza videos en carpetas.
  • gerar_variacoesE Genera versiones distintas de un video.
  • importar_reelE Trae un reel publicado a la biblioteca.

Publicar y programar

  • agendar_publicacaoE Un video en una página, en un horario.
  • agendar_loteE Varios videos en varias páginas, con intervalo y variación por cuenta.
  • agendar_storiesE Stories en secuencia en las páginas.
  • agendar_fotoE Foto o carrusel en el feed.
  • ver_agenda Lo que está programado, publicado o falló.
  • repetir_publicacaoE Intenta de nuevo lo que falló.
  • cancelar_publicacaoE! Cancela publicaciones o un lote entero.
  • criar_rotina_de_storiesE Stories todos los días, solas, desde una carpeta.

Cortes y subtítulos

  • gerar_cortesE Convierte un video largo en cortes listos en el editor.
  • status_dos_cortes Sigue la generación de los cortes.
  • transcreverE Transcribe el habla de un proyecto.
  • gerar_legendasE Subtítulos con estilo, posición y destaque.

Editor

  • criar_projetoE Abre un proyecto con los videos elegidos.
  • descrever_projeto Lo que tiene el proyecto: fragmentos, textos, sonidos.
  • ver_quadro La imagen de un segundo del video, para que la IA la revise.
  • remover_pausasE Corta los silencios del habla.
  • dividir_clipe / aparar_clipeE Corta y ajusta los fragmentos.
  • adicionar_clipeE Pone un video en la línea de tiempo, incluso como b-roll.
  • adicionar_textoE Título, subtítulo o destaque, con estilo y tiempo.
  • adicionar_audioE Música o efecto de sonido.
  • definir_transicaoE Transición entre fragmentos.
  • aplicar_efeitos_de_videoE Filtro, color y movimiento.
  • animarE Animación por fotogramas clave en textos y fragmentos.
  • aplicar_formatoE Aplica un formato guardado (marco, textos fijos).
  • seguir_rostoE Cámara que sigue la cara.
  • separar_vozE Separa la voz de la música.
  • desfazerE Deshace la última acción de la IA.
  • exportarE Genera el video final en la biblioteca.