Esta página foi traduzida do inglês com assistência de IA. Se houver diferenças entre as duas, a versão em inglês é a referência.
reload_credentials
Recarrega no ambiente do processo do servidor o arquivo no estilo dotenv indicado pela opção --env.file e, em seguida, informa o status de resolução das credenciais de cada provider. Isso resolve o problema do ambiente fixado na criação do processo: credenciais gravadas ou rotacionadas em disco no meio da sessão chegam ao servidor em execução sem que ele precise ser reiniciado.
O arquivo de ambiente se sobrepõe ao ambiente do processo em vez de substituí-lo: a resolução de credenciais sempre lê o ambiente atual do processo no momento da solicitação, então as variáveis já presentes na criação do processo (do shell ou do bloco env do cliente) continuam funcionando com ou sem --env.file. Na recarga, somente as chaves presentes no arquivo com valores não vazios são gravadas e nenhuma variável é removida, então uma recarga com falha ou parcial preserva as credenciais que já funcionavam.
Os valores dos segredos nunca são retornados, registrados em log nem auditados - a ferramenta informa somente nomes de variáveis e status. Sem --env.file configurado, a ferramenta se reduz a uma simples verificação de status. Quando uma consulta falha na resolução de credenciais, o erro MCP traz uma indicação que orienta o agente a chamar reload_credentials e tentar novamente, para que os clientes agênticos se recuperem sozinhos.
Disponível nas versões do StackQL posteriores à v0.10.542.
Veja também:
[ Visão geral do MCP ] [ (Re)carregamento de credenciais ] [ server_info ] [ Claude Desktop ]
Entradas
| Argumento | Obrigatório | Descrição |
|---|---|---|
provider | Não | Restringe o relatório de status a um provider. Quando omitido, todos os providers são incluídos no relatório. |
Saída
| Renderizador | Formato |
|---|---|
| Tabela | Resultado do carregamento do arquivo de ambiente e uma linha por provider com o status de resolução das credenciais |
O payload estruturado contém:
| Campo | Descrição |
|---|---|
env_file | O caminho de --env.file configurado (vazio quando nenhum está configurado). |
env_file_sourced | true quando o arquivo foi encontrado e carregado nesta chamada. |
sourced_vars | Nomes das variáveis de ambiente definidas a partir do arquivo - somente nomes, nunca valores. |
providers | Uma linha por provider (veja abaixo). |
Cada linha de providers tem:
| Coluna | Descrição |
|---|---|
provider | Nome do provider. |
auth_type | Tipo de autenticação configurado para o provider. |
sourced_from | De onde a credencial foi resolvida, por exemplo env:OKTA_SECRET_KEY, file:/path/key.json, inline ou none. |
status | ok, unresolved ou not_checked. |
detail | Texto do erro quando o status é unresolved. |
Os tipos de autenticação que se autenticam fora do caminho dos bytes de credenciais (gcloud interativo, azure CLI, credenciais de cliente oauth2, cadeias de roles assumidas, assinatura OCI, null) informam not_checked.
Controle
Permitida em todos os modos do servidor, incluindo read_only - a ferramenta não altera nada além do próprio ambiente do processo do servidor.
Não é compatível com o modo de backend reverse_proxy: as consultas são executadas no processo do servidor stackql remoto, então a ferramenta retorna um erro que orienta o usuário a recarregar as credenciais no servidor subjacente.
Exemplo
Experimente este prompt em qualquer cliente MCP que tenha o servidor MCP do StackQL registrado (iniciado com --env.file):
My okta query failed with a credential error - I've just written the key
to the credentials file. Reload credentials and retry the query.