📘 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?".
1. Criar a sua chave
- Entre no sistema e, no Estúdio, clique em 🔑 Acesso por IA.
- Digite um nome para a chave (ex.: "Meu Claude") e clique em Criar chave.
- 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. - 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:
- Abra o Claude Desktop → Configurações → Desenvolvedor → Editar configuração. Abre o arquivo
claude_desktop_config.json. - Coloque o trecho abaixo (se já houver
mcpServers, acrescente só o blocoreels-ia), trocandoSUA_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" }
}
}
}
- 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.
3. O que perguntar para a IA
- "Liste os meus perfis e quantos roteiros cada um tem."
- "Mostre o DNA e as regras do perfil Raposa Cobre."
- "Liste os roteiros do perfil Menina do Churrasco."
- "Abra o roteiro 12 do perfil Turma do Chaves e me dê o prompt do vídeo."
- "Procure os roteiros que falam de churrasco no perfil da Menina."
- "Quais vídeos estão agendados para esta semana e em quais redes?"
- "Compare o roteiro 3 e o roteiro 8 e me diga qual é mais fácil de gerar no Flow."
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ço | O que devolve |
|---|---|
/api/v1/perfis | Lista dos seus perfis (id, nome, tema, tipo, descrição, hashtags, horários fixos e total de roteiros). |
/api/v1/perfis/ID | Um 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/roteiros | Roteiros do perfil, do número menor para o maior. Aceita ?busca=texto, ?limite=30 (até 100) e ?pagina=1. |
/api/v1/perfis/ID/roteiros/12 | Os prompts completos (imagem de referência e vídeo) do roteiro 12. Também aceita parte do nome do roteiro. |
/api/v1/agendados | Ví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
| Ferramenta | Para que serve |
|---|---|
listar_perfis | Lista os perfis. |
ver_perfil | Mostra o DNA e as regras de um perfil (perfil = id ou nome). |
listar_roteiros | Lista os roteiros (perfil, e opcionalmente busca, limite, pagina). |
ver_roteiro | Mostra os prompts de um roteiro (perfil e roteiro = número ou parte do nome). |
listar_agendados | Lista os vídeos agendados (perfil opcional). |
6. Problemas comuns
| O que aparece | O 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 chave | O 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
- Só leitura: a IA não consegue apagar, criar, agendar nem publicar.
- Só o que é seu: cada chave só enxerga os seus perfis, roteiros e agendamentos.
- O que nunca sai: senhas, tokens do Facebook, Instagram, Threads e YouTube, dados de pagamento, marca d'água e imagens.
- Guarde a chave como uma senha. Não cole em conversas, prints ou repositórios públicos.
- Revogue na hora qualquer chave que você não usa mais ou que possa ter vazado (botão Revogar na página Acesso por IA). Ela para de funcionar imediatamente.
- O sistema registra cada uso (qual chave, quando) e mostra o último uso na página.
Dúvidas
Escreva para girantechsistemas@gmail.com.