인증 정보

Guida의 인증 정보 기능은 API 키, 비밀번호, 토큰, 데이터베이스 연결 정보를 안전하게 다루기 위한 방식입니다. 값은 Windows DPAPI로 암호화되어 사용자의 컴퓨터에 저장됩니다.

저장하는 것

API 키
비밀번호
bearer token
PostgreSQL, MongoDB, S3 호환 스토리지, Elasticsearch 연결 정보
외부 서비스 연결을 위한 자격 증명

스크립트에서 사용

일반 사용자 실행 스크립트에서는 g.secrets.getSecret()으로 값을 가져올 수 있습니다.

const token = await g.secrets.getSecret("my-api-token");
const response = await g.http.makeHttpRequest({
  url: "https://api.example.com/data",
  headers: { Authorization: "Bearer " + token },
});

MCP 시작 스크립트 제한

MCP 시작 스크립트는 g.secrets.getSecret()을 사용할 수 없습니다. 이는 AI 에이전트가 스크립트를 실행해 복호화된 값을 읽고, 워크스페이스 저장소에 저장한 뒤, 나중에 MCP에서 다시 읽어 가는 경로를 막기 위한 것입니다.

같은 이유로 인증 정보를 내부에서 해석하는 일부 외부 데이터베이스 연동도 MCP 시작 스크립트에서 제한됩니다.

MCP 도구에서 보이는 것

MCP 도구는 인증 정보의 이름이나 설명 같은 메타데이터만 다룹니다. 복호화된 값은 반환하지 않습니다.