본문으로 건너뛰기
번역된 페이지

이 페이지는 AI의 도움을 받아 영어에서 번역되었습니다. 두 내용이 다를 경우 영어 버전을 기준으로 합니다.

reload_credentials

--env.file 플래그로 지정한 dotenv 형식 파일을 서버의 프로세스 환경으로 다시 로드한 다음, 각 프로바이더의 자격 증명 확인 상태를 보고합니다. 이를 통해 환경이 프로세스 시작 시점에 고정되는 문제가 해결됩니다. 세션 도중에 디스크에 기록되거나 교체된 자격 증명이 재시작 없이 실행 중인 서버에 반영됩니다.

env 파일은 프로세스 환경을 대체하지 않고 그 위에 겹쳐 적용됩니다. 자격 증명 확인은 항상 요청 시점의 실제 프로세스 환경을 읽습니다. 따라서 프로세스 시작 시 이미 있던 변수(셸 또는 클라이언트의 env 블록에서 설정된 변수)는 --env.file 플래그 사용 여부와 관계없이 계속 작동합니다. 다시 로드할 때는 파일에 있고 값이 비어 있지 않은 키만 기록되며, 설정이 해제되는 변수는 없습니다. 따라서 다시 로드가 실패하거나 일부만 완료되더라도 이전에 작동하던 자격 증명은 유지됩니다.

시크릿 값은 반환되지 않으며 로그나 감사 로그에도 기록되지 않습니다. 이 도구는 변수 이름과 상태만 보고합니다. --env.file 플래그가 구성되지 않은 경우 이 도구는 상태만 확인하는 기능으로 축소됩니다. 쿼리가 자격 증명 확인 단계에서 실패하면 MCP 오류에 reload_credentials 도구를 호출한 후 다시 시도하도록 에이전트에 안내하는 힌트가 포함되므로, 에이전트형 클라이언트가 스스로 복구할 수 있습니다.

노트

StackQL v0.10.542 이후 릴리스에서 사용할 수 있습니다.

참고 항목: [ MCP 개요 ] [ 자격 증명 로드 및 다시 로드 ] [ server_info ] [ Claude Desktop ]


입력​

인수필수설명
provider아니요상태 보고서의 범위를 하나의 프로바이더로 제한합니다. 생략하면 모든 프로바이더가 보고됩니다.

출력​

렌더러형태
테이블env 파일 로드 결과 및 자격 증명 확인 상태가 포함된 프로바이더당 1행

구조화된 페이로드에는 다음 필드가 포함됩니다.

필드설명
env_file구성된 --env.file 경로입니다(구성되지 않은 경우 비어 있음).
env_file_sourced이번 호출에서 파일을 찾아 로드한 경우 true입니다.
sourced_vars파일에서 설정된 환경 변수의 이름입니다. 이름만 포함되며 값은 포함되지 않습니다.
providers프로바이더당 1행입니다(아래 참조).

각 providers 행에는 다음 열이 있습니다.

열설명
provider프로바이더 이름입니다.
auth_type프로바이더에 구성된 인증 형식입니다.
sourced_from자격 증명을 가져온 위치입니다(예: env:OKTA_SECRET_KEY, file:/path/key.json, inline 또는 none).
statusok, unresolved 또는 not_checked입니다.
detailunresolved인 경우의 오류 텍스트입니다.

자격 증명 바이트 경로 밖에서 인증하는 인증 형식(대화형 gcloud, azure CLI, oauth2 클라이언트 자격 증명, 역할 수임 체인, OCI 서명, null)은 not_checked 상태를 보고합니다.


게이트 제어​

read_only 모드를 포함한 모든 서버 모드에서 허용됩니다. 이 도구는 서버 자체의 프로세스 환경 외에는 아무것도 변경하지 않습니다.

reverse_proxy 백엔드 모드에서는 지원되지 않습니다. 이 모드에서는 쿼리가 원격 stackql 서버 프로세스에서 실행되므로, 이 도구는 백엔드 서버에서 자격 증명을 다시 로드하도록 사용자에게 안내하는 오류를 반환합니다.


예제​

StackQL MCP 서버가 등록된(--env.file 플래그로 시작된) MCP 클라이언트에서 다음 프롬프트를 사용해 보세요:

My okta query failed with a credential error - I've just written the key
to the credentials file. Reload credentials and retry the query.