API 키 (자동화 프로그램용)
Starter 이상 요금제의 조직에서 쓸 수 있습니다.
API 키가 필요한 때
API 키는 사람이 로그인할 수 없는 프로그램이 ARC를 쓸 때 필요합니다. 예를 들면 이런 것입니다.
- 개발 작업이 끝날 때마다 Synapse에 작업기록을 올리는 스크립트
- 매일 밤 주문 내용을 정리해 시트에 넣는 자동 작업
사람은 키가 필요 없습니다. 직원이 Claude·ChatGPT·Claude Code를 ARC에 연결할 때는 ARC에 로그인해서 연결합니다. 이 방법은 Claude·ChatGPT·Claude Code에 ARC 연결하기에 있고, 허용 여부는 API 제어에서 정합니다.
키 발급하기
관리 콘솔 › 보안 › API 키에서 이름과 소유자를 고르고 키 발급을 누릅니다. 발급하면 키 값이 바로 보입니다. 복사해서 안전한 곳에 보관하세요. 창을 닫은 뒤에도 목록의 보기로 다시 꺼낼 수 있습니다.
프로그램은 키를 요청 머리글에 넣어 보냅니다. Synapse 적재 API는 x-synapse-key, ARC MCP는 Authorization: Bearer 머리글입니다(Synapse 적재 API).
목록의 칸
| 칸 | 뜻 |
|---|---|
| 키 | 키 값의 앞부분입니다. |
| 이름 | 발급할 때 붙인 이름과 범위(보기·기록 또는 보기·만들기·고치기)입니다. |
| 소유자 | 이 키가 누구의 권한으로 움직이는지입니다. 키는 소유자가 볼 수 있는 것만 다룹니다. 소유자의 권한이 줄면 키도 줄어듭니다. |
| 적재 위치 | 이 키로 올린 Synapse 작업기록이 어느 공유 드라이브·폴더에 쌓일지입니다. 정하지 않으면 워크스페이스 기본 위치(관리 콘솔 › 연동의 Synapse 적재 위치)를 씁니다. |
| 상태 | 사용 중인지 중지인지입니다. |
| 마지막 사용 | 키가 마지막으로 쓰인 날입니다. |
키로 할 수 있는 일
- 기본: 소유자가 볼 수 있는 모든 것을 보기, 그리고 Synapse에 작업기록 남기기
- 만들기·고치기 허용을 발급할 때 체크하면: 문서·시트·일정·할 일을 만들고 고치는 도구가 더해집니다.
키에서 허용해도 API 제어가 위에서 막습니다. 예를 들어 소유자가 속한 조직 단위가 보기만으로 설정되어 있으면, 만들기·고치기를 허용한 키도 보기만 합니다. 휴지통으로 옮기기·일정 지우기 같은 되돌리기 어려운 일은 어느 키로도 못 합니다.
회수하기
목록에서 회수를 누르면 그 키를 쓰던 프로그램의 접근이 즉시 끊깁니다. 다시 쓰게 하려면 새 키를 발급하세요.
안전하게 쓰기
- 키 값은 비밀번호처럼 다루세요. 메신저·메일·코드 저장소에 올리지 마세요.
- 키 하나를 프로그램 하나에 쓰고, 이름을 용도로 지으세요(예: 「주문정리-야간」). 문제가 생겼을 때 그 키만 회수할 수 있습니다.
- 마지막 사용이 몇 달 전이거나 비어 있는 키는 회수하세요.
- 퇴사한 사람이 소유자인 키는 회수하고 새 소유자로 다시 발급하세요.
키 발급·보기·회수는 관리 로그에 남습니다. 사용자는 자기 이름으로 발급된 키를 내 계정 › 보안 및 로그인 › 연결된 앱 및 서비스에서 볼 수 있습니다.
자주 묻는 질문
- 직원이 Claude를 쓰려면 API 키가 필요한가요?
- 아니요. 직원은 ARC에 로그인해서 연결합니다. API 키는 스크립트·자동 작업 같은 프로그램용입니다.
- 키를 잃어버리면 어떻게 하나요?
- 목록에서 보기를 눌러 키 값을 다시 볼 수 있습니다. 예전 방식으로 발급한 키는 볼 수 없으니 새로 발급하세요.