Shortshock MCP

Claude, ChatGPT, Cursor 같은 AI 에이전트에서 Shortshock을 도구(tool)로 쓰기 위한 MCP(Model Context Protocol) 서버입니다. 대화만으로 채널 성과와 콘텐츠 분석 결과를 조회하고, 프로젝트를 만들어 여러 채널에 배포할 수 있습니다.

MCP 서버 URL

https://mcp.shortshock.net/mcp

전송 방식: Streamable HTTP
인증: OAuth 2.1 · API 키
데이터 범위: 팀 1개
제공 도구: 21개

사용하는 클라이언트를 골라 연결 방법을 확인하세요.

개요#

MCP 서버는 Open API를 감싼 어댑터입니다. 각 도구는 Open API 엔드포인트 하나에 대응하며, 권한·데이터 범위·Rate Limit도 Open API와 같습니다.
연결할 때 팀(team) 하나를 선택하며, 에이전트는 그 팀의 데이터에만 접근합니다. 여러 팀을 쓰려면 팀마다 따로 연결하세요.
전송 방식은 Streamable HTTP이며, 인증은 OAuth 2.1(Authorization Code + PKCE)을 사용합니다. 별도 설치나 로컬 실행이 필요 없습니다.

서버 주소#

환경	URL
Production	`https://mcp.shortshock.net/mcp`
Staging	`https://mcpstg.shortshock.net/mcp`

클라이언트별 연결#

사용하는 AI 클라이언트를 선택하세요. 어떤 클라이언트든 마지막에 Shortshock 로그인과 팀 선택을 거칩니다.

claude.ai 웹과 Claude 데스크톱 앱에서 같은 방법으로 연결합니다.

설정 → 커넥터에서 커스텀 커넥터 추가를 선택합니다.
이름은 자유롭게(예: Shortshock) 입력하고, 원격 MCP 서버 URL에 https://mcp.shortshock.net/mcp를 입력합니다.
추가한 커넥터의 연결 버튼을 누릅니다.
브라우저에 Shortshock 로그인 · 동의 화면이 열립니다. 접근을 허용할 팀을 선택하고 승인하면 연결이 완료됩니다.
대화 입력창의 도구 메뉴에서 Shortshock이 켜져 있는지 확인한 뒤 질문을 시작하세요.

Team · Enterprise 플랜조직 플랜에서는 소유자/관리자가 먼저 조직 설정에서 커넥터를 추가해야 구성원이 연결할 수 있습니다.

연결 관리와 해제OAuth로 연결하면 워크스페이스 설정 → API 키 목록에 MCP - ... 이름의 키가 생깁니다. 이 키를 폐기하면 해당 연결은 즉시 끊깁니다.

API 키로 연결#

OAuth를 지원하지 않는 클라이언트나 서버 간 자동화에서는 워크스페이스 설정에서 발급한 Open API 키를 Authorization 헤더에 직접 넣어 연결합니다. 키를 발급할 때 선택한 팀의 데이터에 접근합니다.

Claude Code

claude mcp add --transport http shortshock https://mcp.shortshock.net/mcp \
  --header "Authorization: Bearer sk_live_..."

mcp.json

{
  "mcpServers": {
    "shortshock": {
      "type": "http",
      "url": "https://mcp.shortshock.net/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_..."
      }
    }
  }
}

API 키 보관API 키는 팀 데이터에 대한 쓰기 권한(프로젝트 생성·배포)까지 포함합니다. 설정 파일을 저장소에 커밋하지 말고, 유출되면 즉시 폐기 후 재발급하세요.

응답 언어#

요청 언어는 x-language-code 헤더(ko 또는 en)로 지정하며, 생략하면 한국어(ko)로 처리됩니다. MCP 서버는 이 헤더를 그대로 Open API에 전달하고, 에러 메시지도 같은 언어로 반환됩니다. 헤더를 지정할 수 있는 클라이언트(예: Claude Code, Cursor)에서 설정하며, 커스텀 헤더를 지원하지 않는 클라이언트는 한국어로 동작합니다.

