Conecta tu IA

Qué puedes hacer

MCP es el puente entre tu IA y oDarkly. En lugar de hacer clic en el panel, describes lo que quieres y el asistente lo ejecuta: crear proyecto, generar guion, renderizar el MP4, encolar en YouTube, o crear y seguir automatizaciones. Todo corre en la nube — nada que instalar en tu PC.

Funciona en Cursor, Claude Desktop, ChatGPT (conectores MCP) y cualquier cliente compatible con servidores remotos HTTPS.

1. Crea tu clave API

La clave identifica tu cuenta cuando la IA se conecta a oDarkly. Solo se muestra una vez — cópiala y guárdala en un lugar seguro.

1. Inicia sesión en tu dashboard.
2. Ve a Ajustes → Conectar tu IA.
3. Crea la clave y copia el código odk_live_… al instante.
4. ¿Quieres automatizar video y YouTube? Activa también los alcances generate y youtube:write.

Abrir ajustes del dashboard →

2. Conecta tu asistente

Pega la URL abajo en la app que uses. No necesitas instalar Node ni ejecutar scripts locales — el servidor ya está en línea.

https://odarkly.com/api/mcp

Envía tu clave en cada solicitud:

Authorization: Bearer odk_live_YOUR_KEY_HERE

¿Cliente sin soporte remoto?

Si la app solo acepta MCP local (stdio), usa el paquete mcp-remote como puente — conecta al servidor remoto de oDarkly por ti:

{
  "mcpServers": {
    "odarkly": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://odarkly.com/api/mcp",
        "--header",
        "Authorization: Bearer odk_live_YOUR_KEY_HERE"
      ]
    }
  }
}

Probar conexión

Con tu clave odk_live_… creada en el dashboard, este comando debe devolver protocolVersion y serverInfo de odarkly:

curl -X POST https://odarkly.com/api/mcp \
  -H "Authorization: Bearer odk_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

Seguridad

El MCP remoto usa la misma autenticación que la API v1. Cada usuario solo accede a su propia cuenta — no hay login compartido.

• Las claves son personales: créalas en Configuración → Conectar tu IA y revócalas si se filtran.
• Tú eliges qué puede hacer cada clave: solo consultar, crear proyectos, generar videos o publicar en YouTube.
• Todas las solicitudes deben usar HTTPS. Nunca expongas tu clave en sitios o repositorios públicos.
• Hay límites por clave y por IP para evitar abuso.
• Durante el mantenimiento del dashboard, el MCP no está disponible para usuarios comunes (los admins conservan acceso).

Configuración en Cursor

Añade en .cursor/mcp.json o en Cursor Settings → MCP. Pega la URL remota y el header Authorization con tu clave odk_live_…

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

Configuración en Claude

En Claude Desktop: Settings → Connectors → Add custom connector. URL: https://odarkly.com/api/mcp con autenticación Bearer y tu clave. En Claude Code, usa el bloque JSON abajo.

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

Configuración en ChatGPT

ChatGPT solo se conecta a servidores MCP remotos por HTTPS (no acepta stdio local).

1. Abre ChatGPT → Settings → Connectors (o Developer / Apps).
2. Añade un conector MCP personalizado.
3. URL del servidor: https://odarkly.com/api/mcp — auth: Bearer odk_live_…

https://odarkly.com/api/mcp

Del guion a YouTube

Con los alcances correctos en tu clave, puedes pedir todo esto en una conversación. La IA llama las herramientas en orden — no necesitas memorizar los nombres.

1. Crea el proyecto y genera guion, imágenes y narración. create_project · generate_script · generate_scene_images · generate_audio
2. Renderiza el video y espera hasta que esté listo. start_render · get_render_job
3. Revisa tus canales y pon el video en la cola de publicación. list_youtube_channels · queue_youtube_video
4. Configura un embudo para publicar en horarios fijos si quieres automatizar el canal. create_funnel · update_funnel
5. Crea y sigue las automatizaciones del dashboard: cuáles están listas, cuáles corrieron y cuáles ya se publicaron. create_automation · list_automations · list_automation_runs
6. Crea influencer, carrusel, UGC, cinema o GUM Animator desde el chat — las mismas herramientas del dashboard. create_influencer · create_gum_character · create_carousel · create_ugc_video · create_cinema_video · prepare_gum_animator · create_gum_animator

Para publicar en YouTube, conecta el canal una vez en Canales del dashboard — la IA usa la conexión que ya configuraste.

Ejemplos de qué pedir

Copia, adapta y envía esto en el chat de tu asistente después de conectar el MCP:

• “

  Crea un Short de terror sobre un faro abandonado, genera todo y renderiza el video.

• “

  Lista mis proyectos listos y encola el más reciente en mi canal principal.

• “

  Crea un embudo en el canal X publicando de lunes a viernes a las 18h, con revisión antes de subir.

• “

  Lista mis automatizaciones, dime cuáles están listas y si la última ronda se publicó en YouTube. Luego crea una de terror corto hasta publicar.

• “

  Crea una influencer mujer, 25 años, pelo rizado, look casual. Luego un carrusel de 7 slides en Instagram sobre rutina de skincare con ella.

• “

  Lista mis fichas del GUM Creator. Prepara este MP4 en GUM Animator y cambia a la persona principal por la ficha más reciente.

Referencia de herramientas

Son los comandos que tu IA puede ejecutar por ti. Cada uno requiere el alcance indicado — sin permiso, la herramienta ni aparece en la lista.

API REST v1

Todos los endpoints están en /api/v1/. Envía JSON en POST con Content-Type: application/json. Autentica con token Bearer.

Autenticación

Incluye tu clave API en cada solicitud:

Authorization: Bearer odk_live_YOUR_KEY_HERE

Alcances de la clave API

Activa solo lo que necesitas. La clave predeterminada ya permite consultar y crear proyectos. Para producir y publicar videos con tu IA, activa los dos alcances extra abajo.

• read Consultar proyectos, automatizaciones, créditos, perfil y progreso de render
• projects:write Crear proyectos y gestionar automatizaciones
• generate Generar guion, imágenes, audio y renderizar el MP4
• youtube:write Publicar en YouTube y configurar embudos de canal

Límites de tasa

Los límites aplican por clave API. Al excederlos, la API devuelve HTTP 429.

• 300 solicitudes de lectura por minuto por clave
• 30 solicitudes de escritura (POST) por minuto por clave

Ejemplos de solicitud

Reemplaza odk_live_YOUR_KEY_HERE por tu clave real. Nunca subas claves al control de versiones.

curl -H "Authorization: Bearer odk_live_YOUR_KEY_HERE" \
  https://odarkly.com/api/v1/me.php

curl -H "Authorization: Bearer odk_live_YOUR_KEY_HERE" \
  https://odarkly.com/api/v1/credits.php

curl -H "Authorization: Bearer odk_live_YOUR_KEY_HERE" \
  "https://odarkly.com/api/v1/projects.php?limit=10"

curl -X POST \
  -H "Authorization: Bearer odk_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"type":"SHORT","topic":"A haunted lighthouse","niche":"TERROR"}' \
  https://odarkly.com/api/v1/projects.php