본문으로 건너뛰기

API 키로 연결하기

claude.ai 나 ChatGPT 를 사용하신다면 이 페이지는 건너뛰셔도 됩니다.
그 두 서비스는 주소만 넣고 로그인해 허용하면 되므로 API 키가 필요하지 않습니다. Claude 에 연결하기 또는 ChatGPT 에 연결하기를 보세요.

이 페이지는 Claude Desktop 처럼 설정 파일을 직접 편집해서 연결하는 도구를 쓰시는 분을 위한 것입니다.

API 키 발급하기​

  1. 앤트포켓 웹에서 팀원 및 권한 페이지로 이동하세요. 사이드바 메뉴에서 팀원 및 권한 입니다.

  2. 페이지 맨 아래 API Key 영역에서 생성하기 를 누르세요.

  1. API Key 발급 창이 열립니다.

    • 이름 (용도 라벨, 선택) — 나중에 어떤 키인지 알 수 있게 용도를 적어두세요. (예: 노트북 Claude Desktop)
    • 권한 — 부여할 권한을 고르세요. 각 권한의 의미는 권한과 연결 관리에 정리되어 있습니다.
  2. 발급하기 를 누르세요.

  1. API Key 정보 창에 발급된 키가 나타납니다. 클립보드에 복사하기 를 눌러 복사하고 안전한 곳에 보관하세요.
키는 이 화면에서만 볼 수 있습니다

발급된 API 키는 다시 조회할 수 없습니다. 안전한 곳에 복사해 놓으세요.
창을 닫은 뒤에는 목록에 앞뒤 일부만 가려진 형태로 표시됩니다. 잃어버리면 삭제하고 새로 발급받아야 합니다.

발급 규칙
  • 부여할 수 있는 권한은 본인이 그 스페이스에서 갖고 있는 권한까지입니다.
  • 키는 한 스페이스당 사용자별로 최대 5개까지 만들 수 있습니다.
  • 키에는 만료가 없습니다. 쓰지 않는 키는 삭제하세요.

도구에 연결 정보 입력하기​

도구 설정에 아래 두 가지를 넣으세요.

연결 주소

https://antpocket.io/mcp

인증 헤더

apikey: Bearer sk_live_여기에발급받은키
Bearer 를 빼지 마세요

헤더 값은 반드시 Bearer 로 시작해야 합니다. (Bearer 다음에 공백 하나)
이 앞부분을 빼면 키의 앞자리가 잘려나가 인증에 실패합니다.

앤트포켓에 붙는 도구는 표준 방식을 쓰므로, 도구 쪽 설명서에서 "원격 서버 주소" 와 "요청 헤더" 를 넣는 자리를 찾아 위 두 값을 입력하시면 됩니다.

발급한 키의 권한 범위 안에서만 동작하며, 키에 묶인 스페이스 하나만 다룹니다. 이 점은 claude.ai, ChatGPT 연결과 같습니다.

키를 삭제하기​

팀원 및 권한 페이지의 API Key 목록에서 해당 키의 삭제 를 누르세요.
삭제하면 그 키로 붙어 있던 도구는 즉시 연결이 끊어집니다.

내가 발급한 키와, 스페이스 소유자라면 다른 팀원이 발급한 키도 삭제할 수 있습니다.
팀원이 스페이스에서 나가거나 추방되면 그 팀원이 발급한 키는 자동으로 삭제됩니다.

키를 바꾸려면

권한을 바꾸거나 키를 새로 발급받으려면, 기존 키를 삭제하고 새로 만든 뒤 도구 설정의 헤더 값을 바꿔주세요.
발급된 키의 권한은 나중에 수정할 수 없습니다.

연동이 잘 안되시면 아래 앤트포켓에 문의해주세요.