본문으로 건너뛰기

코딩 에이전트가 버그 리포트를 직접 읽는 MCP 서버

업데이트

Midge에는 버그 리포트용 MCP 서버가 있어요. Claude Code나 Cursor 같은 코딩 에이전트가 Midge 리포트를 직접 읽을 수 있게 해 줘요. 콘솔 에러, 네트워크 요청과 응답, 사용자의 클릭과 페이지 이동, 브라우저 정보까지요. 스택 트레이스를 채팅창에 복사해 붙여 넣는 대신 리포트 링크만 붙여 넣으면, 에이전트가 필요한 부분을 알아서 가져와요.

설정하기

Claude Code에서는 명령어 하나면 돼요.

claude mcp add --transport http midge https://midge.dev/mcp

Claude Code가 처음 이 서버를 쓸 때 브라우저에서 midge.dev가 열려요. 로그인하고 Allow(허용)를 클릭하면 다시 터미널로 돌아와요. Cursor를 비롯해 원격 MCP 서버를 지원하는 다른 클라이언트도 https://midge.dev/mcp 주소로 똑같이 연결돼요.

브라우저로 로그인할 수 없는 에이전트는 토큰을 대신 써요. midge.dev에서 Settings › Account › AI assistants를 열고, 에이전트를 고른 뒤 Create token을 클릭하세요. 그다음 Authorization: Bearer <token> 형태로 보내면 돼요.

어느 방식이든 에이전트는 Connected devices에 "Claude Code (MCP)" 같은 이름으로 표시돼요. 거기서 로그아웃시키면 그 에이전트는 더 이상 아무것도 읽을 수 없어요. 클라이언트별 자세한 설정은 문서 페이지에 있어요.

제공하는 도구

  • get_recording: 링크를 받았을 때 가장 먼저 쓰는 도구예요. 제목, 설명, 페이지, 기기, 길이, 방문한 페이지, 그리고 처음 발생한 콘솔 에러와 실패한 요청을 보여 줘요.
  • get_console: 메시지를 순서대로, 레벨별로(에러만, 경고와 에러, 또는 전부) 스택 트레이스와 함께 가져오고, 텍스트 검색도 돼요.
  • get_network: 메서드, 상태, 유형, 타이밍이 담긴 요청 목록이에요. 실패한 요청만, 또는 특정 엔드포인트 하나만 요청할 수 있고, 에이전트가 필요할 때만 헤더와 본문을 받아요. 그래서 4 MB짜리 로그 전체가 아니라 중요한 부분만 읽어요.
  • get_user_actions: 클릭, 입력(텍스트 자체는 절대 담지 않아요), 스크롤, 페이지 이동을 순서대로 보여 줘요. 그대로 재현 단계로 옮기기 좋아요.
  • list_recordings: 링크를 붙여 넣지 않았을 때를 위한 도구예요. 최근 리포트를 검색과 함께 보여 줘요.

흔한 사용 흐름은 이래요. Claude Code에 리포트 링크를 붙여 넣고 원인을 찾아 달라고 해요. 에이전트는 개요를 읽고, 실패한 요청을 본문과 함께 요청하고, POST /api/orders에서 검증 에러와 함께 돌아온 500을 찾아요. 이어서 콘솔에서 그에 맞는 클라이언트 쪽 에러를 읽고, 저장소에서 해당 핸들러를 열어요.

MCP란

Model Context Protocol은 AI 애플리케이션이 외부 도구와 데이터에 연결할 수 있게 해 주는 개방형 표준이에요. 서버는 "리포트 X의 콘솔 로그 가져오기" 같은 도구 묶음을 제공하고, Claude Code나 Cursor 같은 클라이언트는 작업 중에 그 도구를 호출해요. 서버는 한 번만 연결해 두면 되고, 언제 쓸지는 에이전트가 판단해요.

버그 수정에서 이게 중요한 이유는, 쓸모 있는 증거가 코드가 아니라 버그 리포트 안에 있기 때문이에요. 실패한 요청과 정확한 에러를 읽을 수 있는 에이전트는 곧장 올바른 파일로 갈 수 있어요.

