> For the complete documentation index, see [llms.txt](https://docs.smply.one/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.smply.one/saas-integration/guide-main/anthropic-claude.md). # Anthropic Claude Anthropic Console Admin API와 Claude.ai Enterprise Analytics API를 심플리에 연동하여 조직의 API 비용·토큰 사용량은 물론, Claude Code 생산성과 Claude.ai 워크스페이스 활동까지 한 곳에서 관리할 수 있습니다. 연동 설정 화면과 사이드바 카드에는 **Anthropic API**로 표시됩니다. 이 연동은 API 플랫폼(Console) 관리 기능이며, 개인용 Claude.ai 구독과는 별개입니다. ## 주요 기능 | 기능 | 설명 | | ------------------- | -------------------------------------- | | **조직 관리** | 멤버, 워크스페이스, 초대 현황 조회 | | **비용 추적** | 모델별, 워크스페이스별 API 사용 비용 분석 (USD) | | **토큰 사용량** | 입력/출력/캐시 토큰 및 웹 검색 요청 현황 | | **Claude Code 생산성** | 세션 수, 코드 라인 추가/삭제, 커밋, PR 통계 | | **Claude.ai 활동** | DAU/WAU/MAU, 사용자 활동, 프로젝트·스킬·커넥터 사용 현황 | {% hint style="info" %} Anthropic 연동은 **두 종류의 API Key**를 사용합니다.\ **Admin API Key** (`sk-ant-admin-...`) — Console Admin API의 비용·사용량·Claude Code 데이터용\ **Analytics API Key** (`sk-ant-api01-...`) — Claude.ai Enterprise의 활동·프로젝트·스킬·커넥터 데이터용\ 필요한 영역만 부분 연동하거나, 두 가지를 모두 연동할 수 있습니다. {% endhint %} *** #### 사전 요구사항 연동을 시작하기 전에 다음 조건을 확인하세요. | 요구사항 | 설명 | | ------------------------ | ------------------------------------------------------- | | **Anthropic 조직 계정** | Anthropic Console에 조직이 등록되어 있어야 합니다 | | **Admin 또는 Owner 권한** | 조직의 Admin 또는 Owner 권한이 필요합니다 | | **Claude.ai Enterprise** | Analytics API 연동은 Claude.ai Enterprise 플랜에서만 가능합니다 (선택) | | **SMPLY 관리자** | SMPLY에서 연동 설정 권한이 필요합니다 | #### 연동 범위 Anthropic 연동 시 다음 정보가 동기화됩니다. | 키 종류 | 동기화 항목 | | --------------------- | --------------------------------------------------- | | **Admin API Key** | 조직 정보, 멤버, 워크스페이스, 비용(USD), 토큰 사용량, Claude Code 생산성 | | **Analytics API Key** | DAU/WAU/MAU, 사용자 활동, 프로젝트, 스킬, 커넥터 | ## 연동 방법 심플리의 **Anthropic API** 연동 설정은 하나의 **`API Key`** 입력란을 사용합니다. 여기에 **Admin API Key**(`sk-ant-admin-...`) 또는 **Analytics API Key**(`sk-ant-api01-...`) 중 어느 쪽이든 입력할 수 있으며, 입력한 키 종류에 따라 동기화되는 데이터가 결정됩니다. 두 영역을 모두 보려면 키를 하나씩 차례로 연동하면 됩니다. 먼저 필요한 키를 Anthropic에서 발급받은 뒤, 심플리 연동 설정 화면에서 입력합니다. ### 1. Admin API Key 발급 (API Platform) {% stepper %} {% step %} #### Anthropic Console에서 키 발급 1. [Anthropic Console](https://console.anthropic.com)에 로그인합니다. 2. 좌측 메뉴에서 **Settings → Admin Keys**로 이동합니다. 3. **Create Admin Key** 버튼을 클릭하여 새 키를 생성합니다. 4. 생성된 키(`sk-ant-admin-...`)를 안전한 곳에 복사해 둡니다. {% endstep %} {% endstepper %} 이 키로 동기화되는 데이터: **조직 정보, 멤버, 비용(USD), 토큰 사용량, Claude Code 생산성** {% hint style="warning" %} Admin API Key는 생성 직후에만 전체 값을 확인할 수 있습니다. 키를 분실한 경우 새로 발급받아야 합니다. {% endhint %} ### 2. Analytics API Key 발급 (Claude.ai Enterprise) {% hint style="info" %} **Analytics API**는 Claude.ai Enterprise 플랜에서만 제공됩니다. Pro·Team 플랜에서는 사용할 수 없습니다. 키 발급에는 **Primary Owner** 권한이 필요합니다. {% endhint %} {% stepper %} {% step %} #### Claude.ai에서 키 발급 1. [Claude.ai](https://claude.ai)에 **Primary Owner** 계정으로 로그인합니다. 2. **Analytics → API keys**로 이동합니다. 3. **Analytics API** 아래의 **Access** 토글을 켭니다. (이 토글을 켜야 키를 발급할 수 있습니다) 4. **+ Create key** 버튼을 클릭하여 새 키를 생성합니다. 5. 생성된 키(`sk-ant-api01-...`)를 안전한 곳에 복사해 둡니다. {% endstep %} {% endstepper %} 이 키로 동기화되는 데이터: **DAU/WAU/MAU, 사용자 활동, 프로젝트, 스킬, 커넥터** ### 3. 심플리에서 연동하기 {% stepper %} {% step %} #### 연동 설정 화면 열기 1. 심플리에 로그인한 후, **설정 → 연동 관리** 페이지로 이동합니다. 2. **AI** 섹션에서 **Anthropic API** 카드를 클릭합니다. {% endstep %} {% step %} #### API Key 입력 1. **`API Key`** 입력란에 발급받은 키를 붙여 넣습니다. (Admin Key `sk-ant-admin-...` 또는 Analytics Key `sk-ant-api01-...` 중 하나) 2. **`연동하기`** 버튼을 클릭합니다. 3. 연동이 완료되면 **AI → Anthropic** 메뉴에서 대시보드를 확인할 수 있습니다. 4. 다른 종류의 키도 함께 보려면, 같은 방식으로 나머지 키를 다시 한번 연동합니다. {% endstep %} {% endstepper %} {% hint style="warning" %} **API Key 형식 확인** 입력한 키가 `sk-ant-admin` 또는 `sk-ant-api01`로 시작하지 않으면 **`연동하기`** 버튼이 비활성화되고 *"API Key는 sk-ant-admin 또는 sk-ant-api01로 시작해야 합니다."* 안내가 표시됩니다. 일반 API Key(`sk-ant-api03-...`)로는 연동되지 않습니다. {% endhint %} *** #### 문제 해결 **연동이 실패합니다** **원인 1: 잘못된 키 형식** * Admin API Key는 `sk-ant-admin-`으로 시작해야 합니다. 일반 API Key(`sk-ant-api03-...`)나 Analytics Key(`sk-ant-api01-...`)를 Admin 섹션에 입력하지 않았는지 확인하세요. * Analytics API Key는 `sk-ant-api01-`으로 시작해야 하며, Claude.ai Enterprise 워크스페이스에서 발급한 키여야 합니다. **원인 2: 권한 부족** * Anthropic Console에서 본인 계정의 역할이 **Admin** 또는 **Owner**인지 확인하세요. * Claude.ai Enterprise에서는 **Primary Owner** 권한이 필요하며, **Analytics → API keys** 화면에서 **Analytics API > Access** 토글을 먼저 켜야 키를 발급할 수 있습니다. **원인 3: 자격증명 만료** * Anthropic 측에서 키를 회수하거나 만료시킨 경우 연동 상태가 **자격증명 오류**로 표시됩니다. 새 키를 발급받아 다시 연동하세요. **비용/사용량 데이터가 보이지 않습니다** **원인: 동기화 지연** * 연동 직후 조직 정보(멤버, 워크스페이스)는 바로 동기화됩니다. * 비용 및 사용량 데이터는 Anthropic API 제공 주기에 따라 최대 24시간이 소요될 수 있습니다. 자동 동기화는 **매일 오전 5시(KST)** 배치로 실행됩니다. * Claude.ai Analytics 데이터는 Anthropic Analytics API 정책상 약 3일의 지연이 있어, 가장 최근 데이터는 3일 전 기준으로 표시됩니다. *** #### 자주 묻는 질문 **Q: Admin API Key와 Analytics API Key를 모두 등록해야 하나요?** 아니요. 필요한 영역만 등록할 수 있습니다. API 비용·Claude Code 생산성만 보고 싶다면 Admin Key만, Claude.ai 워크스페이스 활동만 보고 싶다면 Analytics Key만 등록해도 됩니다. 두 키를 모두 등록하면 API 비용과 Claude.ai 활동을 교차 분석할 수 있습니다. **Q: 일반 API Key (`sk-ant-api03-...`)로 연동할 수 있나요?** 아니요. 심플리 연동에는 조직 관리용 **Admin API Key** (`sk-ant-admin-...`) 또는 **Analytics API Key** (`sk-ant-api01-...`)가 필요합니다. 일반 API Key는 모델 호출 권한만 있고 조직·비용·활동 정보 조회 권한이 없습니다. **Q: 연동 후 데이터가 바로 보이나요?** 연동 직후 조직 정보(멤버, 워크스페이스)는 바로 동기화됩니다. 비용 및 사용량 데이터는 Anthropic API 제공 주기에 따라 최대 24시간이 소요될 수 있으며, 자동 동기화는 \*\*매일 오전 5시(KST)\*\*에 실행됩니다. 더 빨리 확인하려면 대시보드 헤더의 **`새로고침`** 버튼으로 수동 동기화를 실행하세요. **Q: API Key를 교체하고 싶어요.** 연동 관리 페이지의 **Anthropic API** 카드에서 **연동 해제** 후 새 키로 다시 연동하세요. **Q: 연동을 해제하면 데이터가 삭제되나요?** 연동을 해제해도 이미 수집된 데이터는 유지됩니다. 단, 더 이상 Anthropic과 동기화되지 않으며, 심플리에 저장된 API Key는 삭제됩니다. **Q: 여러 Anthropic 조직을 연동할 수 있나요?** 하나의 SMPLY 워크스페이스에는 하나의 Anthropic 조직만 연동할 수 있습니다. **Q: Claude.ai Pro·Team 플랜도 Analytics 연동이 되나요?** 아니요. Analytics API는 Claude.ai Enterprise 플랜에서만 제공됩니다. Pro·Team 플랜은 API Platform (Admin) 연동만 가능합니다.