MCP 통합 가이드

모델 컨텍스트 프로토콜(MCP)은 AI 어시스턴트가 외부 도구를 직접 호출할 수 있도록 하는 개방형 표준입니다. SocialHub는 MCP 서버를 구현하여 Claude Desktop, Cursor 또는 MCP 호환 클라이언트에서 스토어, 회원, 쿠폰 및 포인트를 관리할 수 있도록 합니다.

코드를 작성하는 대신 AI에게 "활성화된 모든 스토어 목록 표시" 또는 "회원 m_abc123에게 500포인트 지급"과 같이 요청하면 AI가 SocialHub MCP 도구를 대신 호출합니다.

연결 구성

SocialHub는 스트리밍 가능한 HTTP MCP 엔드포인트를 제공합니다. 다음 두 가지 정보가 필요합니다.

엔드포인트 URL	`https://flash.socialhub.ai/api/mcp`
API 키 헤더	`Authorization: Bearer fl_live_...`

/flash/account/api-keys에서 API 키를 생성하세요. 사용하려는 도구에 필요한 범위가 키에 포함되어 있는지 확인하십시오.

Claude Desktop 구성

Claude Desktop MCP 설정(claude_desktop_config.json)에 다음을 추가하세요.

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

Cursor 구성

Cursor에서 설정 > MCP으로 이동하여 새 서버를 추가하세요.

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

type 필드는 streamable-http도 별칭으로 허용합니다. 이러한 데스크톱 클라이언트는 키를 구성 파일에 저장하므로, 이를 비밀로 취급하고, 가능한 경우 디스크에 평문 키가 저장되지 않도록 환경 변수 형식(아래 참조)을 사용하는 것이 좋습니다.

Claude Code에서 연결하세요

claude mcp add 명령어를 사용하여 SocialHub를 HTTP MCP 서버로 추가합니다. 평문 키가 구성 파일이나 셸 기록에 저장되지 않도록 먼저 환경 변수로 키를 내보내십시오.

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}"

또는 repo 루트에서 프로젝트 범위 .mcp.json를 커밋하세요. ${FLASH_API_KEY}을 사용하여 환경 변수를 참조합니다. 일반 텍스트 키를 붙여넣지 마세요.

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

연결 후 자체 점검:

claude mcp list을 실행하고 flash이 연결된 것으로 표시되는지 확인합니다.
어시스턴트에게 "사용 가능한 SocialHub 도구 목록"을 요청하세요. 키 범위에서 허용하는 도구만 표시되어야 합니다.
서버 키는 정확히 flash이어야 합니다. Claude Code을 시작하는 셸에서 FLASH_API_KEY을 내보내는지 확인하세요.

알겠습니다: 유효하지 않거나 취소된 키는 인증 프롬프트가 아닌 연결 실패로 표시됩니다. SocialHub는 OAuth 폴백 없음으로 베어러 토큰 인증을 사용하므로 서버가 실패/연결 끊김으로 표시되면 다른 항목을 디버깅하기 전에 키 값을 다시 확인하고 필요한 범위가 있는지 확인하세요.

사용 가능한 도구(75)

cwm_get_forecast_capabilities

읽다 TimesFM 2.5 집계 추세/분위수 준비 상태 및 테넌트-프라이빗 융합 7/30/90일 준비 상태. 학습/검증 대기 중임을 명시합니다. 필요 사항 predictions:read.

매개변수:

cwm_predict_next_behaviors

소비자 예측 1건: 최종 차기 이벤트 분포/순위 플러스 CWM + TimesFM 7/30/90d purchaseWindows획득형 임차인 이벤트 모델 선호; 내부 공개 사전 참조 대체 모델 1개 사용. 개별 전문가 출력 없음. 이벤트 확률 미보정; 구매 기간 null 훈련/검증될 때까지. 필요사항 predictions:read; metrics:read 또한 구매 창을 활성화합니다.

매개변수: member_id*

cwm_forecast_aggregate_trend