Claude Code

claude mcp add --transport http shortshock https://mcp.shortshock.net/mcp \
  --header "x-language-code: en"

AI 분석 결과 본문은 분석을 요청한 시점의 언어로 저장된 내용이 그대로 반환됩니다.

제공 도구#

각 도구의 입력 파라미터와 응답 형식은 도구 설명에 포함되어 있어 에이전트가 자동으로 참고합니다. 응답 필드의 상세 스키마는 API Reference와 같습니다.

채널 · 통계

도구	설명
`get_connections`	연결된 소셜 채널 목록
`get_connection_statistics`	팀 전체 채널 성과 (기간별 조회/좋아요/댓글/공유, 직전 기간 대비, 최다/최소 조회 콘텐츠)
`get_connection_detail`	채널 상세 (팔로워 등 채널 통계, 카테고리/성향, 오디언스, 채널 AI 분석 결과)
`get_connection_statistics_timeseries`	채널 팔로워/게시물 수 추이
`refresh_connections`	연결 계정 통계 일괄 갱신 요청 (비동기)
`get_connections_refresh_status`	통계 갱신 진행 상태 조회

내 콘텐츠

도구	설명
`get_contents`	연결 채널에 게시된 콘텐츠 목록 + 게시물별 통계치
`get_content_detail`	콘텐츠 상세 (통계치 + AI 분석 결과: 요약, 타임라인, 패턴)

프로젝트 생성 · 수정

도구	설명
`create_video_project`	VIDEO 프로젝트 생성 (업로드용 presigned URL 반환)
`create_article_project`	ARTICLE 프로젝트 생성 (업로드용 presigned URL 반환)
`create_carousel_project`	CAROUSEL 프로젝트 생성
`add_carousel_card`	CAROUSEL 카드 추가 (업로드용 presigned URL 반환)
`upload_video_thumbnail`	VIDEO 썸네일 이미지 업로드 (업로드용 presigned URL 반환)
`set_video_thumbnail_from_timeline`	VIDEO 썸네일을 영상 속 특정 장면(ms)으로 변경
`update_project`	프로젝트 수정 (제목/캡션/채널별 설정)
`delete_project`	프로젝트 삭제
`get_project_status`	프로젝트 상세 / 업로드·배포 상태 조회
`list_projects`	프로젝트 목록 조회

배포

도구	설명
`publish_project`	배포 요청 (즉시 또는 예약)
`cancel_publish`	예약 배포 취소
`retry_project_item`	실패한 채널 재배포 요청

사용 예시#

연결 후 에이전트에게 이렇게 요청해 보세요.

"지난 2주간 채널별 성과를 직전 2주와 비교해서 정리해줘"
"인스타그램 계정의 팔로워 추이와 주요 오디언스 연령대를 알려줘"
"이번 달 조회수가 가장 높았던 콘텐츠의 AI 분석 결과를 요약해줘"
"통계를 최신으로 갱신한 다음, 좋아요 대비 댓글 비율이 높은 게시물 5개를 뽑아줘"
"이 영상으로 VIDEO 프로젝트를 만들고 내일 오전 9시에 예약 배포해줘"
"방금 만든 영상 프로젝트 썸네일을 5초 지점 장면으로 바꿔줘"

제약 사항#

AI 분석은 조회만 가능합니다. 채널/콘텐츠 AI 분석 요청은 Shortshock 서비스에서 진행하고, 완료된 결과를 MCP로 조회하세요.
파일 업로드는 클라이언트가 직접 수행합니다. 프로젝트 생성 도구와 upload_video_thumbnail은 S3 presigned URL만 반환하며, 실제 파일을 그 URL로 PUT하는 것은 에이전트 실행 환경의 몫입니다. 파일 전송이 불가능한 채팅 환경에서는 미디어 업로드를 완료할 수 없습니다.
응답의 mediaUrl, videoUrl 등은 일정 시간 후 만료되는 임시 링크입니다.
Rate Limit은 연결에 사용된 API 키 단위로 Open API와 동일하게 적용됩니다.