에이전트 토큰 발급하고 폐기하기

Claude Code나 Codex 같은 AI 도구에 퍼널브레인을 맡기려면, 그 도구가 내 계정에 들어올 수 있는 열쇠가 필요합니다. 퍼널브레인에서는 이 열쇠를 에이전트 액세스 토큰이라고 부릅니다. 토큰은 이름과 권한, 만료 시점을 정해서 직접 발급하고, 더 이상 필요 없으면 언제든 폐기할 수 있습니다. 이 글에서는 설정의 에이전트 토큰 화면에서 토큰을 발급하고, 발급 직후 값을 복사하고, 목록을 확인하고, 폐기하는 순서를 차례로 안내합니다.

1. 에이전트 토큰 화면은 어디에 있나요

왼쪽 사이드바의 시스템 묶음에서 설정을 누르면 상단에 탭 줄이 보이고, 그 안에 에이전트 토큰 탭이 있습니다. 탭을 누르면 맨 위에 에이전트 액세스 토큰 설명 카드가 나옵니다. 카드에는 AI 도구가 브라우저 없이 원스톱 마케팅 설계를 직접 조작할 수 있게 하는 토큰이며, 토큰마다 권한을 좁힐 수 있고 언제든 개별 폐기할 수 있다고 적혀 있습니다.

이 화면 아래쪽에는 MCP 연동 — Claude에서 바로 쓰기 안내, 새 토큰 발급, 발급된 토큰 카드가 차례로 이어집니다. MCP 연결 방법은 별도의 글에서 다루고, 이 글은 토큰 자체를 다루는 방법에 집중합니다.

2. 새 토큰 발급하기

새 토큰 발급 카드의 입력칸을 위에서부터 채웁니다.

1. 이름: 어떤 도구에 준 토큰인지 나중에 알아보기 위한 라벨입니다. 예를 들어 "회사 PC Claude Code"처럼 도구와 기기를 적어 두면 목록에서 구분하기 쉽습니다. 비워 두면 "에이전트 토큰"이라는 이름으로 만들어집니다.
2. 권한 (스코프): 세 가지 중 하나 이상을 고릅니다. 처음에는 read만 선택되어 있습니다.
3. 만료: 30일, 90일, 1년, 만료 없음 중에서 고릅니다. 처음 선택값은 90일입니다.
4. 토큰 발급 버튼을 누릅니다.

권한은 이렇게 나뉩니다

권한	화면의 설명	할 수 있는 일
read	진행 상태·결과 조회만 가능	상태와 결과를 읽기만 합니다.
write:draft	리서치·생산 등 생성 실행 (크레딧이 소모됩니다)	AI가 리서치나 콘텐츠 생성을 실행합니다.
write:approve	단계 승인까지 위임	단계마다 사람이 하던 승인까지 AI가 대신합니다.

원스톱 마케팅 설계는 단계마다 사람이 승인하도록 만들어져 있습니다. write:approve를 주면 그 승인까지 AI가 대신하게 되므로, 내용을 직접 확인하고 넘어가고 싶다면 write:draft까지만 주라고 화면에서도 안내합니다.

3. 발급 직후 토큰 값 복사하기

발급하면 같은 화면이 다시 열리고, 맨 위쪽에 초록색 테두리의 발급된 토큰 — 지금 한 번만 표시됩니다 카드가 나타납니다. 서버에는 해시로만 저장되어 다시 확인할 수 없으니, 지금 복사해 안전한 곳에 보관하라는 안내가 함께 보입니다. 토큰 값 자체를 누르거나 오른쪽의 복사 버튼을 누르면 복사됩니다. 아래 이미지는 토큰 값을 가려서 보여 드립니다.

토큰 값 아래의 Claude Code에 바로 연결하기 영역은 이 토큰을 넣은 연결 명령을 보여 줍니다. 이 값은 다시 볼 수 없으므로 발급한 직후에 사용할 도구에 바로 넣어 두시는 것이 좋습니다.

4. 발급된 토큰 목록 보기

화면 맨 아래 발급된 토큰 카드에서 지금까지 발급한 토큰을 표로 봅니다. 열은 이름, 권한, 마지막 사용, 만료, 상태입니다. 아직 한 번도 쓰지 않은 토큰은 마지막 사용 칸에 줄표가 보이고, 만료일은 날짜로 표시됩니다. 상태는 사용 중, 만료됨, 폐기됨 중 하나이며, 사용 중인 토큰 줄에만 폐기 버튼이 있습니다.

5. 토큰 폐기하기

도구를 더 이상 쓰지 않거나 토큰 값이 노출됐다면 바로 폐기하세요. 폐기할 토큰 줄 오른쪽의 폐기를 누르면 "이 토큰을 폐기하면 해당 도구는 즉시 접근할 수 없습니다. 계속할까요?"라는 확인 창이 뜹니다. 확인하면 그 줄의 상태가 폐기됨으로 바뀌고 폐기 버튼이 사라집니다. 폐기한 토큰은 목록에 폐기됨 상태로 남아 기록을 확인할 수 있습니다.

이렇게 활용해 보세요

• 도구마다 토큰을 따로 발급하고 이름에 도구와 기기를 적어 두면, 하나가 문제가 됐을 때 그 토큰만 폐기할 수 있습니다.
• 처음에는 read 또는 write:draft로 시작해 보세요. 결과를 직접 확인하고 승인하는 흐름이 유지됩니다.
• 임시로 쓰는 도구라면 만료를 짧게 두면, 폐기를 잊어도 기간이 지나 자동으로 쓸 수 없게 됩니다.

알아 두실 점

• 토큰 값은 발급 직후 한 번만 보입니다. 놓쳤다면 그 토큰을 폐기하고 새로 발급하세요.
• 권한을 하나도 고르지 않으면 발급되지 않고 "권한(스코프)을 하나 이상 선택하세요."라는 안내가 나옵니다.
• 에이전트 토큰은 플랜과 역할에 따라 사용할 수 있는 계정이 정해져 있고, 발급할 수 있는 개수도 플랜별로 다릅니다. 사용할 수 없는 계정에는 이 계정에서는 사용할 수 없습니다 안내가 나타나고, 한도에 이른 경우에는 쓰지 않는 토큰을 폐기한 뒤 다시 발급할 수 있습니다.
• 토큰을 가진 도구는 부여된 권한 안에서 내 계정의 자원을 다룹니다. 토큰 값을 다른 사람과 공유하거나 공개된 곳에 붙여 넣지 마세요.
• 설정의 연동 관리 탭은 퍼널체인저 연결을 다루는 별도 화면입니다.