PlayCamp는 SDK 연동을 자동화하는 Claude Code 에이전트를 제공합니다. API 호출을 직접 작성하는 대신 자연어로 필요한 것을 설명하면, 에이전트가 SDK 설치, API 구현, 웹훅 설정, 검증까지 자동으로 처리합니다.
지원 카테고리
| 카테고리 | 에이전트 수 | 설명 |
|---|
| Node SDK | 5개 | @playcamp/node-sdk 자동 연동 |
| Go SDK | 5개 | github.com/playcamp/playcamp-go-sdk 자동 연동 |
| API | 1개 | Python, Java, C#, PHP 등을 위한 직접 HTTP API 가이드 |
빠른 시작
에이전트 설치
게임 서버 프로젝트에서 설치 스크립트를 실행합니다:cd your-game-server
bash <(curl -fsSL https://raw.githubusercontent.com/PlayCamp/playcamp-sdk-agents/main/scripts/install.sh)
요청
PlayCamp SDK 연동해줘. 스폰서, 쿠폰, 결제 API 필요해
설치 옵션
# 현재 프로젝트에 설치 (기본값)
bash <(curl -fsSL https://raw.githubusercontent.com/PlayCamp/playcamp-sdk-agents/main/scripts/install.sh)
# 글로벌 설치 (~/.claude/agents/)
bash <(curl -fsSL ...install.sh) --global
# 특정 카테고리만 설치
bash <(curl -fsSL ...install.sh) --platform=node
bash <(curl -fsSL ...install.sh) --platform=go
bash <(curl -fsSL ...install.sh) --platform=api
# 삭제 (에이전트 파일 + CLAUDE.md 라우팅 규칙 제거)
bash <(curl -fsSL ...install.sh) --uninstall
에이전트 목록
Node SDK 에이전트 (5개)
| 에이전트 | 역할 |
|---|
| @agent-playcamp-integrator | SDK 설치 및 필수 API 연동 (스폰서, 쿠폰, 결제) |
| @agent-playcamp-auditor | 연동 코드 품질 검증 및 보안 점검 |
| @agent-playcamp-webhook-specialist | 웹훅 엔드포인트 설정 및 서명 검증 |
| @agent-playcamp-migration-assistant | 기존 Raw HTTP 호출을 SDK로 전환 |
| @agent-playcamp-test-verifier | 빌드 확인, 환경 설정 검증 |
Go SDK 에이전트 (5개)
| 에이전트 | 역할 |
|---|
| @agent-playcamp-go-integrator | Go SDK 설치 및 필수 API 연동 (스폰서, 쿠폰, 결제) |
| @agent-playcamp-go-auditor | Go 코드 품질 검증, errors.As() 패턴, context 사용 점검 |
| @agent-playcamp-go-webhook-specialist | webhookutil.Verify()를 활용한 웹훅 설정 및 배치 이벤트 처리 |
| @agent-playcamp-go-migration-assistant | 기존 net/http 호출을 Go SDK로 전환 |
| @agent-playcamp-go-test-verifier | go build, go vet, 연동 검증 |
API 에이전트 (1개)
| 에이전트 | 역할 |
|---|
| @agent-playcamp-api-guide | SDK 미지원 언어(Python, Java, C#, PHP, curl)를 위한 직접 HTTP API 가이드 |
사용 예시
신규 연동 (Node.js)
Express 서버에 PlayCamp SDK 연동해줘. 결제, 쿠폰, 스폰서 API 필요해
PlayCamp 웹훅 수신 엔드포인트 만들어줘. 서명 검증 포함해서
신규 연동 (Go)
Go 서버에 PlayCamp Go SDK 연동해줘. 스폰서, 쿠폰, 결제 API 필요해
Go 서버에 PlayCamp 웹훅 검증 추가해줘. webhookutil 사용해서
직접 API 연동 (SDK 미지원 언어)
Python으로 PlayCamp 결제 API 연동하는 방법 알려줘
Java 서버에 PlayCamp 스폰서, 쿠폰 API 연동해줘
마이그레이션
기존 fetch() 호출을 PlayCamp SDK 메서드로 전환해줘
기존 net/http PlayCamp 호출을 Go SDK로 전환해줘
에이전트 직접 호출
에이전트 이름을 명시적으로 지정할 수도 있습니다:
@agent-playcamp-integrator 로 PlayCamp SDK 연동해줘
@agent-playcamp-webhook-specialist 로 웹훅 엔드포인트 설정해줘
권장 워크플로우
신규 Node SDK 연동
- integrator가 SDK 설치, 클라이언트 초기화, 필수 API 구현
- webhook-specialist가 웹훅 엔드포인트 및 서명 검증 설정
- auditor가 전체 연동 코드 검토 및 보안 점검
- test-verifier가 빌드, 설정, 환경 변수 검증
신규 Go SDK 연동
- go-integrator가 Go SDK 설치, 클라이언트 초기화, 필수 API 구현
- go-webhook-specialist가
webhookutil 패키지로 웹훅 엔드포인트 설정
- go-auditor가 Go 관용적 패턴 및 보안 점검
- go-test-verifier가
go build, go vet, 환경 변수 검증
직접 HTTP 연동 (SDK 미지원 언어)
- api-guide가 HTTP 엔드포인트, 인증 헤더, 요청/응답 형식, 웹훅 검증 예제 제공
Raw HTTP에서 SDK로 마이그레이션
- migration-assistant가 기존 fetch/axios 호출을 SDK 메서드로 변환
- auditor가 마이그레이션 완료 여부 및 정확성 검증
- test-verifier가 빌드 및 설정 확인
- go-migration-assistant가 기존
net/http 호출을 Go SDK 메서드로 변환
- go-auditor가 마이그레이션 완료 여부 및 Go 관용적 패턴 검증
- go-test-verifier가 빌드 및 테스트 확인
동작 원리
설치 스크립트가 .claude/agents/에 에이전트 파일을 추가하고, 프로젝트의 CLAUDE.md에 라우팅 규칙을 자동 추가합니다. PlayCamp 관련 요청 시 Claude Code가 자동으로 적합한 에이전트에 위임합니다.
사용자: "PlayCamp 결제 처리 추가해줘"
→ Claude가 CLAUDE.md 라우팅 규칙 확인
→ @agent-playcamp-integrator 에 위임
→ 에이전트가 SDK로 결제 API 구현
에이전트는 프로젝트의 파일을 읽고, 쓰고, 편집할 수 있는 전체 접근 권한을 가집니다. npm 패키지 설치, 모듈 생성, 서버 코드 수정이 가능합니다.