Comece
Chaves de API
Uma chave abre a API REST, o SDK de Python e o servidor MCP.
URL base e cabeçalho
# base URL https://api.clousd.com/v1 # header Authorization: Bearer cl_live_••••••••
Criar uma chave
Abra Configurações → Conexões: em Acesso → Chaves de API você cria e revoga chaves. A janela Conectar IA cria com um clique uma chave com controle sobre todos os seus celulares e mostra as linhas para colar no Claude Code, no Codex, no Cursor e em outros clientes. A chave aparece uma única vez.
Escopo e aparelhos
Cada chave tem um escopo e uma lista de aparelhos:
| Escopo | O que ela pode fazer |
|---|---|
| read | Listar aparelhos, tirar capturas de tela, observar a tela, ler jobs. Qualquer chamada que altere algo responde 403. |
| control | Tudo acima, mais iniciar, parar, instalar apps, agir na tela e executar tarefas. |
Uma chave vale para todos os celulares da conta ou para uma lista que você escolhe. Um celular fora da lista responde 404, como se não existisse.
Revogar uma chave
Revogar uma chave a desativa na hora, para todos os clientes que a usam. As chaves pertencem à conta, não a uma pessoa, por isso continuam funcionando quando alguém sai da equipe.
Equipe
Uma conta tem donos e operadores (Configurações → Equipe). Os donos cuidam da cobrança, das chaves de API, da equipe e da criação ou exclusão de aparelhos. Os operadores usam os aparelhos atribuídos a eles, sem cobrança, chaves ou exclusão.