← Voltar ao Acesso por IA

📘 Manual do Acesso por IA

Com o Acesso por IA, a sua inteligência artificial (Claude, n8n, Zapier ou um script seu) consegue ler os seus perfis e roteiros e conversar com você sobre eles. Exemplo: "me mostre o roteiro 12 do perfil da Raposa" ou "quais vídeos estão agendados esta semana?".

Disponível no plano Agência. O acesso é somente leitura: a IA não cria, não edita, não apaga, não agenda e não publica nada. Ela só enxerga o que é seu.

1. Criar a sua chave

  1. Entre no sistema e, no Estúdio, clique em 🔑 Acesso por IA.
  2. Digite um nome para a chave (ex.: "Meu Claude") e clique em Criar chave.
  3. Copie a chave na hora. Ela começa com rk_ e só aparece uma vez. Por segurança, o sistema guarda apenas uma versão codificada dela.
  4. Guarde como uma senha. Se perder, revogue e crie outra.

Cada conta pode ter até 5 chaves ativas. Crie uma por aplicativo. Cada chave vale por 1 ano e aceita até 60 pedidos por minuto.

2. Instalar no seu Claude

Opção A: Claude Code (terminal)

Rode este comando, trocando SUA_CHAVE pela chave copiada:

claude mcp add --transport http reels-ia https://reels.girantech.com.br/mcp --header "Authorization: Bearer SUA_CHAVE"

Para conferir: claude mcp list. Depois, dentro do Claude Code, peça: "liste os meus perfis do Reels IA".

Opção B: Claude Desktop (Windows ou Mac)

Precisa do Node.js instalado (baixe em nodejs.org, versão LTS). Depois:

  1. Abra o Claude Desktop → Configurações → Desenvolvedor → Editar configuração. Abre o arquivo claude_desktop_config.json.
  2. Coloque o trecho abaixo (se já houver mcpServers, acrescente só o bloco reels-ia), trocando SUA_CHAVE:
{
  "mcpServers": {
    "reels-ia": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://reels.girantech.com.br/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer SUA_CHAVE" }
    }
  }
}
  1. Salve, feche e abra o Claude Desktop de novo. Procure o ícone de ferramentas na caixa de mensagem: deve aparecer "reels-ia" com 5 ferramentas.

Opção C: n8n, Zapier, Make ou um script (API)

Use um pedido HTTP GET com o cabeçalho Authorization: Bearer SUA_CHAVE. Veja os endereços no item 4.

Claude pelo navegador (claude.ai): os conectores de lá exigem um tipo de login (OAuth) que ainda não está disponível. Use o Claude Code ou o Claude Desktop acima. Avisaremos quando liberar.

3. O que perguntar para a IA

A IA também pode usar os prompts lidos para ajudar você a revisar, resumir ou escrever variações, mas qualquer criação ou alteração dentro do sistema continua sendo feita por você, no painel.

4. Referência da API

Endereço base: https://reels.girantech.com.br · Todos os pedidos usam GET e o cabeçalho Authorization: Bearer SUA_CHAVE. As respostas são em JSON.

EndereçoO que devolve
/api/v1/perfisLista dos seus perfis (id, nome, tema, tipo, descrição, hashtags, horários fixos e total de roteiros).
/api/v1/perfis/IDUm perfil com DNA, regras, pergunta para comentários e idioma da voz. O ID pode ser o id ou o nome do perfil.
/api/v1/perfis/ID/roteirosRoteiros do perfil, do número menor para o maior. Aceita ?busca=texto, ?limite=30 (até 100) e ?pagina=1.
/api/v1/perfis/ID/roteiros/12Os prompts completos (imagem de referência e vídeo) do roteiro 12. Também aceita parte do nome do roteiro.
/api/v1/agendadosVídeos agendados para o futuro (perfil, arquivo, data, título e redes). Use ?perfil=ID para filtrar.

Exemplo com curl

curl -H "Authorization: Bearer SUA_CHAVE" https://reels.girantech.com.br/api/v1/perfis

curl -H "Authorization: Bearer SUA_CHAVE" "https://reels.girantech.com.br/api/v1/perfis/ID_DO_PERFIL/roteiros?limite=10"

curl -H "Authorization: Bearer SUA_CHAVE" https://reels.girantech.com.br/api/v1/perfis/ID_DO_PERFIL/roteiros/12

Exemplo de resposta (roteiros)

{
  "perfil": "Menina do Churrasco",
  "total": 125,
  "pagina": 1,
  "porPagina": 10,
  "roteiros": [
    { "numero": 1, "nome": "Roteiro Menina 01 - Cortando o bife", "prompts": 2 },
    { "numero": 2, "nome": "Roteiro Menina 02 - Primeiro pedaço", "prompts": 2 }
  ]
}

5. As 5 ferramentas do servidor MCP

FerramentaPara que serve
listar_perfisLista os perfis.
ver_perfilMostra o DNA e as regras de um perfil (perfil = id ou nome).
listar_roteirosLista os roteiros (perfil, e opcionalmente busca, limite, pagina).
ver_roteiroMostra os prompts de um roteiro (perfil e roteiro = número ou parte do nome).
listar_agendadosLista os vídeos agendados (perfil opcional).

6. Problemas comuns

O que apareceO que significa e o que fazer
401 "Chave de acesso ausente ou inválida"Chave errada, apagada, expirada ou revogada. Confira se copiou a chave inteira (começa com rk_) e se escreveu Bearer antes dela. Se preciso, crie outra.
402 ao criar a chaveO seu plano não inclui o acesso por IA. Ele está no plano Agência.
403 "disponível no plano Agência"Sua conta saiu do plano Agência (venceu ou foi trocado). As chaves voltam a funcionar quando o plano voltar.
404 "Perfil/Roteiro não encontrado"O id ou o número não existe na sua conta. Use listar_perfis para ver os ids.
409 "Mais de um roteiro combina"O nome informado serve para vários roteiros. Use o número ou o nome completo.
429 "Muitos pedidos"Passou de 60 pedidos em um minuto. Espere um minuto.
O Claude Desktop não mostra o "reels-ia"Veja se o Node.js está instalado (node -v no terminal), se o JSON está sem vírgulas sobrando e se você fechou e abriu o Claude Desktop de novo.

7. Segurança

Dúvidas

Escreva para girantechsistemas@gmail.com.