자료 · SoCode

Claude Code에서 SocialHub 실행

SoCode은 Claude Code(및 Claude Desktop / Cursor)용 SocialHub 통합으로, 다운로드 가능한 기술과 관리되는 MCP 서버가 포함되어 있습니다. SocialHub를 운영하고 귀하의 데이터에 대해 일반 언어로 물어보세요.

시작하기 SoCode을 사용하는 이유는 무엇인가요?

claude · socialhub (mcp)

› 쉬운 말로 질문해 주세요

당신 › 지난주 매장별 총 상품 판매액(GMV), 상위 3개 매장▋

↳ 관리되는 측정항목 · gmv · 매장별 · last_7d

매장 042$128,400

매장 017$96,250

233번 매장$81,900

의미 계층에서 · SQL 없음 · 감사됨 · 설명적

01 — 개요

SoCode란 무엇인가요?

SoCode는 SocialHub가 AI 비서에 연결되는 방식입니다. 두 부분이 함께 작동하므로 편집자를 떠나지 않고도 Claude에서 SocialHub를 운영하고 데이터에 대한 질문에 일반 언어로 답변할 수 있습니다.

기술

`flash-operations`

Claude 사용자가 SocialHub를 안전하게 사용하는 방법(사용 도구, 회원 이름/이메일로 쓰기 확인, 관리되는 지표 수치만 인용하는 방법 등)을 알려주는 다운로드 가능한 Claude 스킬.

서버

관리 MCP 서버

테넌트 API 키로 인증되고 도구별로 승인된 SocialHub의 도구(충성도, 회원, 쿠폰, 캠페인 및 관리되는 지표)를 노출하는 모델 컨텍스트 프로토콜 엔드포인트입니다.

02 - 중요한 이유

SoCode을 사용하는 이유는 무엇인가요?

팀에서 이미 사용 중인 AI 도구에서 데이터와 운영에 접근할 수 있으며, 거버넌스는 그대로 유지할 수 있습니다.

자연어 처리, 대시보드 없음

일반 영어로 물어보세요. Claude는 올바른 관리 도구를 선택하고 실행합니다. 화면을 클릭할 필요도 없고 SQL을 작성할 필요도 없습니다.

설계에 의해 관리되고 안전합니다.

측정 수치는 SocialHub의 시맨틱 레이어에서 제공됩니다(AI가 임의로 수치를 생성하지 않습니다). 쓰기 작업에는 쓰기 범위가 필요하며 서버 측 보안 검사를 통과해야 합니다. 모든 키는 팀에 할당되며 모든 호출은 감사됩니다.

현재 근무하고 있는 곳에서 일할 수 있습니다.

Claude Code, Claude Desktop, Cursor — 모든 MCP 클라이언트. 명령어 하나로 한 번 연결하면 어시스턴트를 떠나지 않고도 SocialHub를 운영할 수 있습니다.

읽기 전용으로 시작

다음으로 시작하세요 metrics:read 사전 설정(AI에 가장 안전한 설정)을 사용하세요. 포인트를 부여하거나 쿠폰을 발행해야 할 때만 쓰기 권한을 추가하세요. 그러면 모든 것을 직접 제어할 수 있습니다.

SoCode 이전에는 불가능했던 기능

이들 각각에는 분석가, 엔지니어 또는 보유하지 않은 대시보드가 필요했기 때문에 질문을 가진 사람이 제때 답변을 얻는 경우가 거의 없었습니다. 자체 AI 도구 내부의 관리 에이전트를 통해 데이터 제어권을 포기하지 않고도 비즈니스 수준의 답변과 조치, 셀프 서비스를 수행할 수 있습니다. 이것이 바로 잠금 해제입니다. 더 빠른 대시보드나 다른 운영 모델이 아닙니다.

★ 리텐션 마케터 · 핵심 루프

"이탈 가능성이 있는 회원을 파악하고, 재확보 캠페인을 시작하며, 목표에 맞춰 지속적으로 조정합니다."

전에몇 주에 걸쳐 3개 팀과 3개 도구가 제공됩니다. 분석가가 데이터를 가져오고, 마케터가 캠페인을 구축하고, 누군가가 다음 달에 결과를 확인합니다. 그때까지는 그 순간이 지나고 루프가 실제로 닫히지 않습니다.

SoCode 사용분석 → 실행 → 개선의 단일 에이전트 루프가 실행됩니다. 관리되는 지표를 읽고, 승인된 여정을 시작하고, 성과를 측정하고, 설정한 목표와 가이드라인에 따라 지속적으로 재조정합니다.

성장/분석 리드

"지난주 매장별 총 상품 판매액(GMV)은 얼마이며, 이번 달 쿠폰 사용률이 감소한 이유는 무엇입니까?"

전에분석가에게 문의하고 답변을 기다리거나, 여러 대시보드에서 정보를 통합할 수 있습니다. 답변은 이미 결정이 내려진 후에 제공됩니다.

SoCode 사용데이터를 기반으로 몇 초 만에 신뢰할 수 있는 답변을 제공합니다. 직감이 아닌 데이터에 근거합니다.

AI/ML 엔지니어

