API 토큰 권한(스코프, Scope)은 출입증에 적힌 '들어갈 수 있는 층' 같은 것 — 발급한 토큰이 어떤 서비스에서 무엇을 읽고 바꿀 수 있는지 정해 둔 허용 범위예요.
API 토큰은 회사 출입증과 같고, 스코프는 그 출입증에 적힌 '출입 가능 구역'이에요. 같은 출입증이라도 3층만 들어갈 수 있는 것과 모든 층과 금고까지 열 수 있는 것은 위험도가 전혀 다르죠. API 토큰도 발급할 때 '이 토큰은 DNS 기록만 수정 가능', '미팅 생성만 가능'처럼 할 수 있는 일을 골라서 정해요.
강의에서는 강의 사이트에 기능을 붙일 때 스코프 설정이 나와요. 클라우드플레어 토큰으로 DNS 레코드를 쓰려면 Zone-DNS-Edit 권한을 추가해야 하고, 이게 빠져 있으면 AI가 아무리 명령을 보내도 거부돼요. Zoom 앱도 미팅을 자동으로 만들려면 Meeting Write Admin 스코프를 체크해야 해요. 그리고 한 번만 쓰는 작업용 토큰은 사용 기간을 짧게 만들라고 안내해요. AI 에이전트가 '권한이 없다'는 오류를 내면 대부분 이 스코프가 부족한 경우예요.
초보가 흔히 하는 실수는 오류가 귀찮아서 처음부터 모든 권한을 다 체크하는 거예요. 그러면 당장은 편하지만 토큰이 유출됐을 때 피해가 커져요. 필요한 권한만 주는 '최소 권한' 원칙을 지키고, 권한이 부족하면 그때 하나씩 추가하는 게 안전해요. 또 스코프를 바꾼 뒤에는 기존 토큰에 반영되지 않고 새로 발급해야 하는 서비스도 있으니, 수정 후에도 오류가 나면 토큰을 다시 만들어 보세요.
AI와 함께 나만의 사이트·서비스를 만드는 법을 강의에서 배워보세요.