Entenda os agentes de IA e a API
O que agentes de IA como Claude, ChatGPT, Claude Code, Codex e Cursor podem fazer no seu workspace do Clevera, as formas de conectá-los, planos (Pro e superiores), limites, funções, custos e segurança.
AI agents & API permite que aplicativos de IA como Claude, ChatGPT, Claude Code, Codex e Cursor, além de seus próprios scripts, trabalhem no seu workspace do Clevera: encontrar gravações, solicitar vídeos, clipes sociais e artigos, exportar vídeos e trabalhar em sites de documentação. Você decide exatamente o que cada agente pode fazer, quantos créditos ele pode gastar e quando uma pessoa precisa aprovar.
O que os agentes podem fazer
| Área | O que um agente pode fazer |
|---|---|
| Vídeos | Listar e ler suas gravações, vídeos, artigos e transcrições; solicitar vídeos de instruções, demonstrações de produtos, limpezas e vídeos estilizados a partir de uma gravação, clipes sociais, artigos a partir de uma gravação e traduções de vídeo; exportar MP4s de até 4K; adicionar imagens, vídeos e PDFs aos seus uploads. |
| Sites de documentação | Ler, redigir, organizar, traduzir e publicar páginas de sites de documentação e o changelog, responder leitores a partir de páginas publicadas, ler insights de leitores e alterar configurações de sites ou criar sites. |
Os agentes ainda não podem realizar pesquisas em sites ou tutoriais gravados.
O agente faz a solicitação; a IA do Clevera cria o vídeo ou artigo, da mesma forma que quando você o inicia no aplicativo. Um agente nunca vê mais do que seu proprietário poderia ver: gravações em uma coleção privada permanecem ocultas, a menos que o proprietário do token tenha acesso.
Formas de conectar
| Forma | Para | Configurar em |
|---|---|---|
| Token de API | Claude Code, Codex CLI, Cursor, qualquer cliente MCP e seus próprios scripts via REST API | Tokens → Novo token. Veja Criar um token de API. |
| Aplicativos conectados | Claude (claude.ai) e ChatGPT como um conector personalizado; sem token, você faz login | O aplicativo, com a URL do conector de Aplicativos conectados. Veja Conectar aplicativos e agentes de IA. |
| REST API | Scripts e serviços de backend | Um token de API. Veja Usar a REST API. |
O servidor MCP está em https://app.clevera.ai/mcp e a REST API está em https://app.clevera.ai/api/v1.
Encontrar a página
Abra o menu do workspace e escolha AI agents & API. Em sites de documentação, ela também está na página inicial de Docs e no menu de Configurações de um site. A página ("Deixe o Claude, Codex, ChatGPT e seus scripts trabalharem neste workspace.") possui cinco abas, cada uma com sua contagem:
| Aba | O que há nela |
|---|---|
| Tokens | Seus tokens de API; proprietários e administradores veem todos os tokens. Gerenciar tokens de API |
| Aplicativos conectados | A URL do conector e os aplicativos que as pessoas conectaram. Conectar aplicativos e agentes de IA |
| Solicitações do agente | Trabalho pago aguardando aprovação de uma pessoa, com um selo de contagem e o histórico. Controlar gastos e aprovações de agentes |
| Webhooks | Notificações assinadas para seus próprios sistemas. Configurar webhooks |
| Atividade | O que os agentes fizeram. Ler a atividade do agente |
Planos
O AI agents & API está disponível nos planos Pro, Negócios e Personalizado. Isso inclui tokens de API, conectores para Claude e ChatGPT e webhooks.
Nos planos Free e Starter, a página exibe "AI agents & API estão incluídos no Pro": "Faça upgrade para permitir que Claude, ChatGPT e seus scripts trabalhem neste workspace. Tokens e aplicativos existentes param de funcionar até lá; você ainda pode revogá-los aqui." Clique em Fazer upgrade para o Pro. Controles bloqueados dizem "O acesso à API e ao agente está disponível no Pro e superior.", "Os conectores Claude.ai e ChatGPT estão disponíveis no Pro e superior." ou "Webhooks estão disponíveis no Pro e superior."
| Limite | Pro, Negócios, Personalizado |
|---|---|
| Tokens de API ativos por workspace | 50 |
| Aplicativos conectados por pessoa | 20 |
| Webhooks por workspace | 10 |
| Aprovar automaticamente abaixo no máximo | Pro e Negócios: 500 créditos. Personalizado: 1.000 créditos. |
Se o workspace sair do Pro
Nada é excluído, mas tudo é pausado até que você faça o upgrade novamente:
| Após mudar para Starter ou Free | |
|---|---|
| Tokens de API | Permanecem listados e podem ser revogados. Cada chamada é recusada: "A API de agente não está no plano deste workspace. Ela está disponível no Pro e superior." Eles não podem ser regenerados (Regenerar segredo abre a caixa de diálogo de upgrade). |
| Aplicativos conectados | Permanecem listados e podem ser desconectados. Suas chamadas falham; Claude ou ChatGPT podem apenas dizer que não foi possível conectar. |
| Webhooks | Permanecem listados, mas nada é enviado. Enviar evento de teste e Redeliver dizem "Webhooks não estão no seu plano." |
| Solicitações do agente | Aprovar diz "O acesso à API e ao agente não está no seu plano." Negar ainda funciona. |
| Novos tokens | "O acesso à API e ao agente não está no seu plano." |
Fazer o upgrade de volta para o Pro faz com que tokens, aplicativos e webhooks funcionem novamente. Os tokens ainda expiram em suas datas originais.
Quem pode fazer o quê
Um agente atua como a pessoa que criou seu token ou o conectou, dentro do que a função dessa pessoa permite. Ele nunca pode fazer mais do que essa pessoa poderia fazer no aplicativo, e a função é verificada a cada chamada, portanto, uma alteração de função entra em vigor imediatamente.
| Tarefa | Proprietário | Administrador | Editor | Criador de Conteúdo |
|---|---|---|---|---|
| Criar tokens e conectar aplicativos para si mesmo | Sim | Sim | Sim | Sim |
| Ver e revogar todos os tokens e aplicativos no workspace | Sim | Sim | Apenas próprios | Apenas próprios |
| Dar a um agente permissão para solicitar vídeos e gastar créditos | Sim | Sim | Não | Sim |
| Dar a um agente permissão para publicar sites de documentação | Sim | Sim | Sim | Não |
| Aprovar trabalho pago solicitado por agentes | Sim | Sim | Não | Não |
| Gerenciar webhooks | Sim | Sim | Não | Não |
A lista completa está em Permissões de agente.
Quanto custa
- Chamadas de API e MCP são gratuitas: ler, pesquisar, citar e verificar um trabalho não custam créditos. O mesmo vale para exportações de vídeo.
- O trabalho que usa IA custa créditos, da mesma forma que quando você o inicia no aplicativo: vídeos, clipes sociais, artigos a partir de gravações, traduções e páginas de site geradas por IA.
- Um agente só pode iniciar trabalho pago com um token que tenha
credits:spend. Cada início é cotado primeiro e verificado em relação aos limites de gastos do token, e uma pessoa o aprova, a menos que esteja abaixo da linha Aprovar automaticamente abaixo do token. Veja Controlar gastos e aprovações de agentes.
Como o Clevera mantém os agentes seguros
- Tokens sempre expiram: após 7 dias, 30 dias, 90 dias ou 1 ano. Não existe "nunca".
- Segredos são mostrados uma vez. O Clevera armazena apenas uma impressão digital e mostra os últimos quatro caracteres.
- Acesso mínimo. Cada token tem apenas as permissões, sites de documentação e endereços IP que você escolher.
- Pessoas aprovam dinheiro. Um agente não pode aprovar seus próprios gastos; apenas o proprietário do workspace ou um administrador pode.
- Tokens vazados são revogados. Um token do Clevera encontrado em um repositório público do GitHub é revogado automaticamente.
- Atividade incomum é interrompida. Rajadas de chamadas recusadas revogam o token; rajadas de alterações ou gastos o pausam, e o proprietário é notificado.
- Tudo é registrado em Atividade, mantido por 13 meses. As edições de sites de documentação de um agente também aparecem no histórico da página como "Agente nome (token)".