MCP Questionnaire

Claude 대화 내부의 구조화된 입력 표면 — 미리 채워진 양식, 가정 원장, 검토 매트릭스 — 명확화 질문을 산문 불릿 대신 사용합니다. 에이전트는 가능한 것을 추론하고, 모든 값에 출처가 미리 채워진 양식을 렌더링하며, 당신의 작업은 제안을 감사하는 것이지 작성하는 것이 아닙니다. 답변은 모델 컨텍스트로 직접 흘러갑니다.

DESIGN.html이 표준 사양입니다 (브라우저에서 열어보세요 — 목업은 클릭 가능합니다). 이 README는 설치 및 실행 방법만 알려줍니다.

설치 (Claude Code)

한 번의 설치로 커넥터 및 양식이 올바른 선택인 때를 아는 스킬을 얻을 수 있습니다:

/plugin marketplace add JakubMMazurek/MCP-Questionnaire
/plugin install mcp-questionnaire@mcp-questionnaire

또는 셸에서:

claude plugin marketplace add JakubMMazurek/MCP-Questionnaire
claude plugin install mcp-questionnaire@mcp-questionnaire

Related MCP server: Pane

설치 (claude.ai / Claude Desktop — 양식이 렌더링되는 곳)

설정 → 커넥터 → 사용자 지정 커넥터 추가 → packages/plugin/.mcp.json에서 URL을 붙여넣으세요. Claude가 GitHub 로그인으로 안내합니다. GitHub 로그인이 서버의 허용 목록에 있으면 연결된 상태로 돌아옵니다. 첫 번째 렌더링에서 일회성 "항상 허용" 권한을 요청합니다. 웹/데스크톱에서 먼저 추가하세요 — 모바일은 거기서 가져옵니다.

접근 제어

커넥터 URL은 공개적이며 아무것도 포함하지 않습니다. 모든 MCP 요청에는 OAuth 토큰이 필요하며, 토큰을 얻는 유일한 방법은 packages/worker/wrangler.jsonc의 GITHUB_ALLOWED_USERS에 나타나는 로그인을 가진 GitHub 계정으로 로그인하는 것입니다 — 쉼표로 구분되며 대소문자를 구분하지 않습니다. 다른 사람은 403을 받고 토큰을 얻지 못합니다.

팀원 추가: GITHUB_ALLOWED_USERS에 GitHub 로그인을 추가하고 Worker를 재배포하세요. 제거: 항목을 삭제하고 재배포하세요. 그러면 새 인증이 즉시 차단되고, 여전히 보유한 토큰은 자체적으로 만료됩니다 (또는 OAUTH_KV 네임스페이스에서 grant:/token: 키를 삭제하여 단축할 수 있습니다).

이것은 원래의 "인증 없음" 결정(DESIGN.html §3)을 의도적으로 뒤집은 것입니다. URL 경로가 기능이었던 때가 있었고, 이는 이 저장소가 비공개로 유지되는 동안에만 작동했습니다. 커넥터가 플러그인 마켓플레이스에서 설치되어야 하게 되면서 더 이상 유효하지 않게 되었습니다. 양식 ID는 내부적으로 기능으로 남아 있습니다.

저장소 맵

개발

pnpm install
pnpm -r test            # 359 tests
pnpm --filter @mcpq/ui dev    # offline host harness at localhost:5173/dev/
pnpm build              # single-file renderer bundle, verified self-contained

배포 (packages/worker): pnpm exec wrangler deploy. 두 개의 비밀 값이 GitHub OAuth 앱의 자격 증명을 담고 있습니다 —

wrangler secret put GITHUB_CLIENT_ID
wrangler secret put GITHUB_CLIENT_SECRET

— Authorization callback URL이 https://mcp-questionnaire.<account>.workers.dev/callback인 GitHub OAuth 앱에서 가져옵니다. 비밀 값을 tr -d '\n'로 파이프하세요: 후행 개행 문자가 이전에 이 배포를 망친 적이 있습니다. 허용 목록 (GITHUB_ALLOWED_USERS)은 비밀이 아닌 vars 항목이므로 wrangler.jsonc에 포함되어 검토 가능한 diff로 변경됩니다. .dev.vars는 로컬 실행을 위한 명백한 가짜 값을 보관합니다.