MCP 서버

DimensionKit은 원격 MCP 서버를 운영하여 AI 어시스턴트가 귀하를 대신해 스코어카드를 생성, 수정, 발행하고 응답 결과를 분석할 수 있도록 지원합니다.

https://app.dimensionkit.com/mcp

원격 MCP 서버를 지원하는 클라이언트에 위 URL을 입력하세요. 연동 방법은 클라이언트 연결하기를, 연결 현황 확인 및 권한 취소는 연결 관리하기를 참조하세요.

지원하는 주요 기능

• 스코어카드 생성, 영역 및 문항 추가, 등급 기준 설정, 발행
• 이미 라이브 운영 중인 스코어카드의 문항 및 영역 수정 및 삭제
• 영역별 점수 및 응답자가 선택한 답변을 포함한 제출 내역 조회
• 스코어카드가 발행 가능한 완성도를 갖추었는지 사전 검사 및 취약점 진단
• 라이브 반영 전 초안을 확인할 수 있는 미리보기 링크 생성

스코어카드 구축 절차

실제 제작 흐름에 맞추어 도구들이 설계되어 있습니다:

1. scorecard_design_guide — 문항 작성 전 반드시 확인해야 할 설계 가이드라인
2. create_scorecard — 기본 표현 및 브랜딩 설정이 포함된 초안 생성
3. add_dimension — 측정할 핵심 평가 영역 정의
4. add_questions — 특정 영역에 속하는 모든 문항을 한 번에 일괄 추가
5. set_dimension_tiers — 점수 구간별 등급 명칭 및 맞춤 진단 인사이트 등록
6. check_scorecard — 발행 적합성 검사 및 부족한 부분 감지
7. publish_scorecard — 일반 공개 발행

초안 상태의 스코어카드는 외부에 공개되지 않습니다. 도구 반환값에 미래의 URL이 urlIsLive: false 플래그와 함께 전달되므로 어시스턴트가 실수로 외부에 유출하지 않습니다.

단순 스키마를 넘어선 설계 지침

scorecard_design_guide에는 기계적 스키마만으로는 전달할 수 없는 핵심 노하우가 담겨 있습니다: 작업 시작 전 사용자에게 물어봐야 할 핵심 사항, 왜곡 없는 선택지를 설계하는 법, 가치 있는 등급별 인사이트 작성법, 타깃에 맞는 테마 선택 기준(테마 및 브랜딩 참조) 등입니다. 이 가이드를 먼저 읽은 어시스턴트는 임의로 짐작하지 않고 대상 독자와 톤앤매너를 먼저 질문합니다.

MCP 프롬프트를 지원하는 클라이언트에서는 build_scorecard, review_scorecard, choose_theme의 3가지 대화형 명령어 인터뷰도 이용할 수 있습니다.

발행 전 초안 미리보기

초안을 대상으로 하는 모든 도구 응답에는 previewUrl이 포함됩니다. 24시간 동안 유효한 서명된 링크로, 응답자가 보게 될 화면과 완전히 동일한 상태를 보여줍니다. 미발행 초안 안내 배너가 표시되며 이 화면을 통한 테스트 제출은 데이터베이스에 기록되지 않습니다.

도구가 강제하는 두 가지 규칙

등급 점수 구간은 계산되는 값이며 수동 지정할 수 없습니다. 영역 점수는 최저 선택지 점수의 합과 최고 선택지 점수의 합 사이에서 결정되며, 등급 구간은 그 간격을 빈틈없이 균등 분할합니다. 문항의 추가, 수정, 삭제 시 점수 폭이 변하므로 구간은 시스템이 자동 재계산합니다. 사용자는 등급 명칭과 인사이트 문구만 지정합니다.

문항 ID와 영역 키는 영구적입니다. 제출된 응답은 문항 ID에, 점수는 영역 키에 매핑되어 저장됩니다. 이 식별자들을 수정하면 기존 데이터와의 연동이 깨지므로 update_question과 update_dimension은 해당 식별자를 제외한 나머지 항목만 수정할 수 있습니다.

운영 중인 스코어카드 수정

완전히 안전합니다. 모든 제출 데이터는 제출 당시의 점수, 등급, 문구 원본과 설정 해시값을 함께 영구 보존합니다. 이후 스코어카드를 수정하더라도 과거 응답 결과가 변경되지 않습니다.

제출 데이터가 존재하는 스코어카드의 경우 도구가 제출 건수를 반환하므로 어시스턴트가 수정 전 영향도를 안내할 수 있습니다.

의도적으로 지원하지 않는 기능

• 서버 주도적 추가 질문(Elicitation). 상시 열려 있는 양방향 연결이 필요하지만 본 서버는 이를 유지하지 않습니다. 필요한 질문은 사용자와 어시스턴트 간의 일반 채팅창에서 이루어집니다.
• 스트리밍. 단일 요청-응답 구조로 작동하며 지속적인 SSE 연결을 유지하지 않습니다.
• 결제 및 계정 관리 접근. 권한 스코프는 스코어카드와 제출 데이터로 엄격히 제한됩니다.
• 공개 쓰기 REST API. REST 엔드포인트는 읽기 전용 및 폼 제출로 유지되며, 모든 수정 작업은 MCP 또는 관리자 웹 화면을 통해서만 이루어집니다.