API 키로 연결하기
claude.ai 나 ChatGPT 를 사용하신다면 이 페이지는 건너뛰셔도 됩니다.
그 두 서비스는 주소만 넣고 로그인해 허용하면 되므로 API 키가 필요하지 않습니다. Claude 에 연결하기 또는 ChatGPT 에 연결하기를 보세요.
이 페이지는 Claude Desktop 처럼 설정 파일을 직접 편집해서 연결하는 도구를 쓰시는 분을 위한 것입니다.
API 키 발급하기
-
앤트포켓 웹에서 팀원 및 권한 페이지로 이동하세요. 사이드바 메뉴에서 팀원 및 권한 입니다.
-
페이지 맨 아래 API Key 영역에서
생성하기를 누르세요.
-
API Key 발급 창이 열립니다.
- 이름 (용도 라벨, 선택) — 나중에 어떤 키인지 알 수 있게 용도를 적어두세요. (예: 노트북 Claude Desktop)
- 권한 — 부여할 권한을 고르세요. 각 권한의 의미는 권한과 연결 관리에 정리되어 있습니다.
-
발급하기를 누르세요.
- API Key 정보 창에 발급된 키가 나타납니다.
클립보드에 복사하기를 눌러 복사하고 안전한 곳에 보관하세요.
발급된 API 키는 다시 조회할 수 없습니다. 안전한 곳에 복사해 놓으세요.
창을 닫은 뒤에는 목록에 앞뒤 일부만 가려진 형태로 표시됩니다. 잃어버리면 삭제하고 새로 발급받아야 합니다.
- 부여할 수 있는 권한은 본인이 그 스페이스에서 갖고 있는 권한까지입니다.
- 키는 한 스페이스당 사용자별로 최대 5개까지 만들 수 있습니다.
- 키에는 만료가 없습니다. 쓰지 않는 키는 삭제하세요.
도구에 연결 정보 입력하기
도구 설정에 아래 두 가지를 넣으세요.
연결 주소
https://antpocket.io/mcp
인증 헤더
apikey: Bearer sk_live_여기에발급받은키
헤더 값은 반드시 Bearer 로 시작해야 합니다. (Bearer 다음에 공백 하나)
이 앞부분을 빼면 키의 앞자리가 잘려나가 인증에 실패합니다.
앤트포켓에 붙는 도구는 표준 방식을 쓰므로, 도구 쪽 설명서에서 "원격 서버 주소" 와 "요청 헤더" 를 넣는 자리를 찾아 위 두 값을 입력하시면 됩니다.
발급한 키의 권한 범위 안에서만 동작하며, 키에 묶인 스페이스 하나만 다룹니다. 이 점은 claude.ai, ChatGPT 연결과 같습니다.
키를 삭제하기
팀원 및 권한 페이지의 API Key 목록에서 해당 키의 삭제 를 누르세요.
삭제하면 그 키로 붙어 있던 도구는 즉시 연결이 끊어집니다.
내가 발급한 키와, 스페이스 소유자라면 다른 팀원이 발급한 키도 삭제할 수 있습니다.
팀원이 스페이스에서 나가거나 추방되면 그 팀원이 발급한 키는 자동으로 삭제됩니다.
권한을 바꾸거나 키를 새로 발급받으려면, 기존 키를 삭제하고 새로 만든 뒤 도구 설정의 헤더 값을 바꿔주세요.
발급된 키의 권한은 나중에 수정할 수 없습니다.