섭피디 — 설문 MCP

섭피디(SubPD)는 설문 전용 MCP 서버(subpd.moonpd.ai)입니다. AI 에이전트가 자연어로 설문을 만들고, 공유 링크·QR을 발급하고, 응답을 집계·내보내기 할 수 있습니다. 문피디(이북) MCP와는 별도 커넥터로 분리되어 있습니다.

연결 설정

Claude Desktop

{
  "mcpServers": {
    "subpd": {
      "url": "https://subpd.moonpd.ai/sse",
      "headers": { "Authorization": "Bearer mpd_xxxxxxxxxxxxxxxxxxxx" }
    }
  }
}

ChatGPT / Cursor

HTTP SSE 엔드포인트 https://subpd.moonpd.ai/sse + Authorization: Bearer ... 헤더.

Claude.ai 웹

Claude.ai 웹은 OAuth 2.0(Authorization Code + PKCE)로 연결합니다. OAuth 앱 발급은 문피디와 동일하게 마이페이지 → MCP·API 탭에서 진행합니다.

설정 항목	값
Client ID	Key ID (`mpdc_...`)
Client Secret	Key Secret (`mpds_...`)
Authorization URL	https://moonpd.ai/api/v1/oauth/authorize
Token URL	https://moonpd.ai/api/v1/oauth/token
Scope	survey:read survey:write survey:publish response:read

OAuth 흐름·PKCE·redirect_uri 정책 상세는 인증 문서의 OAuth 2.0 섹션을 참고하세요.

권장 워크플로

who_am_i — 계정 확인
create_survey — 자연어로 요청한 설문을 제목·문항·선택지 JSON으로 한 번에 생성
(선택) add_question · update_question · delete_question — 문항 추가·수정·삭제는 개시 전에 (진행중 설문은 문항 잠금)
publish_survey — status:"Y"로 공개
create_survey_share_link · get_survey_qr_code — 공유 링크·QR 발급
응답 수집 후 get_survey_summary(문항별 집계 JSON — 클로드가 차트로 렌더) · get_survey_responses(원시 응답)
export_survey_csv — CSV로 내보내 구글 시트에 적재

설문 관리 (7)

create_survey

제목·설명·문항(radio/checkbox/text/textarea/file/file_img)·선택지를 한 번에 생성. surv_tmpt_no 반환

update_survey

제목·설명·스킨 타입 수정 (문항 구성은 변경하지 않음)

list_my_surveys

내 설문 목록 (페이지네이션)

get_survey

설문 1건 상세 (문항·선택지 포함)

publish_survey

게시 상태 변경. status: Y=진행/공개, N=중지, S=준비/초안, E=종료/마감

close_survey

설문 마감 (publish_survey status=E 단축 도구)

delete_survey

설문 삭제 (soft delete, 응답 데이터는 보존)

문항 편집 (3)

add_question

기존 설문에 문항 1개(+선택지)를 추가. 새 문항의 item_no 반환

update_question

문항 수정 — 지정한 필드만 변경. options를 주면 해당 문항의 선택지가 전체 교체됨

delete_question

문항 1개 삭제 (선택지 포함, 소프트 삭제)

진행중(status=Y) 설문은 응답↔문항 매핑 보호를 위해 문항 편집이 잠깁니다. 문항을 바꾸려면 먼저 publish_survey로 상태를 S(작성중) 또는 E(종료)로 변경하세요. 제목·설명(update_survey)은 진행중에도 수정 가능합니다.

create_survey_share_link

설문 응답 페이지의 공유용 단축 URL 발급 (short_cd·short_url·target_url 반환)

get_survey_qr_code

인쇄용 QR PNG (size·margin 옵션)

enable_manager_share

관리자 실시간 공유 켜기 + 관리자 링크(manager_url) 발급. 이 링크 소지자는 응답을 마스킹 없이 조회·검색·엑셀 다운로드(개인정보 노출 — 담당자에게만 공유). 공개 공유(집계·마스킹)와 별도 링크

disable_manager_share

관리자 실시간 공유 끄기 — 관리자 토큰 무효화(기존 관리자 링크 즉시 만료)

결과 (3)

get_survey_responses

원시 응답 목록 (페이지 단위). mask=true(기본값)면 개인정보 마스킹

get_survey_summary

문항별 응답 집계(선택형은 개수·비율, 서술형은 마스킹된 텍스트 답변 목록) — 차트/시각화에 바로 사용

export_survey_csv

응답을 CSV(UTF-8)로 내보내기. 구글 시트에 바로 붙여넣기 좋음

계정 (1)

who_am_i

인증된 MoonPD 계정 정보

시나리오: 설문 → 공유 → 구글 시트

"설문 만들어줘"

자연어 요청을 create_survey 호출로 변환 — 문항·선택지까지 한 번에 생성하고 publish_survey로 공개합니다.

공유 링크·QR 생성

create_survey_share_link로 단축 URL을, get_survey_qr_code로 인쇄용 QR PNG를 발급합니다.

응답 집계·시각화

응답이 쌓이면 get_survey_summary로 문항별 집계 JSON을 받아 클로드가 바로 차트로 렌더합니다.

구글 시트로 내보내기

export_survey_csv로 CSV를 받은 뒤, 클로드가 자신의 Google Drive 커넥터로 구글 시트에 저장합니다. 섭피디 서버는 구글 자격증명을 갖지 않습니다.

구글 시트 연동에는 서버 측 구글 자격증명이 필요 없습니다 — 클로드 본인의 Google Drive 커넥터가 CSV를 시트로 옮깁니다.

웹 결과 대시보드

설문 소유자는 moonpd.ai/survey/dashboard/{설문번호}에서 로그인 후 KPI·문항별 차트를 볼 수 있습니다.

대시보드에서 "공유"를 켜면 moonpd.ai/survey/d/{토큰} 링크로 비로그인 사용자도 집계 결과(마스킹 유지)를 열람할 수 있습니다. 이 공개(집계) 공유 전환은 웹 화면 전용입니다. 반면 관리자 실시간 공유(미마스킹)는 MCP 도구 enable_manager_share · disable_manager_share로도 켜고 끌 수 있습니다.

에러 코드

코드	의미
`UNAUTHORIZED`	API 키 누락 또는 무효
`FORBIDDEN_SCOPE`	스코프 부족
`INVALID_INPUT`	입력 파라미터 오류
`NOT_FOUND`	대상 리소스 없음
`RATE_LIMITED`	분당 한도 초과(Retry-After 참고)
`INTERNAL_ERROR`	서버 오류