TimesFM 2.5: 포인트 + q10..q90을 사용하여 브랜드/카테고리의 일일 지표를 예측합니다. 과거 데이터가 누락된 경우 null을 반환합니다. 집계 분위수는 보정되지 않았으며, 개인별 구간은 제공되지 않습니다. predictions:read 및 metrics:read 권한이 모두 필요합니다.

매개변수: metric?, horizon_days?, history_days?, category?

cwm_predict_purchase_windows

임차인-개인 CWM + TimesFM 7/30/90일 시점의 구매 확률(0–1). 학습 및 검증 전까지는 null 값이며, 인위적인 대체값은 없습니다. 필수 사항 predictions:read AND metrics:read.

매개변수: member_id

list_metrics

관리되는 시맨틱 레이어에서 이 팀이 사용할 수 있는 메트릭 목록(키, 레이블, 단위, 인증, 카테고리)을 표시합니다. 유효한 메트릭 키를 확인하려면 먼저 호출하세요. metrics:read 권한이 필요합니다.

매개변수: category?

describe_metric

하나의 측정항목에 대한 전체 사양을 확인하세요. 권위 있는 정의, 단위, 인증, 차원, 필터링 가능한 필드, 조정 가능한 매개변수 및 사용 지침을 포함합니다. 필요 조건 metrics:read.

매개변수: metric

query_metric

관리되는 메트릭 쿼리를 실행하고 권위 있는 정의와 함께 수치를 반환합니다. 메트릭 키와 선택적으로 차원, 필터, 시간 범위, 세분성 및 기간별 비교를 선택할 수 있습니다. SQL은 필요하지 않습니다. metrics:read 권한이 필요합니다.

매개변수: metric, dimensions?, filters?, timeRange?, grain?, compare?, params?

breakdown_metric

최근 특정 기간 동안 하나의 지표를 단일 차원으로 세분화하고, 사람이 읽기 쉬운 레이블(매장/티어/채널 이름)을 지정합니다. 필요 조건: metrics:read.

매개변수: metric, dimension, days, state?

ask_metrics

적절한 관리형 지표를 선택하고, 해당 지표를 가져와서 주요 지표를 분석함으로써 자연어 질문에 답변합니다. 개방형 진단에 적합합니다. metrics:read 권한이 필요합니다.

매개변수: question, categories?

list_stores

현재 팀의 모든 매장 목록을 표시합니다. 선택적으로 상태 필터, 검색 및 페이지네이션 기능을 지원합니다.

매개변수: status?, search?, limit?, offset?

get_store

매장 ID로 특정 매장의 상세 정보를 확인하세요.

매개변수: store_id

list_members

로열티 프로그램 회원 목록을 표시합니다. 프로그램 필터 및 페이지네이션을 지원합니다.

매개변수: programId?, limit?, offset?, status?

get_member

ID를 통해 특정 로열티 회원의 상세 정보를 확인할 수 있습니다. 암호화되지 않은 개인 식별 정보(PII) 필드를 반환합니다.

매개변수: member_id

list_coupon_pools

쿠폰 풀 목록. 상태 및 유형 필터 지원

매개변수: status?, coupon_type?, limit?, offset?

get_dashboard_stats

운영 대시보드 스냅샷(캡처, 스캔, 캡처율, 쿠폰, 매장, 플랜). 관리 대상 지표가 아니므로, 공식적인 비즈니스 지표는 지표 도구를 사용하세요.

매개변수: (none)

earn_points

회원에게 충성도 포인트를 부여합니다. 거래 ID와 새 잔액을 반환합니다.

매개변수: member_id, amount, description?

redeem_points

회원에게서 로열티 포인트를 차감합니다(선입선출 방식).

매개변수: member_id, amount, reason

get_points_balance

회원의 현재 포인트 잔액과 최근 거래 내역을 확인하세요.

매개변수: member_id, limit?

get_member_coupons

회원이 사용 가능한 (미사용, 만료되지 않은) 쿠폰을 확인하세요.

