Segredos

Um segredo é uma senha, token ou chave de acesso guardada no cofre da empresa. Você grava o valor uma vez e, a partir daí, ele nunca mais é exibido: agentes, projetos, rotinas e servidores MCP usam o segredo pelo nome, e o valor só é lido no momento em que um agente começa a trabalhar.

Segredos da empresa. A lista mostra nome, versão e onde cada um é usado, nunca o valor.

Quando usar

• Quando um agente precisa de uma chave de acesso para usar um sistema externo.
• Quando um servidor MCP da empresa exige um token.
• Quando uma credencial muda e você precisa trocar o valor em todos os lugares de uma vez.

Como fazer

Criar um segredo

O valor é gravado uma vez e nunca mais aparece.

1. Abra Configurações > Segredos e clique em Novo segredo.
2. Deixe a aba Valor gerenciado escolhida.
3. Preencha o Nome, por exemplo TOKEN_CRM. É por esse nome que você vai escolher o segredo depois. A Chave é opcional e, em branco, é criada a partir do nome.
4. Cole o valor em Valor.
5. Em Descrição, diga para que o segredo serve, sem colocar o valor.
6. Clique em Criar segredo.

Usar o segredo

• Num agente: na aba Configuração do agente, em Variáveis de ambiente, escolha Segredo e selecione o segredo. Veja Execução isolada.
• Numa rotina: na seção Segredos da rotina. Veja Rotinas.
• Num servidor MCP: no header do servidor, com Inserir segredo…. Veja Servidores MCP da empresa.

Trocar o valor, desativar ou excluir

Clique em Abrir na linha do segredo. No painel que abre:

• Atualizar valor grava um valor novo como uma nova versão. Quem usa o segredo recebe o valor novo na próxima execução.
• Desabilitar e Arquivar param o uso do segredo sem apagá-lo: enquanto ele não estiver ativo, não é entregue a ninguém, e onde ele estiver vinculado o uso falha com erro. Ativar volta a liberar. Só um segredo ativo aceita Atualizar valor.
• Excluir apaga o segredo de vez. Onde ele estava vinculado, o uso falha até você escolher outro segredo.
• A aba Uso mostra onde o segredo está vinculado, e Eventos de acesso registra cada vez que ele foi lido numa execução, sem o valor.

Detalhes que importam

• O valor nunca volta. Nem quem criou o segredo consegue ver o valor de novo. Se perder o valor original, crie uma nova versão com Atualizar valor.
• Quem pode. Só Proprietário e Administrador veem e gerenciam segredos. Agentes não consultam a lista de segredos: recebem só os valores que foram vinculados a eles.
• Fora das instruções. Nunca cole uma senha nas instruções de um agente, numa tarefa ou num comentário. Use sempre um segredo.
• Exportação. Ao exportar a empresa, os valores dos segredos não vão no pacote. Veja Exportar.

Relacionado

• Servidores MCP da empresa: credenciais de servidores sempre por segredo.
• Execução isolada: como os segredos chegam ao agente.
• Rotinas: segredos que valem para as tarefas de uma rotina.