이미 사용 중인 AI 도구에서 바로 작동
Sporfie의 MCP 서버는 Public API를 엄선된 19개 도구로 제공합니다. 한 번 연결한 후 일상적인 언어로 요청하세요. 모든 도구 호출은 내부적으로 일반 API 호출과 동일하게 작동하며, 식별자와 권한, 속도 제한도 같습니다.
- Claude
- ChatGPT
- Grok Bot
- Cursor
- 그 밖의 모든 MCP 호환 클라이언트
Streamable HTTP 전송 방식. Help Center 도구는 토큰 없이 작동합니다.
한 번의 클릭으로 연결
헤더 없이 서버를 추가하면 클라이언트가 표준 MCP OAuth 흐름을 실행합니다. Sporfie에 한 번 로그인하고 연결을 승인하면 끝입니다. 복사할 키가 없습니다.
또는 내 키 사용
CLI, CI 및 스크립트에서는 설정 → 개발자에서 개인 키를 만들고 Bearer 헤더로 전달하세요. 같은 키를 직접 REST 호출에도 사용할 수 있습니다.
API 키 관리도구로 할 수 있는 작업
이벤트 생성, 조회, 업데이트, 종료 및 삭제 · 검색 및 라이브 조회 · 장소 및 스포츠 · 하이라이트 모먼트 · 이벤트 웹훅 · Help Center 검색.
연동 대신 요청하세요
Sporfie MCP 서버가 실제로 제공하는 도구만 사용하는 세 가지 대화 예시입니다.
완료했습니다. 사진에서 6경기를 읽어 카메라가 설치된 장소에 예약했습니다:
- 토 09:00 · U14 Tigers – Falcons · 1번 코트
- 토 10:30 · U16 Tigers – Ravens · 1번 코트
- 토 12:00 · U19 Tigers – Bulls · 2번 코트
- + 일요일 3경기 더
각 경기는 시작 시 자동으로 녹화되고 스트리밍됩니다. 라이브가 시작될 때 웹사이트가 업데이트되도록 웹훅도 추가할까요?
Spring Cup 결승전(4월 26일, 1번 코트)에서 찾은 내용입니다:
최다 시청: 2:31:07의 매치 포인트, 조회수 412회.
조회수는 하이라이트 클립별로 집계됩니다. API는 라이브 스트림 시청자 수를 제공하지 않습니다.
U19 결승전은 토요일 14:00~16:00에 2번 코트로 예정되어 있어 이벤트가 준비되었습니다. RTMP 수신 URL은 API가 아니라 Sporfie 내에서 인코더별로 발급되므로 가장 빠른 방법은 다음과 같습니다:
- 설정 → 인코더를 열고 GoPro를 추가하거나 선택하세요.
- RTMP URL을 GoPro 앱에 복사하세요.
- 또는 GoPro QR 코드를 표시한 뒤 카메라로 스캔하세요. 스트림이 자동으로 설정됩니다.
설명을 위한 대화 예시입니다. 어시스턴트에 따라 표현은 달라질 수 있지만 도구 호출은 실제와 같습니다.
만들 수 있는 것
아래의 모든 기능은 현재 공개 OpenAPI 명세에 포함되어 있으며 로드맵 항목이 아닙니다.
내 ID로 관리하는 이벤트
이벤트를 생성, 업데이트, 종료 및 삭제하세요. 자체 externalID로 이벤트를 지정할 수 있어 기존 시스템을 기준 데이터로 유지할 수 있습니다.
예약 녹화
시작 및 종료 시간과 함께 이벤트를 카메라가 설치된 장소에 연결하면 자동으로 녹화하고 스트리밍합니다.
실시간 점수
점수 앱이나 기기에서 점수 스트림을 전송하면 스코어보드와 이벤트에 반영됩니다.
필요할 때 만드는 하이라이트
타임스탬프에 클릭을 등록하면 Sporfie가 해당 시점 전후를 클립으로 만듭니다. 버튼, 센서 또는 자체 로직에서 실행할 수 있습니다.
웹훅
이벤트를 구독하면 변경될 때마다 전체 이벤트 객체를 받을 수 있습니다. 폴링 대신 사용하세요.
모먼트, 릴 및 북마크
클립 URL과 조회수를 확인하고, 릴과 북마크 컬렉션을 관리하며, 태그가 지정된 클립을 내보내세요.
플레이어 삽입
Sporfie 플레이어는 iframe으로 어느 페이지에나 간편하게 삽입할 수 있습니다.
대부분의 연동을 처리하는 다섯 가지 호출
문서에 있는 그대로입니다. 환경에 SPORFIE_TOKEN, COMPANY_KEY 및 PLACE_KEY를 설정하면 바로 실행할 수 있습니다.
curl -X POST "https://api.sporfie.com/public/events/booking-48213" \
-H "Authorization: Bearer $SPORFIE_TOKEN" \
-H "Content-Type: application/json" \
-d @- <<JSON
{
"companyKey": "$COMPANY_KEY",
"name": "U16 semi-final",
"sport": "volleyball",
"homeTeam": "Tigers",
"awayTeam": "Falcons",
"placeKey": "$PLACE_KEY",
"scheduledStartTime": 1757683200000,
"scheduledEndTime": 1757690400000
}
JSON
# → { "eventKey": "-Nq7xK2mBv9pL3aRt8Zc" }›먼저 키 확인
curl -o /dev/null -w '%{http_code}\n' \
-H "Authorization: Bearer $SPORFIE_TOKEN" \
https://api.sporfie.com/public/sports
# 200 means the key works. 401 means it doesn't.액세스 방식
개인 키 만들기
설정 → 개발자에서 만들 수 있습니다. 비밀 키는 한 번만 표시되므로 비밀 관리자에 보관하세요.
사용자를 대신해 작동
키는 사용자가 관리하는 조직에 접근하며, 생성할 때 특정 조직으로 범위를 제한할 수 있습니다. 모든 호출은 현재 멤버십을 기준으로 확인됩니다.
API 호출 또는 MCP 연결
REST는 api.sporfie.com, 도구는 mcp.sporfie.com에서 이용할 수 있습니다. 키와 범위, 제한은 모두 동일합니다.
관리자가 아닌 조직을 관리해야 하나요? Sporfie에서 발급한 연동 키가 필요합니다.
문의하기알아두면 좋은 점
- 키당 초당 약 1회 요청할 수 있습니다. 대량 작업의 속도를 조절하고 429 응답 시 대기 시간을 늘리세요.
- 모든 시간은 Unix epoch 이후의 UTC 밀리초입니다.
- 이벤트 구독은 12시간 후 만료되므로 일정에 맞춰 다시 등록하세요.
- 클릭은 접수된 것이며 완료된 것은 아닙니다. 클립 생성에는 몇 초가 걸립니다. 파일이 필요하면 모먼트를 폴링하세요.
- 키는 서버 측에 보관해야 합니다. 브라우저, 모바일 앱 또는 저장소에 절대 넣지 마세요.