매개변수: member_id

get_member_tier

회원의 현재 등급, 다음 등급 업그레이드 요건, 그리고 모든 등급을 확인하세요.

매개변수: member_id

get_member_receipts

회원의 영수증 제출 내역과 OCR 상태, 적립된 포인트를 확인하세요.

매개변수: member_id, limit?

redeem_points_for_coupon

적립 포인트를 사용하여 지정된 쿠폰 풀에서 쿠폰을 교환하세요(최소 조건: 포인트 + 쿠폰, 또는 둘 다 아님).

매개변수: member_id, pool_id, points_cost

issue_coupon

쿠폰 풀에서 회원에게 쿠폰을 발행합니다(단일 회원 대상, 대량 대상은 So 확인 절차를 거쳐야 함). coupons:write 권한이 필요합니다.

매개변수: member_id, pool_id, run_id?

check_email_frequency

마케팅 이메일을 설정된 빈도 제한(하루 1회, 주 2회, 월 4회) 내에서 해당 주소로 발송할 수 있는지 확인하십시오.

매개변수: email

list_ambassador_candidates

로열티 프로그램의 홍보대사 후보 목록을 점수로 표시합니다(프로 모드). 라이트 모드에서는 목록이 비어 있습니다.

매개변수: band?, status?, level?, sort_by?, limit?, offset?

get_ambassador_metrics

앰배서더 ROI 보고서를 받아보세요: 세 가지 하위 목표, 2개월 차 유지율, 그리고 90일 후 진행 여부 결정 기준이 포함되어 있습니다.

매개변수: since_days?, assumed_paid_cac_usd?

issue_ambassador_code

회원의 개인 홍보대사 제휴 코드를 발급하거나 업그레이드합니다. 코드는 string으로 반환됩니다.

매개변수: member_id, single_use?, max_redemptions?, min_order_amount?

get_tracking_stats

페이지 방문/행동 분석 정보를 확인하세요: 개요, 인기 페이지, 기기별 분석, 트래픽 소스 등.

매개변수: metric?, period?, start?, end?, campaign?, limit?

get_member_profile

회원의 집계된 프로필(접근성, 동의/CCPA, 충성도, 상거래/카테고리/채널/참여도 집계, 명시된 선호도, 태그, 대략적인 지리적 위치, 연령대). 개인 식별 정보(PII)는 삭제됨 - 이름이나 연락처 값은 표시되지 않습니다. members:read 권한이 필요합니다.

매개변수: member_id

get_member_timeline

회원의 최근 활동 내역(방문, 포인트, 쿠폰, 이메일, 영수증) 및 요약 정보를 바탕으로 맞춤형 조치를 결정합니다. 암호화되지 않은 개인 식별 정보(PII)를 반환합니다. 필요 조건: members:behavior:읽다.

매개변수: member_id, limit?

list_segments

팀의 대상 그룹(이름, 상태, 캐시된 멤버 수) 목록을 표시합니다. segments:read 권한이 필요합니다.

매개변수: status?, limit?, offset?

create_segment

구조화된 조건을 사용하여 잠재고객 세그먼트를 생성합니다(SQL 사용 안 함). 중복을 제거합니다. 필수 사항 segments:write + 사용자 소유 키.

매개변수: name, conditions, description?

list_automations

팀의 자동화(이벤트 기반 캠페인) 목록과 상태를 표시합니다. automations:read 권한이 필요합니다.

매개변수: status?

pause_automation

캠페인 ID로 실행 중인 자동화를 일시 중지합니다(멱등성 보장). automations:write 권한이 필요합니다.

매개변수: campaign_id

list_campaign_templates

이 팀에서 사용 가능한 캠페인 템플릿(공식 및 저장된 템플릿) 목록을 확인하여 create_campaign_draft에 대한 template_id를 찾으세요. campaigns:read 권한이 필요합니다.

매개변수: limit?

list_campaigns

