Pular para o conteúdo principal
Página traduzida

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.

observação

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​

ArgumentoObrigatórioDescrição
providerNãoRestringe o relatório de status a um provider. Quando omitido, todos os providers são incluídos no relatório.

Saída​

RenderizadorFormato
TabelaResultado do carregamento do arquivo de ambiente e uma linha por provider com o status de resolução das credenciais

O payload estruturado contém:

CampoDescrição
env_fileO caminho de --env.file configurado (vazio quando nenhum está configurado).
env_file_sourcedtrue quando o arquivo foi encontrado e carregado nesta chamada.
sourced_varsNomes das variáveis de ambiente definidas a partir do arquivo - somente nomes, nunca valores.
providersUma linha por provider (veja abaixo).

Cada linha de providers tem:

ColunaDescrição
providerNome do provider.
auth_typeTipo de autenticação configurado para o provider.
sourced_fromDe onde a credencial foi resolvida, por exemplo env:OKTA_SECRET_KEY, file:/path/key.json, inline ou none.
statusok, unresolved ou not_checked.
detailTexto 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.