Sentry와 Codex: MCP 서버를 추가하고 일정에 맞춰 오류 분류하기

Sentry 오류 분류에서 Codex가 하는 일

• 지난 실행 이후 새로 생겼거나 재발한 미해결 Sentry 이슈를 읽습니다.
• 먼저 보드를 확인하므로, 시끄러운 오류에는 새 이슈 열 개 대신 댓글 하나가 달립니다.
• 새 오류마다 영향, 처음과 마지막 발생 시각, 시작된 릴리스, 상위 스택 프레임, 추측이라고 표시한 추정 원인을 담아 이슈로 올립니다.
• 작고 명확한 것은 테스트와 함께 풀 리퀘스트로 고치고 리뷰를 기다립니다.

Sentry 오류 분류에 쓰는 Codex 기능

Sentry 오류 분류용 Codex 설정 방법

1. 도구 연결하기

   Sentry를 streamable HTTP 서버로 추가하고 한 번 로그인하세요. Sentry 문서에는 mcp-remote 브리지도 나와 있고 그것도 동작하지만, Codex에는 필요 없습니다.

   # ~/.codex/config.toml
   [mcp_servers.sentry]
   url = "https://mcp.sentry.dev/mcp"
   required = true
   
   # 그다음 OAuth로 로그인
   codex mcp login sentry

2. AGENTS.md에 규칙 쓰기

   Codex는 일을 시작하기 전에 AGENTS.md를 읽습니다. 먼저 ~/.codex/AGENTS.md를, 이어서 저장소 루트부터 작업 중인 폴더까지의 파일을 읽습니다. 이 일의 규칙을 여기에 넣거나, 길다면 .agents/skills/ 아래 스킬로 만드세요. AGENTS.md 가이드를 참고하세요.

   ## Sentry 오류 분류 규칙
   1. 지난 실행 이후 처음 발생했거나 재발한 프로덕션의
      미해결 이슈를 나열하세요.
   2. 이슈를 올리기 전에 보드에서 Sentry 이슈 ID를 검색하세요.
   3. 새 이슈에는 영향받은 사용자와 이벤트 수, 처음과 마지막
      발생 시각, 릴리스, 상위 스택 프레임, 추정 원인을 적고
      원인은 추측이라고 표시하세요.
   4. 가입, 결제, 데이터를 막으면 Urgent, 세션의 1% 이상이면
      High, 그 밖에는 Medium.
   5. 작고 명확한 수정: 테스트와 함께 풀 리퀘스트를 여세요. 머지하지 마세요.
   6. Sentry에서는 아무것도 해결, 무시, 삭제하지 마세요.

3. 대화형 화면 없이 실행하기

   codex exec 명령은 작업 하나를 실행하고 종료합니다. 진행 상황은 stderr로, 최종 메시지는 stdout으로 나옵니다. -o는 최종 메시지를 파일에도 쓰고 --json은 이벤트를 스트리밍합니다. --sandbox workspace-write를 넘기지 않으면 샌드박스는 읽기 전용입니다.

   # cron에서 분류 실행, 요약은 파일로
   codex exec --sandbox workspace-write \
     -o triage.md "AGENTS.md의 규칙대로 새 Sentry 오류를 분류해 줘"

4. 일정에 올리기

   ChatGPT 데스크톱 앱이나 웹에서 예약 작업을 만들거나(CLI로는 관리할 수 없습니다), cron에서 codex exec 명령을 실행하세요. Codex를 능동적으로 만드는 방법을 참고하세요.

출처: Codex 문서

한계와 안전

• Sentry 이슈는 읽기만 하면 되고 바꿀 필요는 없습니다. 해결과 무시는 사람에게 맡기세요.
• 원인은 스택 트레이스에서 나온 추측입니다. 수정이 출시되기 전에 사람이 확인합니다.
• 오류에는 사용자 데이터가 담길 수 있습니다. 에이전트가 올리는 이슈는 비공개 보드나 저장소에 두세요.
• Codex는 기본적으로 명령을 샌드박스 안에서 실행합니다. 쓰기는 워크스페이스 안에서만 되고 네트워크는 꺼져 있습니다. danger-full-access는 격리된 러너나 컨테이너에서만 쓰세요.

Sentry 오류 분류에는 Claude Code와 Codex 중 무엇을 쓸까요?

규칙은 그대로 옮겨 쓸 수 있습니다. AGENTS.md에 한 번 쓰고 CLAUDE.md에 @AGENTS.md를 넣으면 두 에이전트가 같은 파일을 읽습니다.

다른 에이전트용 단계별 안내: Claude Code에서 하는 Sentry 오류 분류.

Sentry 오류 분류 담당자 두기

명령어는 누군가 기억해서 실행할 때만 돌아갑니다. Crewmark는 내 Codex 세션을 역할, 숫자로 된 목표, 근무 시간, 하트비트를 갖춘 AI 직원으로 바꿔, 일이 일정에 맞춰 진행되고 보드에 올라오게 합니다.

1. 역할에서 시작하기

   AI 소프트웨어 엔지니어의 브리프에 이 규칙을 넣으세요.

2. 일을 보드에 올리기

   이 일을 반복 이슈로 추가하세요. 직원이 하트비트에 깨어나 일을 하고 댓글로 보고합니다.

3. 관련 페이지

   Sentry 오류 분류 페이지에 브리프 전체와 우선순위 규칙이 있습니다.

자주 묻는 질문