팀의 최근 캠페인 목록(ID, 제목, 상태)을 찾아보세요. source_campaign_id 초안을 복제하려면 다음이 필요합니다. campaigns:read.

매개변수: limit?, status?

create_campaign_draft

템플릿 또는 기존 캠페인을 기반으로 캠페인 초안을 생성합니다(절대 전송하지 마세요. 담당자 검토가 필요합니다). 필요 사항 campaigns:write-초안.

매개변수: title, template_id?, source_campaign_id?, segment_id?, merge_context?

check_member_reach

최근 기간 내에 채널에서 멤버와 이미 연락이 닿았는지 확인합니다(모든 시스템). 과도한 연락을 방지합니다. members:behavior:read 권한이 필요합니다.

매개변수: member_id, channel, days?

create_member

로열티 멤버를 생성하거나 기존 멤버를 멱등적으로 해결하려면 다음을 수행하십시오. externalId/이메일. 마케팅 동의는 이메일을 통해 활성화되어 있지 않습니다. MCP.필요합니다 members:write.

매개변수: email, fullName, phone?, externalId?, birthMonth?, birthDay?

update_member

회원의 프로필/신원 정보(이메일, 전화번호 등)를 업데이트하세요. fullName, externalId(상태). 팀 소유권이 강제됩니다. 필요 조건 members:write.

매개변수: member_id, email?, fullName?, phone?, externalId?, status?

upsert_store

이 팀의 externalId와 일치하는 스토어를 생성하거나 기존 스토어를 업데이트하세요. stores:write 권한이 필요합니다.

매개변수: name, externalId?, address?, city?, state?, country?, timezone?

ingest_order

구매 주문을 기록하고 포인트를 자동으로 적립합니다(회원이 해결함). memberId > externalId 이메일이 필요합니다. orders:write.

매개변수: externalOrderId, customer, totalAmount, financialStatus?, currency?, orderName?, storeId?

reverse_points

POS/ERP 환불 또는 취소를 위해 원래 거래 ID와 연결된 회원의 포인트를 회수(환수)합니다. 필요 조건: points:write.

매개변수: member_id, reversesTransactionId, amount, reason

get_member_tags

멤버의 현재 태그(키, 이름, 라이프사이클, 값, 출처)를 가져옵니다. assignedAt). 필요합니다 members:read.

매개변수: member_id

assign_tag

tag_key를 사용하여 회원에게 수동으로 태그를 할당합니다(운영자 재정의, 규칙 스윕에 고정됨). tags:write 권한이 필요합니다.

매개변수: member_id, tag_key, value?

remove_tag

tag_key를 사용하여 회원의 태그를 수동으로 제거할 수 있습니다(활성화된 태그는 다음 스윕 시 다시 추가될 수 있습니다). tags:write 권한이 필요합니다.

매개변수: member_id, tag_key

list_products

카테고리/브랜드/분야, 상태 및 출처별 제품 목록을 표시합니다. 상태별로 필터링할 수 있습니다.category_id/brand_id/세로. 필요 조건 catalog:read.

매개변수: status?, category_id?, brand_id?, vertical?, limit?, offset?

get_product

다양한 변형 상품, 일련번호가 부여된 상품, 조합 구성 요소 및 AI 기반 콘텐츠를 포함하는 하나의 제품을 받으세요. 필요 조건 catalog:read.

매개변수: product_id

list_brands

팀의 브랜드 목록(ID, 이름)을 입력하세요. 필수 입력 사항입니다. catalog:read.

매개변수: limit?

recommend_products

차선책 추천 제품: member_id (개인 맞춤형 공동 구매 + 카테고리 선호도) 또는 product_id (고객들이 함께 구매한 상품). 필수 사항 members:read.

매개변수: member_id?, product_id?, limit?

claim_winback_task

이 팀에 대해 다음으로 높은 우선순위의 복구 작업을 임대합니다(원자적). 작업, 임대 기한, 회원 보유 부문 및 이탈 신호 요약을 반환합니다. NO_TASKS_AVAILABLE / WINBACK_DISABLED가 isError로 반환되었습니다. winback:claim이 필요합니다.

