코딩 에이전트 안에서 스포티파이 포털을 바로 다루는 방법
Claude Code나 Cursor 같은 코딩 에이전트를 쓰면서도 스포티파이 내부 시스템에 접근하려면 창을 계속 오가야 했습니다. 이 플러그인은 에이전트 안에서 포털 CLI를 바로 실행하게 해 줍니다. 소프트웨어 카탈로그 검색부터 서비스 브리핑 생성, 진단 실행까지 코딩 환경 안에서 끝냅니다.
에이전트 안에서 포털을 다루는 흐름
이 저장소는 스포티파이 포털 CLI를 코딩 에이전트에 연결하는 플러그인입니다. 인증 설정, 소프트웨어 카탈로그 검색, 서비스 브리핑 생성, 진단 실행, 포털 액션 호출이라는 다섯 가지 워크플로를 제공합니다. 모든 작업은 읽기 전용 진단을 포함해 에이전트 세션 안에서 처리됩니다. 특히 액션 호출 시에는 내장된 도움말, 드라이런, 확인 절차가 있어 실수를 막아 줍니다.
주요 워크플로와 기능
각 워크플로는 특정 목적에 맞춰 설계되어 있습니다.
- 인증 설정 현재 코딩 에이전트 환경에 맞는 포털 CLI 인증을 설정합니다.
- 준비 상태 진단 플러그인, CLI, 인증, 액션 준비 상태를 읽기 전용으로 확인합니다.
- 자연어 검색 소프트웨어 카탈로그와 기술 문서를 자연어 쿼리로 검색합니다.
- 서비스 브리핑 소유권, 건강 상태, 사고, 문서 정보를 담은 간결한 브리핑을 생성합니다.
- 액션 호출 포털 액션을 발견하고, 검사하며, 미리보기 후 안전하게 실행합니다.
설치와 초기화
Claude Code를 쓴다면 claude plugin marketplace add spotify/portal-ai-plugins 명령으로 마켓플레이스를 추가하고, claude plugin install portal@portal로 플러그인을 설치합니다. 새 세션을 시작해 /portal:setup을 실행하면 인증이 설정됩니다. Codex를 쓴다면 codex plugin marketplace add spotify/portal-ai-plugins 후 /plugins에서 설치하고, "Set up Spotify Portal for me."라고 요청하면 됩니다. Cursor를 쓴다면 팀 마켓플레이스에 저장소를 등록한 뒤 설정에서 플러그인을 설치합니다. 설치 과정에서 auth, actions, owner, search, service 명령이 필요한지 확인합니다.
토큰 절약용 shunt 플러그인
마켓플레이스에는 shunt라는 추가 플러그인도 함께 제공됩니다. 현재는 Claude Code에서만 사용할 수 있습니다. 대량의 파일 읽기나 템플릿 코드 생성 같은 I/O 집중 작업을 더 저렴한 워커 모델이 실행하는 AiKA 모드로 라우팅합니다. 이는 포털 CLI 액션 레지스트리를 통해 동작하며, 토큰 비용을 줄이는 데 도움이 됩니다.
사용 전 확인 사항
이 플러그인은 스포티파이 포털 CLI가 정상적으로 작동하는 환경을 전제로 합니다. shunt 플러그인은 현재 Claude Code 전용이므로 다른 에이전트에서는 사용할 수 없습니다.