접근 권한과 개인정보 보호

서버는 Midge의 다른 부분과 똑같은 접근 권한 검사를 거쳐요. 내 토큰을 가진 에이전트는 내가 열 수 있는 것만 열 수 있고, 그 이상은 못 해요. "Only me"(나만)로 설정한 리포트는 나만 볼 수 있고, 워크스페이스 리포트는 그 멤버들만 볼 수 있어요. 누구의 리포트든 "Anyone with the link"(링크가 있는 누구나)로 공유했다면, 브라우저에서와 마찬가지로 그 링크를 가진 로그인된 에이전트라면 열 수 있어요. 서버는 읽기만 해요. 무엇도 변경하거나, 삭제하거나, 공유할 수 없어요.

리포트는 Midge에 도착하기 전에 이미 가림 처리돼요. 비밀번호, 카드 번호, 토큰, 쿠키는 기기를 떠나기 전에 기기 안에서 제거돼요. 에이전트가 받는 데이터는 팀원이 보는 것과 똑같이 가림 처리된 데이터예요. 규칙 목록은 가림 처리 페이지에 있어요.

MCP 없이 쓰기

에이전트가 MCP를 지원하지 않아도, 리포트 내용을 손으로 채팅에 옮길 수 있어요.

  • cURL로 복사: 네트워크 로그 패널에서 실패한 요청을 열고 복사하세요. Authorization 헤더와 쿠키는 [REDACTED]로 들어가요. 채팅 기록에 남기기에 딱 맞는 형태죠.
  • 가림 처리된 HAR 다운로드: 리포트의 네트워크 로그를 HAR 파일로 첨부하세요. 에이전트는 HAR를 잘 다뤄요. 먼저 직접 확인하고 싶다면 무료 HAR 뷰어로 열어 보세요.
  • 콘솔 붙여 넣기: 에러와 스택 트레이스를 복사하고, 바로 앞에 경고가 있다면 그것도 함께 복사하세요.

왜 MCP인가

에디터 하나를 위한 플러그인을 만들 수도 있었어요. 하지만 MCP는 많은 에이전트와 에디터가 지원하기 때문에, 서버 하나로 Claude Code, Cursor, 그리고 팀이 다음에 쓸 도구까지 모두 지원할 수 있어요. 또 무엇을 읽을지를 에이전트가 직접 결정해요. 필요한 요청만 정확히 요청하죠.

다음은 Jira, Linear, GitHub Issues, Slack 연동이에요.

Midge는 무료예요. 녹화 횟수 제한이 없고, 영상은 최대 15분까지, 워터마크도 없어요.

자주 묻는 질문

Midge MCP 서버는 지금 쓸 수 있나요?
네, 무료예요. 에이전트에 https://midge.dev/mcp 를 추가하고(Claude Code라면 claude mcp add --transport http midge https://midge.dev/mcp) 요청이 오면 브라우저에서 Midge에 로그인하세요. 로그인할 수 없는 에이전트는 Settings › Account › AI assistants에서 만든 토큰을 써요.
어떤 에이전트와 함께 쓸 수 있나요?
헤더를 지원하는 Streamable HTTP 방식의 원격 MCP 서버를 쓸 수 있는 클라이언트라면 모두 돼요. Claude Code와 Cursor도 포함이에요.
에이전트는 무엇을 읽을 수 있나요?
리포트 개요(제목, 설명, 페이지, 기기, 방문한 페이지), 콘솔 메시지, 필터와 본문을 포함한 네트워크 요청, 사용자의 단계별 동작이요. 읽기만 할 수 있고, 토큰을 만든 사람이 열 수 있는 리포트만 읽어요.
에이전트가 제 비밀 정보를 보게 되나요?
아니요. 리포트는 브라우저나 Mac에서 업로드 전에 가림 처리되기 때문에, Midge는 원래 값을 저장하지 않아요. MCP 서버는 Midge가 가진 것, 즉 가림 처리된 데이터만 돌려줄 수 있어요.