매개변수: (none)

complete_winback_task

임대된 고객 재확보 작업을 결과(조치된 레버 + 참고 사항 또는 보류 사유)와 함께 완료합니다. 멱등성. LEASE_EXPIRED / ALREADY_COMPLETED는 isError로 반환됩니다. winback:claim이 필요합니다.

매개변수: task_id, acted?, lever?, action_ref?, note_id?, hold_reason?

get_winback_context

회원 가입 여부를 결정하기 전에 동의 여부, 이메일 수신 빈도 여유, 피로도, 최근 도달률, 이탈 신호, 그리고 가입을 미루고 있는 회원의 성향 등을 일회성으로 읽기 전용 사전 확인합니다. 이는 편의상 제공되는 미리보기 기능이며, 서버는 쓰기 시점에 모든 검증 절차를 여전히 수행합니다. winback:read 권한이 필요합니다.

매개변수: member_id

add_member_note

구성원의 승리 기록(근거/관찰된 신호/홀드아웃 지원 가설)에 자유 텍스트 프로세스 메모를 첨부합니다. 텍스트는 지침이 아닌 데이터로 저장됩니다. 최대 2000자, 삭제되었습니다. winback:write가 필요합니다.

매개변수: member_id, body, kind?, task_id?, action_ref?

send_winback_message

인센티브가 절대 묵묵부답으로 제공되지 않도록 관리되는 재가입 메시지(받은 편지함 또는 이메일)를 전송합니다. 서버 측 장애 조치 게이트: WINBACK_DISABLED, 작업 임대 소유권, HOLDOUT_NO_SEND(홀드아웃 메시지 전송 안 함), NOT_CONSENTED, FREQUENCY_CAPPED, CONTENT_REJECTED(검증 처리됨), BREAKER_TRIPPED — isError로 반환됩니다. 기존 전송 스택(구독 취소 바닥글 + 전송 계층에서 추가된 규정 준수)을 재사용합니다. winback:write 권한이 필요합니다.

매개변수: member_id, task_id, channel, subject?, body

get_member_behaviors

최근 기간(레이어 3, 최신 순) 동안 회원의 활성 활동을 분석하여 의도(레이어 4)를 추론합니다. 의도적인 고객 활동(탐색, 열기/클릭, 체크인, 구매, 쿠폰 사용, 추천, 콘텐츠 제출)만 카탈로그 라벨과 의미, 요약 정보(유형별 및 기간별 카운트)와 함께 표시합니다. 전체 기간에 대한 추론을 제공하며, 의도는 확인해야 할 가설일 뿐 사실이 아닙니다. 읽기 전용입니다. winback:read가 필요합니다.

매개변수: member_id, since_days?, limit?

claim_agent_task

이 팀에 대한 다음 상담원 결정 작업을 임대합니다(원자적, 선택적으로 종류별로 범위를 좁힐 수 있음). 작업 ID, 종류, 주제 정보 및 임대 마감일을 반환합니다. NO_TASKS_AVAILABLE / AGENT_TASKS_DISABLED는 isError로 반환됩니다. agent_tasks:claim 권한이 필요합니다.

매개변수: kind?

get_agent_task

결정하기 전에 에이전트 결정 작업의 정보(종류, 주제, 플래그 사유, 상태)를 읽어야 합니다. AGENT_TASK_NOT_FOUND는 isError로 반환됩니다. agent_tasks:read가 필요합니다.

매개변수: taskId

complete_agent_task

임대된 작업을 결정으로 완료하고, 기존의 멱등성 쓰기를 통해 그 효과를 적용합니다. fraud_household_referral: 차단(양측 환수) / 허용(플래그 해제) / 에스컬레이션(담당자에게 인계). ALREADY_COMPLETED / NOT_LEASE_OWNER / LEASE_EXPIRED는 isError로 반환됩니다. agent_tasks:claim이 필요합니다.