SocialHub의 관리 측정항목을 자신의 어시스턴트 또는 MCP을 통한 Cursor 워크플로에 노출하세요.

전에맞춤형 통합, 수작업으로 작성된 쿼리, 그리고 처음부터 다시 구현된 거버넌스 — 수개월의 작업 끝에, 수치가 변동될 수 있는 새로운 환경이 조성되었습니다.

SoCode 사용하나의 스코프 키와 관리 계층을 스택에서 호출할 수 있습니다. 이전에는 프로젝트였던 통합 기능이 이제는 설정 파일 한 줄로 간소화되었습니다.

마케팅 관리자

"활동 회원 수가 지난달 대비 감소했나요? 회원 등급별로 분석해 주세요."

전에월간 평가에서나 알 수 있겠지만, 그때쯤이면 이미 한 달이 지나가 버린 후일 겁니다.

SoCode 사용의심스러운 순간 바로 자가 진단이 가능한 다단계 진단 시스템으로, 누수를 발견하면 즉시 조치를 취할 수 있습니다.

03 — 3단계로 설정

SoCode 작동 방식

세 단계: 다운로드 그 기술, 설치하다 the MCP 서버, 그리고 사용 자연어로 표현해 보세요.

1. SoCode(스킬) 다운로드

SoCode 기술(flash-operations)은 Claude SocialHub를 안전하게 운전하는 방법을 가르칩니다. 2단계에서 추가할 SocialHub MCP 서버와 쌍을 이룹니다.

스킬 폴더 받기

# Pull just the SoCode skill into Claude Code
npx degit huangchunbo2025/flash/skills/flash-operations \
  ~/.claude/skills/flash-operations

또는 GitHub → skills/flash-operations에서 찾아보거나 다운로드하세요. 해당 폴더를 ~/.claude/skills/(개인) 또는 프로젝트의 .claude/skills/ 폴더에 복사하세요.

이 기술은 선택 사항이지만 권장됩니다. MCP 서버는 이 기술 없이도 작동합니다. SoCode의 스킬은 Claude가 그것을 잘 사용하게 만듭니다.

2. MCP 서버를 설치하세요

a) API 키 생성

SocialHub에서 설정 → API키 → 키 생성으로 이동하여 "읽기 전용" 사전 설정을 선택합니다(metrics:read 포함 - AI 사용에 가장 안전함; 포인트 지급 또는 쿠폰 발행이 필요한 경우에만 쓰기 범위를 추가하세요). 키는 한 번만 표시되므로 복사하세요.

API 키로 이동

b) Claude Code에 서버를 추가합니다.

먼저 키를 환경 변수로 내보내면 일반 텍스트 키가 셸 기록이나 구성 파일에 저장되지 않습니다.

export FLASH_API_KEY="fl_live_your_key_here"

claude mcp add --transport http flash \
  https://flash.socialhub.ai/api/mcp \
  --header "Authorization: Bearer ${FLASH_API_KEY}"

구성을 선호하시나요? 저장소 루트에 프로젝트 범위 .mcp.json를 추가합니다. env var를 참조하고 일반 텍스트 키를 붙여넣지 마세요.

{
  "mcpServers": {
    "flash": {
      "type": "http",
      "url": "https://flash.socialhub.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${FLASH_API_KEY}"
      }
    }
  }
}

c) 검증

claude mcp list 실행 - flash이 연결된 것으로 표시되어야 합니다.
Claude에게 "사용 가능한 SocialHub 도구 목록"을 요청하세요. 키의 범위에 허용된 도구만 표시됩니다.
서버 이름은 정확히 flash이어야 하며, Claude Code을 실행하는 셸에 FLASH_API_KEY이 포함되어야 합니다. 유효하지 않은 키는 연결 실패로 표시됩니다.

3. 사용하세요

Claude에게 쉬운 말로 물어보세요. 예를 들면 다음과 같습니다.

데이터를 조회하세요

“제가 조회할 수 있는 지표 목록을 알려주세요.”
"지난주 매장별 총 상품 판매액(GMV)."
"이번 달에 환매량이 감소한 이유는 무엇입니까?"

작업 실행

“앨리스(alice@…)에게 200포인트를 드립니다.”
“활성 쿠폰 풀을 나열합니다.”
“이 회원에게 홍보대사 코드를 발급하세요.”

직접 관리하세요

쓰기 작업은 실행 전에 확인됩니다.
서버 측 제한으로 인해 과도한 쓰기 작업이 차단됩니다.
API 키 → 최근 MCP 활동에서 모든 호출을 확인하세요.

설계상 안전합니다. 메트릭 수치는 SocialHub의 관리되는 의미론적 계층에서 가져옵니다(AI는 SQL을 작성하거나 수치를 임의로 만들지 않습니다). 쓰기 작업에는 쓰기 범위 및 가 필요하며, 서버 측 보호 장치(호출당 값 제한 + 속도 제한)를 통과해야 합니다. 채팅 확인은 편의를 위한 것이며, 서버가 경계입니다. 모든 키는 팀에만 사용 권한이 부여됩니다.

MCP 가이드 (전체 참조)REST API 참고 자료 API 키 관리 자료 목록으로 돌아가기