API 키 · 환경 변수 넣기
직원이 외부 서비스(날씨 · 지도 · 결제 · 생성형 AI API 등)를 부르려면 그 서비스의 API 키가 필요합니다. 키는 환경 변수에 넣습니다. 값은 암호화해 저장하고, 허용 호스트로 나가는 요청에만 채워집니다. 직원의 작업 환경에는 값이 남지 않습니다.
환경 변수는 매니저, 또는 매니저에게 보안·결재 정책 권한을 받은 멤버만 만들 수 있습니다. 권한을 맡기는 방법은 아래 「멤버에게 맡기기」를 보세요.
만들기
설정 → 개발자 도구 → 나가는 연결 → 환경 변수 → 생성
칸을 채우고 저장을 누릅니다.
| 칸 | 넣는 것 |
|---|---|
| 키 | 서비스 안내에 적힌 이름. 대문자, 숫자, 밑줄(_)만 씁니다. 예: WEATHER_API_KEY |
| 값 | 서비스에서 발급받은 키. 저장한 뒤에는 다시 볼 수 없습니다 |
| 설명 | 용도 메모(선택) |
| 범위 | 직원이 쓸 키는 직원. 외부 도구(MCP) 인증 헤더에도 쓰면 전체 |
| 허용 호스트 | 이 키를 보낼 주소. 여러 개면 쉼표로 나눕니다. 예: api.example.com |
저장하면 목록에 나타납니다. 값은 보이지 않습니다.
자주 막히는 것
- 허용 호스트를 비우면 키가 쓰이지 않습니다. 목록에 「허용 호스트를 지정해야 동작합니다」가 보입니다
- 범위가 「MCP 도구」인 키는 직원이 쓸 수 없습니다. 직원이 부를 키는 「직원」이나 「전체」로 둡니다
- 값을 바꾸면 이전 값은 되돌릴 수 없습니다. 수정 창에서 값을 비워 두면 지금 값이 그대로 남습니다
- 키 이름은 글자 하나까지 맞아야 합니다. 직원은 업무 안내에 적힌 이름으로 키를 찾습니다
멤버에게 맡기기
매니저는 키 등록을 멤버에게 맡길 수 있습니다.
- 직원 화면 위쪽 멤버 → 멤버 관리
- 맡길 멤버 줄의 권한 → 직접 고르기
- 보안·결재 정책을 켭니다
이 권한을 받은 멤버는 결재 강도, 개인정보 가리기, 환경 변수, API 키를 관리할 수 있습니다. 권한 단계 운영자를 고르면 이 권한과 함께 직원 운영과 연동 서비스 연결까지 맡깁니다. 키를 다 넣은 뒤에는 스위치를 다시 꺼도 됩니다.