매개변수: taskId, decision, reason?

list_objects

이 팀이 분석할 수 있는 비즈니스 객체를 나열하세요. 핵심 플랫폼 객체(회원, 주문, 매장, 쿠폰, 캠페인, 제품, 세그먼트, 태그)와 이 팀의 객체가 포함됩니다. MCP-표시되는 사용자 정의 개체 — 키, 레이블 및 권위 있는 한 줄 의미. 먼저 호출하여 유효한 정보를 확인하세요. object 키. 필요합니다 introspection:read.

매개변수: (none)

describe_object

한 가지 사업에 대해 설명하세요. object 관리되는 레지스트리에서 가져온 정보: 권위 있는 의미와 속성이 사실(컬럼 기반), 파생(최신성을 유지하는 메트릭/태그/롤업 참조 - 품질은 절대 다시 파생되지 않음) 및 사용자 지정(이 팀의 사용자 지정 필드)으로 구분됩니다. PII 속성은 메타데이터만 반환하고 값은 반환하지 않습니다. fields=summary(기본값) 또는 full. 필수 사항 introspection:read.

매개변수: object, fields?

list_actions

관리되는 에이전트의 동작(에이전트가 수행할 수 있는 작업)을 나열하십시오: 대상 object부작용, 설정(자동/검토/금지), 서버 측 사전 조건 키, 값 제한 및 되돌리기 가능성 - 쓰기 제안 전에 자체 점검을 수행합니다. 선택적으로 필터링할 수 있습니다. object.필요합니다 introspection:read.

매개변수: object?

list_stamp_programs

