도움이 필요할 때: 한국어 지원 채널

일반 문의는 문의 양식을 사용하세요. 재현 단계를 함께 적어 주세요.

버그는 버전, 환경(OS/터미널), 재현 단계, 기대 동작과 실제 동작을 적어 주세요. 문의 양식으로 보내면 됩니다.

원하는 기능과 어떤 상황에서 필요한지 문의 양식으로 알려 주세요.

결제나 계정 문제는 마이 페이지에서 확인하고 문제가 지속되면 문의 양식으로 보내 주세요.

보안이나 개인정보 문제가 의심되면 일반 문의 양식으로 알려 주세요. 별도 보안 신고 채널은 확인되지 않았습니다. 기밀 신고 절차도 확인되지 않았습니다.

많은 문제를 문서와 문제 해결 섹션에서 먼저 해결할 수 있습니다. 설치, 한글 터미널, MCP 연결 문제가 여기에 있습니다.

문의의 예상 응답 시간은 확인되지 않았습니다. 보안 문제를 포함한 문의는 위 문의 양식으로 보내 주세요.

보내기 전에 내용과 첨부 화면을 직접 확인하세요. 문의 양식은 일반 연락 경로이며 기밀 신고 채널이나 응답 시간 보장은 확인되지 않았습니다. 문의 화면과 실제 처리 이력도 이 페이지에서는 아직 검증하지 않았습니다.

문제가 생긴 목적과 바로 앞에서 한 행동, 기대한 결과와 실제 결과를 나눠 적어 주세요. 예를 들어 한글 파일을 찾는 문제라면 열린 폴더, 검색어와 찾으려던 연습 파일을 설명할 수 있습니다. 설치 명령을 찾지 못한 문제와 로그인 뒤 권한 오류는 다른 증상이므로 한 문장에 섞지 않는 편이 좋습니다. 사용 버전과 운영체제, 터미널도 함께 적으면 환경을 구분할 수 있습니다.

처음부터 전체 저장소를 보낼 필요는 없습니다. 민감정보 없는 작은 연습 자료로 같은 증상이 나는지 확인하고 필요한 오류 구간만 남겨 보세요. 증상이 매번 발생하는지, 특정 입력에서만 나타나는지도 구분합니다.

사용자 경로, 계정 이메일과 고객 정보가 오류 메시지 밖에 표시될 수도 있습니다. 화면의 다른 창과 주소 표시줄, 첨부 파일의 내용도 따로 살펴야 합니다.

재현에 필요한 값은 가상 값으로 바꿔 증상이 남는지 확인하고, 실제 값이 있었다는 사실만 설명할 수 있습니다. 이미 노출이 의심된다면 해당 서비스의 토큰 회수 등 조직이 정한 절차를 따로 확인하세요.

결제 문제에는 발생 시점과 확인이 필요한 항목을 적되 카드 전체 번호와 보안코드, 로그인 비밀번호는 보내지 마세요. 마이 페이지와 실제 결제 화면에서 보이는 상태를 먼저 확인합니다. 같은 계정이라고 생각했지만 다른 로그인이나 결제 경로를 사용했는지도 구분할 수 있습니다. 화면의 안내와 실제 청구가 다르면 필요한 부분을 가려 함께 설명하세요.

갱신과 해지 상태는 실제 결제처에서 확인해야 합니다. 다른 도구로 옮겼다고 기존 구독이나 API 사용이 자동으로 멈춘다고 가정하지 않습니다.

원하는 버튼 이름만 적기보다 현재 어떤 일을 하다가 막히는지 설명하면 맥락을 전달하기 쉽습니다. 어떤 입력을 주고 어떤 결과가 필요한지, 지금은 어떻게 처리하는지 적어 주세요. 공개 승인이 없는 사내 문서와 고객 자료 대신 가상의 예시를 사용할 수 있습니다. 접근성과 한국어 입력 같은 환경 조건도 필요한 범위에서 남기면 됩니다.

버그와 기능 제안도 구분해 주세요. 문서에 안내된 동작과 실제 동작이 다른지, 아직 없는 기능이 필요한지에 따라 설명할 근거가 다릅니다.

연습용 문의를 쓴다면 실행하려던 작업, 사용한 공식 안내와 실제 오류를 나눠 적을 수 있습니다. 명령이 보이지 않는다면 새 터미널에서도 같은지, 버전 출력은 나오는지 설명하세요. 실행 파일이 열리지만 인증에 실패한다면 설치 문제와 구분하고 오류 문구를 남깁니다.

재현할 때 환경을 여러 개 동시에 바꾸면 어떤 조치가 영향을 줬는지 알기 어렵습니다. 안전한 범위에서 한 조건씩 비교하고 원래 상태를 기록해 주세요. 잘못된 경로를 찾았더라도 기존 파일을 곧바로 삭제하지 않습니다. 다른 작업에서 쓰는 설치일 수 있으므로 출처와 사용 범위를 확인해야 합니다. 문의를 준비한다는 이유로 조직 정책을 우회하거나 계정 권한을 넓힐 필요는 없습니다.

