DocsMCP 연동API Key 관리

API Key 관리

API Key를 생성하고 관리하는 방법을 알아봅니다.

API Key 관리

API Key는 MCP 서버 연동 및 프로그래밍 방식의 링크 관리를 위한 인증 수단입니다. 워크스페이스 설정에서 API Key를 생성하고 관리할 수 있습니다.

API Key 생성

  1. 대시보드에서 설정 > API 키 페이지로 이동합니다.
  2. API 키 생성 버튼을 클릭합니다.
  3. 키 이름을 입력하고 생성 버튼을 클릭합니다.
  4. 생성된 키를 안전한 곳에 저장합니다.

중요: API Key는 생성 시 한 번만 표시됩니다. 분실 시 새로운 키를 생성해야 합니다.

API Key 형식

API Key는 el_ 접두사로 시작하는 43자리 문자열입니다:

el_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789abcd
  • el_: Edgelink API Key 식별 접두사
  • 이후 40자: 랜덤 영문+숫자 조합

권한

API Key는 생성 시 다음 기본 권한이 부여됩니다:

권한설명
link:create단축 링크 생성
link:read단축 링크 조회
link:list단축 링크 목록 조회

API Key 폐기

더 이상 사용하지 않는 키는 폐기할 수 있습니다:

  1. 설정 > API 키 페이지에서 폐기할 키의 메뉴를 클릭합니다.
  2. 폐기를 선택합니다.
  3. 확인 다이얼로그에서 폐기를 클릭합니다.

폐기된 키는 즉시 비활성화되며, 되돌릴 수 없습니다.

보안 권장 사항

  • API Key를 코드에 하드코딩하지 마세요. 환경 변수를 사용하세요.
  • 사용하지 않는 키는 즉시 폐기하세요.
  • 키가 노출되었다면 즉시 폐기하고 새로운 키를 생성하세요.
  • 워크스페이스의 OWNER 또는 ADMIN 역할만 API Key를 관리할 수 있습니다.