Conecte sua IA

O que você pode fazer

O MCP é a ponte entre sua IA e o oDarkly. Em vez de clicar no painel, você descreve o que quer e o assistente executa: criar projeto, gerar roteiro, renderizar o MP4, enfileirar no YouTube, ou criar e acompanhar automações. Tudo roda na nuvem — nada para instalar no seu computador.

Funciona no Cursor, Claude Desktop, ChatGPT (conectores MCP) e em qualquer cliente compatível com servidores remotos HTTPS.

1. Crie sua chave de API

A chave é o que identifica sua conta quando a IA se conecta ao oDarkly. Ela aparece só uma vez na criação — copie e guarde em um lugar seguro.

1. Entre no seu dashboard.
2. Vá em Configurações → Conectar sua IA.
3. Crie a chave e copie o código odk_live_… na hora.
4. Quer automatizar vídeo e YouTube? Marque também os escopos generate e youtube:write.

Abrir configurações do dashboard →

2. Conecte no seu assistente

Cole a URL abaixo no app que você usa. Não precisa instalar Node nem rodar script local — o servidor já está no ar.

https://odarkly.com/api/mcp

Envie sua chave em toda requisição:

Authorization: Bearer odk_live_YOUR_KEY_HERE

Cliente sem suporte remoto?

Se o app só aceita MCP local (stdio), use o pacote mcp-remote como ponte — ele conecta no servidor remoto do oDarkly por você:

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

Testar conexão

Com sua chave odk_live_… criada no dashboard, este comando deve retornar protocolVersion e serverInfo 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"}}}'

Segurança

O MCP remoto usa a mesma autenticação da API v1. Cada usuário só acessa a própria conta — não há login compartilhado.

• Chaves são pessoais: crie em Configurações → Conectar sua IA e revogue se vazar.
• Você escolhe o que cada chave pode fazer: só consultar, criar projetos, gerar vídeos ou publicar no YouTube.
• Todas as requisições devem usar HTTPS. Nunca envie sua chave em sites ou repositórios públicos.
• Há limite de requisições por chave e por IP para evitar abuso.
• Durante manutenção do dashboard, o MCP fica indisponível para usuários comuns (admins continuam com acesso).

Configuração no Cursor

Adicione em .cursor/mcp.json ou em Cursor Settings → MCP. Cole a URL remota e o header Authorization com sua chave odk_live_…

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

Configuração no Claude

No Claude Desktop: Settings → Connectors → Add custom connector. URL: https://odarkly.com/api/mcp e autenticação Bearer com sua chave. No Claude Code, use o mesmo bloco JSON abaixo.

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

Configuração no ChatGPT

O ChatGPT só conecta em servidores MCP remotos via HTTPS (não aceita stdio local).

1. Abra ChatGPT → Settings → Connectors (ou Developer / Apps).
2. Adicione um conector MCP personalizado.
3. URL do servidor: https://odarkly.com/api/mcp — autenticação: Bearer odk_live_…

https://odarkly.com/api/mcp

Do roteiro ao YouTube

Com os escopos certos na chave, você pode pedir tudo isso em uma conversa. A IA chama as ferramentas na ordem — você não precisa decorar os nomes.

1. Crie o projeto e gere roteiro, imagens e narração. create_project · generate_script · generate_scene_images · generate_audio
2. Renderize o vídeo e aguarde até ficar pronto. start_render · get_render_job
3. Veja seus canais e coloque o vídeo na fila de publicação. list_youtube_channels · queue_youtube_video
4. Configure um funil para publicar em horários fixos, se quiser automatizar o canal. create_funnel · update_funnel
5. Crie e acompanhe automações do dashboard: o que está pronto, o que rodou e o que já postou. create_automation · list_automations · list_automation_runs
6. Crie influencer, carrossel, UGC, cinema ou GUM Animator pelo chat — as mesmas ferramentas do dashboard. create_influencer · create_gum_character · create_carousel · create_ugc_video · create_cinema_video · prepare_gum_animator · create_gum_animator

Para publicar no YouTube, conecte o canal uma vez em Canais no dashboard — a IA usa a conexão que você já fez.

Exemplos do que pedir

Copie, adapte e mande no chat do seu assistente depois de conectar o MCP:

• “

  Cria um Short de terror sobre um farol abandonado, gera tudo e renderiza o vídeo.

• “

  Lista meus projetos prontos e coloca o mais recente na fila do meu canal principal.

• “

  Cria um funil no canal X publicando de segunda a sexta às 18h, com revisão antes de subir.

• “

  Lista minhas automações, diz quais estão prontas e se a última rodada postou no YouTube. Depois cria uma de terror curto até publicar.

• “

  Cria um influencer mulher, 25 anos, cabelo cacheado, visual casual. Depois um carrossel de 7 slides no Instagram sobre rotina de skincare com ela.

• “

  Lista minhas fichas do GUM Creator. Prepara este MP4 no GUM Animator e troca a pessoa principal pela ficha mais recente.

Referência de ferramentas

São os comandos que sua IA pode chamar por você. Cada um exige o escopo indicado na coluna ao lado — se faltar permissão, a ferramenta nem aparece na lista.

API REST v1

Todos os endpoints ficam em /api/v1/. Envie JSON em POST com Content-Type: application/json. Autentique com token Bearer.

Autenticação

Inclua sua chave de API em toda requisição:

Authorization: Bearer odk_live_YOUR_KEY_HERE

Escopos da chave de API

Marque só o que você precisa. A chave padrão já permite consultar e criar projetos. Para produzir e publicar vídeos pela IA, ative os dois escopos extras abaixo.

• read Consultar projetos, automações, créditos, perfil e progresso de render
• projects:write Criar projetos e gerenciar automações
• generate Gerar roteiro, imagens, áudio e renderizar o MP4
• youtube:write Publicar no YouTube e configurar funis de canal

Limites de taxa

Os limites aplicam por chave de API. Quando excedidos, a API retorna HTTP 429.

• 300 requisições de leitura por minuto por chave
• 30 requisições de escrita (POST) por minuto por chave

Exemplos de requisição

Substitua odk_live_YOUR_KEY_HERE pela sua chave real. Nunca commite chaves no controle de versão.

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