원래 요청과 기대한 변경, 실제로 달라진 부분을 구분해 주세요. 오류 문구 수정이라면 코드 계약까지 바뀌었는지, 예상 밖 파일이 수정됐는지 확인합니다. 테스트의 실패 구간과 실행하지 못한 항목도 남길 수 있습니다. 에이전트의 최종 답변만 보내기보다 필요한 diff와 실제 출력을 가려 준비하면 관찰한 결과를 설명하기 쉽습니다.

복구 전에 문의하려면 원본과 현재 변경을 별도로 보관하세요. 복구 범위와 주의 사항은 시작 가이드의 되돌리는 법 항목에 적혀 있습니다. 문의 자료에는 이런 행동을 실제로 수행했는지와 현재 상태를 설명하면 됩니다.

설치, 한글 입력과 MCP 연결이 모두 어렵다면 각각 어느 단계에서 막혔는지 적어 주세요. 한 문의 안에서도 증상별로 기대와 실제 결과를 나누면 됩니다. 이미 해 본 조치는 결과와 함께 남기고 실행하지 않은 제안을 수행한 것처럼 쓰지 않습니다. 같은 오류가 반복된다고 원인도 같다고 단정하지 말고 발생 조건이 다른지 확인하세요.

공유한 내용이 충분하지 않다면 추가 설명이 필요할 수 있습니다.

처음 보낸 증상과 다른 오류가 생겼다면 기존 오류가 사라졌는지, 새 조건에서만 나타나는지 적어 주세요. 조치를 한 뒤 화면이 달라졌다는 사실만으로 원인이 해결됐다고 결론내리지 않습니다. 같은 입력과 환경에서 기대 결과를 다시 확인하면 무엇을 추가로 물어야 할지 정하기 쉽습니다. 문제 해결을 위해 수행한 행동과 아직 제안만 받은 행동도 나눠 남겨 주세요.

코드나 설정을 바꿨다면 이번 문의와 관련된 범위만 설명합니다. 다른 사람의 미완성 변경과 섞였다면 임의로 되돌리지 말고 보관할 내용을 먼저 확인하세요. 연습 자료로 재현했다면 실제 환경에서 생략한 조건을 적을 수 있습니다. 가상 예제에서 재현되지 않았다면 그 차이 자체가 조사할 단서가 됩니다.

외부 도구가 보이지 않는다면 /mcp에 표시된 연결 상태와 오류 문구를 먼저 적어 주세요. 주소 오류인지 확인하려면 서비스의 공식 MCP 안내와 입력한 주소를 비교해야 합니다. 로그인 오류라면 해당 서비스에서 인증을 다시 진행하고, 별도 프로그램이 필요한 연결이라면 그 프로그램이 설치되어 있는지도 알려 주세요.

한글이 중복되거나 커서가 어긋나는 문제는 사용 중인 터미널 프로그램, 운영체제, 입력기와 실제로 입력한 순서를 함께 적어 주세요. 같은 문장을 일반 텍스트 편집기에서 입력했을 때도 같은 증상이 나는지가 중요한 단서입니다. 파일을 열었을 때 글자가 깨진다면 원본을 따로 보관한 상태에서 파일 이름과 증상을 알려 주세요. 원본 내용은 문의에 필요한 구간만 골라 보내 주세요.

문의 양식 링크는 로그인 상태에 따라 다른 곳으로 이동합니다. 로그인한 상태에서는 계정 쪽 문의 화면으로, 로그인하지 않은 상태에서는 회사의 문의 페이지로 이동합니다. 계정 상태가 필요한 문의라면 로그인한 상태에서 링크를 여는 편이 맞습니다. 결제나 계정 화면의 상태를 설명할 때는 어느 쪽으로 이동했는지도 함께 적어 주세요.

설치 명령을 찾지 못하는 문제라면 새 터미널에서 mirr --version을 실행한 결과를 적어 주세요. 설치 로그의 완료 메시지와 실제 실행 파일 경로가 다르다면 두 경로를 함께 알려 주시면 됩니다. 로그인 문제라면 브라우저가 열리지 않았는지, 터미널에 표시된 인증 코드가 만료됐는지를 나눠 적으면 확인하는 데 도움이 됩니다. 브라우저 로그인은 끝났는데 터미널에 완료 메시지가 없다면 그 점이 중요한 단서입니다.

응답이 멈춘 것 같다는 문의에는 화면이 파일을 읽는 중이었는지, 명령을 실행하는 중이었는지, 승인을 기다리는 상태였는지를 적어 주세요. 진행 중인 응답을 Ctrl+C로 중단했다면 중단한 시점과, 그 전에 실행된 파일 수정이나 외부 서비스 작업이 있었는지도 함께 알려 주세요. 화면에 표시된 내용을 보내면 연결 오류인지 요청이 실행된 뒤의 오류인지 나누는 데 도움이 됩니다.

업데이트 명령이 실패하면 나온 오류 문구를 그대로 보관해 주세요. 설치와 로그인 문제 문서는 다운로드가 실패했을 때 그 문서를 확인하라고 안내하며, npm으로 다시 설치할 필요는 없다고 적고 있습니다. 문의에는 실행한 mirr upgrade 명령과 오류 문구를 함께 적으면 됩니다.