Conectar um agente de IA
Um agente de IA pode listar, enviar e organizar suas mídias por você. Este guia mostra como dar acesso a ele, com um token ou deixando o app entrar sozinho, quanto deixar ele fazer e como tirar esse acesso de novo.
Para todos que têm uma conta, em qualquer plano.
As imagens mostram um celular. No computador as páginas são iguais, só que mais largas.
Nesta página
O que ele faz
- Apps como Claude Code, Codex, Cursor e Gemini CLI podem se conectar à sua conta por MCP, um jeito padrão de agentes de IA usarem outros serviços.
- Depois de conectado, você pode pedir coisas ao agente com palavras simples, por exemplo mover as fotos das férias para uma pasta nova ou adicionar títulos e descrições aos seus arquivos.
- O agente entra com um token: um código secreto longo que você cria. Quem tiver o token pode fazer na sua conta tudo o que o nível de acesso dele permite, então guarde-o em sigilo, como uma senha.
Criar um token
- Toque no botão do robô no alto da página (Agentes conectados).
- Toque em Novo token.
- Em Rótulo, digite um nome que você vá reconhecer depois, como o nome do app.
- Escolha uma opção em Nível de acesso (mais detalhes abaixo) e toque em Criar token.
Entregue ao seu agente
- Agora você vê Token criado. Toque em Copiar mensagem de configuração.
- Cole a mensagem em uma conversa com seu agente e envie. Um agente que consegue executar comandos, como Claude Code ou Codex, lê nossa página de configuração e adiciona a conexão sozinho. Alguns precisam ser reiniciados antes de poder usá-la.
- Toque em Concluído quando o agente estiver conectado.
Vai configurar um app à mão? Toque em Endpoint MCP para copiar o endereço e passe o token para o app com Copiar token. As configurações para Claude Code, Codex, Cursor, Gemini CLI e outros estão em account.nostr.build/agent-setup.md (em inglês).
Ou deixe o app entrar sozinho
Apps que sabem entrar sozinhos, como Claude Code, Claude Desktop, Cursor e VS Code, não precisam de token. Adicione o nostr.build ao app (as configurações estão em account.nostr.build/agent-setup.md) e ele abre este site no seu navegador.
- Entre na sua conta se for pedido. Você chega à mesma página de um código, com o código já preenchido. Toque em Continuar.
- Confira o nome do app e para onde a página diz que o código é enviado de volta. Para muitos apps, a página também mostra onde o app está publicado, como claude.ai para o Claude Code. Verificamos que os dados do app vêm mesmo desse endereço; o nome sozinho é só o que o app diz sobre si mesmo. Depois escolha um Nível de acesso. Aqui você pode dar mais do que o app pede: a maioria pede Somente leitura.
- Toque em Aprovar. Seu navegador volta para o app, que agora está conectado. Ele aparece em Agentes conectados.
Ou aprove um código de conexão
Agentes que não sabem entrar sozinhos pedem com um código. O agente mostra um código curto (como ABCD-2345) e um link.
- Entre na sua conta primeiro e depois abra o link: o código já vem preenchido. Ou em Agentes conectados, toque em Aprove-o e digite o código em Código de conexão. Depois toque em Continuar.
- Confira o nome do agente e o acesso que ele pede. Você pode dar menos, nunca mais.
- Toque em Aprovar. O agente recebe o token sozinho; você nunca o vê. Depois ele aparece em Agentes conectados.
Escolha o nível de acesso certo
- Somente leitura: o agente pode ver suas pastas, arquivos, conta e notificações, sem mudar nada.
- Leitura e escrita: ele também pode enviar arquivos, criar pastas, mover arquivos, editar títulos e descrições e definir a capa de um vídeo. Nos planos com AI Studio, ele também pode criar imagens com IA, e os modelos pagos usam seus Créditos AI.
- Acesso completo, incluindo exclusão: ele também pode excluir arquivos e pastas. Excluir uma pasta move os arquivos dela para Início, mas o agente também pode excluir uma pasta junto com tudo o que tem dentro. Arquivos excluídos não podem ser recuperados.
Ver e revogar tokens
- Abra Agentes conectados. Cada token mostra o nome, o nível de acesso, quando foi criado e quando foi usado pela última vez, com o endereço IP e o app de onde veio (Nunca usado se ainda não foi). Isso é atualizado no máximo uma vez por hora.
- Toque em Revogar ao lado de um token e depois em Revogar de novo para confirmar. Qualquer agente que o use perde o acesso na hora. Uma exclusão de pasta que ele já começou ainda termina.
Tokens não expiram sozinhos, então revogue os que você não usa mais. O nome e o nível de acesso de um token não podem ser alterados: crie um token novo e revogue o antigo.
Guias relacionados
Sua biblioteca
Envie do celular ou do computador, organize arquivos em pastas, copie um link para compartilhar, mova e exclua arquivos.
Como entrar e suas contas
Entre com uma senha, sua chave Nostr ou um código, redefina uma senha e troque entre contas.
Quando algo dá errado
O que significam as mensagens de erro e o que fazer: envios, armazenamento, o editor, o login, pagamentos e páginas que não carregam.
Ainda com problemas? O guia Quando algo dá errado explica as mensagens de erro mais comuns, e o guia Obter ajuda mostra como falar com a equipe.