팀의 스탬프 카드를 나열하세요 (eStamp프로그램 정보: ID, 이름, 완료에 필요한 스탬프 수, 보상 유형(쿠폰/포인트/수동), 자동 초기화 및 상태. 먼저 전화하여 확인하세요. program_id.필요합니다 stamp:read.

매개변수: (none)

get_member_stamp_cards

회원의 활성 스탬프 카드 정보(프로그램명, 현재 스탬프 수, 필요한 스탬프 수, 완료 횟수, 보상)를 확인하세요. 필요 조건: stamp:read.

매개변수: member_id

grant_stamps

스탬프 프로그램(예: 매장 방문)에 대한 스탬프를 회원에게 부여합니다. idempotency_key를 사용하여 멱등성을 보장하며, 카드 처리가 완료되면 보상(쿠폰/포인트)이 자동으로 지급됩니다. 호출당 스탬프 수량이 제한됩니다. stamp:write 함수가 필요합니다.

매개변수: program_id, member_id, amount?, reason?, idempotency_key?

get_member_points

회원 포인트: 사용 가능 잔액, 누적 적립 포인트, 사용 내역, 현재 등급, 만료 예정 포인트. 회원 전용 키 → 본인 포인트(member_id 생략); 팀 전용 키 → member_id 전달. loyalty:self:read 권한 필요.

매개변수: member_id?

get_member_points_history

회원의 최근 포인트 거래 내역(적립/사용/조정)이 최신순으로 표시됩니다. 회원 전용 키 → 본인 내역; 팀 전용 키 → member_id 전달. loyalty:self:read 권한이 필요합니다.

매개변수: member_id?

get_member_rewards

회원이 포인트를 사용하여 교환할 수 있는 리워드 — 포인트 비용이 포함된 카탈로그, 회원 잔액 대비 사용 가능 여부에 따라 표시됨. 회원 전용 키 → 본인 소유; 팀 전용 키 → member_id 전달. loyalty:self:read 권한이 필요합니다.

매개변수: member_id?

get_loyalty_program_rules

로열티 프로그램 작동 방식 - 적립률, 가입 보너스, 포인트 가치, 가입 방법 - 브랜드에서 승인한 FAQ 포함. 공개 정보. 회원 전용 키는 인수가 필요하지 않습니다. loyalty:self:read 권한이 필요합니다.

매개변수: member_id?

list_synthetic_scenarios

합성 패널 시뮬레이션 시나리오 목록과 각 시나리오의 실제 사용성 한계, 신뢰도 상한, 입력 필드를 나열하십시오. 먼저 유형을 선택하십시오. metrics:read 권한이 필요합니다.

매개변수: (none)

get_synthetic_calibration

브랜드의 합성 패널 보정(과거 합성 예측의 적중률 대 실제 결과, 백테스트가 존재할 때까지 null). metrics:read 권한이 필요합니다.

매개변수: (none)

get_synthetic_report

합성 패널 실행에 대한 고정된 정직한 보고서를 읽어보세요. 방향성 분석, 신뢰도 상한선, 억제 플래그, 테마 등을 확인할 수 있습니다. blockReason 준비되지 않은 경우. 필요합니다. metrics:read.

매개변수: run_id

run_synthetic_panel

합성 패널을 실행합니다. 특정 세그먼트의 익명화된 디지털 트윈이 자극에 반응하여 정확한 방향성 보고서(실제 절대 수치는 아님)를 생성합니다. 폴링에 사용할 run_id를 반환합니다. 일일 실행 제한이 있으며, 생성되는 트윈은 최대 50개입니다. synthetic:write 권한이 필요합니다.

매개변수: segment_id, kind, fields

안전 및 개인정보 보호

MCP 표면은 AI 편의 레이어이지 대량 관리 도구가 아닙니다. 몇 가지 유의해야 할 사항이 있습니다.

채팅이 아닌 서버가 경계입니다. 쓰기 작업(포인트 부여/교환, 쿠폰 발급, 앰배서더 코드 발급)에는 일치하는 쓰기 범위가 필요하며 및은 서버측 가드로 제한됩니다. 즉, 호출당 값 한도와 키당 쓰기 속도 제한이 모두 적용되며 모두 페일클로즈됩니다. AI 클라이언트가 요청하는 채팅 내 확인은 예의입니다. 서버는 실제로 유출된 키나 배수 지점에서 즉시 주입된 모델을 막는 역할을 합니다.
일부 읽기 도구는 회원 개인 식별 정보(PII)를 반환합니다. get_member 및 list_members과 같은 도구는 암호화 해제된 이름과 이메일을 AI 클라이언트로 반환할 수 있습니다. 해당 데이터를 적절하게 처리하고 최소 권한 키를 사용하는 것이 좋습니다.
절대 평문 키를 커밋하지 마십시오. 체크인된 .mcp.json에서는 항상 리터럴 키 대신 ${FLASH_API_KEY}를 참조하십시오.
최소 권한의 읽기 전용 키를 사용하세요. 필요한 도구만 사용할 수 있도록 키를 생성하세요. 키에 특정 도구의 범위가 지정되지 않은 경우, 해당 도구는 단순히 숨겨지며 목록에 나타나지 않습니다.

숫자는 관리되는 의미론적 레이어에서 가져옵니다.

AI가 보고하는 모든 지표(GMV, 활성 회원, 사용률 등)는 SocialHub의 관리형 지표 레이어를 거칩니다. 이 레이어는 각 지표에 대한 단일하고 권위 있는 정의(및 인증)를 보유하고 있습니다. list_metrics, describe_metric, query_metric, breakdown_metric, ask_metrics 도구는 해당 관리 체계 하에서 지표 키와 차원을 선택합니다. AI는 SQL 쿼리를 직접 작성하지 않습니다. 따라서 제공되는 수치는 임시방편적이고 변동성이 큰 집계가 아니라 대시보드와 일치합니다.

대화 예시

너: "활성 매장 모두 나열"

Claude: 상태가 "active"인 list_stores 호출

Claude: "다운타운 플래그십, 몰 키오스크, 공항 팝업 등 3개의 활성 매장이 있습니다."

SoCode — Claude Code에서 SocialHub 실행 AI 거버넌스: 자기 성찰 및 승인 REST API 참고 자료 빠른 시작 개발자 센터로 돌아가기

API 키 생성