Repository navigation
Releases
v0.3.0 — Claude API 및 Claude Code 지원
0.3.0
npm rebut-mcp@0.3.0과 태그 v0.3.0을 발행했습니다. 운영 Worker도 0.3.0으로 배포했습니다. 기존 클라이언트 설치는 이번 작업에서 업데이트하지 않았습니다. 패키지 이름은 rebut-mcp, 실행 명령은 rebut이며 Node.js 24 이상이 필요합니다.
Claude API와 Claude Code
OpenAI에 더해 Claude Messages API를 지원합니다. 검토 공급자와 MCP 호스트는 별도로 선택합니다. 로컬 macOS Keychain 예시:
rebut set mode local
rebut set provider anthropic
rebut set api-key
rebut setup --client claude
rebut doctor --connect- 기존 OpenAI·Codex 설정과 키는 유지합니다. 공급자별 키 하나를 명시적으로 사용하며 계정·키 순환이나 공급자 fallback은 하지 않습니다.
- Claude Code 사용자 MCP 등록·제거를 지원합니다. 다른 JSON 값과 큰 정수 리터럴을 보존하고, 충돌·중복 키·잘못된 경로·크기 초과·관측된 동시 수정은 거부합니다. 변경 전 호스트를 종료하고 설정을 백업하세요.
- Keychain, Vaultwarden, env를 선택할 수 있습니다. Anthropic env는
REBUT_ANTHROPIC_API_KEY를 사용해 Claude Code 자체 인증과 구분합니다. 관리자 토큰은 호스트에 전달하지 않습니다. claude-medium기본 프로필은 Claude Opus 5.5 / medium입니다. 모델·가격·사용 권한은 프로필과 공급자 계정에서 확인합니다.
전송 대상 고정과 진단
- 새 수집 번들은 schema 2로 공급자를 명시하고 해시에 포함합니다. 첫 제출 전에 프로필의 공급자가 바뀌면
provider_mismatch로 키 조회·예약·외부 호출 전에 거부합니다. 확인 후 새 번들을 수집해야 합니다. - schema 1의 기존 해시·fingerprint는 유지합니다. 새 schema 1 요청은 OpenAI로만 허용하며 이미 제출된 ID는 원래 번들로 메타데이터를 조회합니다. 다른 ID로 불확실한 요청을 재실행하지 마세요.
- 공급자별로 예산을 늘리지 않습니다. 한 장부의 예산·동시성을 공유하고 unknown 예약을 자동 해제·환불·만료하지 않습니다. DB 마이그레이션은 추가하지 않습니다.
- 일반
rebut doctor는 SQLite를 만들지 않습니다.--connect는 MCP 확인, 선택적인 로컬--provider는 모델 메타데이터 조회입니다. 명시적 진단·env 등록·수집의 프로필 해석은 저장소를 초기화할 수 있습니다. 메타데이터 조회는 생성 권한·잔액·품질을 입증하지 않습니다.
0.2.x에서 Worker를 사용 중인 경우
schema 2를 읽는 서버가 먼저 필요합니다. 아래 순서를 지키고, 코드 업데이트 단계에서는 기존 OpenAI 프로필·비밀 설정·D1을 유지하세요.
- 기존 OpenAI 설정 그대로 Worker 코드만 0.3.0으로 업데이트합니다. 새 코드는 schema 1·2를 받습니다.
- CLI를 0.3.0으로 업데이트하고 사용하는 각 호스트의 등록을 갱신한 뒤 재시작합니다. 사용자 지정
REBUT_CONFIG_DIR등은 유지합니다. - 그다음 Worker의
ANTHROPIC_API_KEY시크릿과 Anthropic 프로필을 추가합니다. 0.2.x 클라이언트가 새 공급자 프로필 목록을 읽지 않도록 합니다.
0.1.x에서 시작한다면 먼저 CLI를 0.2.x로 올려 긴 대기 제한에 대응하세요. 기존 요청·예약·인증 주체 ID를 보존합니다. 로컬 모드 전환은 장부 이전이나 미해결 요청의 재실행 허가가 아닙니다. 0.3.0 설정·프로필은 0.2.x가 거부할 수 있으므로 롤백 전 백업과 호환성을 확인하세요.
공급자·HTTP 클라이언트·호스트 도구 제한은 각각 1,800·1,830·1,860초이며 모든 네트워크 연결의 유지를 보장하지 않습니다.
검증
- 병합된 main에서 타입 검사·빌드·모의 테스트 222개와 정확히 같은 tarball의 설치 smoke를 통과했습니다. CI 대상은 macOS/Ubuntu의 Node.js 24/26입니다. Windows 동작·ACL은 검증하지 않았습니다.
- 구현 중 실제 Claude Opus 5.5 / medium 호출 한 번이 합성 코드의 결함을 지적했습니다. 903 입력·219 출력 토큰, 약 8.9초, 앱 예상 비용 $0.007992였습니다. 같은 요청 재제출은 추가 API 호출 없이 메타데이터만 반환했습니다. 이는 작은 사례의 검증이며 모든 모델·계정·검토 품질의 보장이 아닙니다.
- 실제 Claude Code의 격리된
--bare mcp등록·연결과 env 확장, 합성 값의 실제 Keychain 쓰기·읽기 후 정리를 확인했습니다. 개인 호스트 설정이나 실제 키를 변경하지 않았습니다.
배포물
- 소스 커밋:
92e3497fd606be221667cb4b59b10dfa29917519 - 패키지:
rebut-mcp@0.3.0(31개 파일) - SHA-256:
aeabcf782c3bebdd9208d0094a4b565623a244ff375064bd000be61b687313ec - npm 무결성:
sha512-7LkraPPy6DaDVghmHHbc1nw7C1BPiJ4PVNblx0k2wffRXYKTlyTSU7q7VVLApjoMClkZyXCAprCv6KAUNJ3zMw==
GitHub Actions 발행은 Environment 승인 후 tarball 경로를 Git 주소로 해석하는 오류로 npm 인증 전에 중단됐습니다. 태그를 이동하지 않고 위 SHA-256의 동일한 파일을 소유자 인증으로 수동 발행했습니다. 0.3.0에는 OIDC provenance가 없습니다. 경로 수정은 독립 리뷰를 거친 Draft PR #28로 분리했으며, OIDC 발행의 종단 간 성공은 후속 릴리즈에서 확인해야 합니다.
운영 Worker는 기존 OpenAI 프로필·시크릿·D1 바인딩을 유지했습니다. MCP 초기화 응답의 버전 0.3.0과 도구 두 개를 확인했고, 기존 0.2.0 클라이언트의 연결도 성공했습니다. 배포 전후 장부의 상태별 건수·예약액·과금액은 동일했습니다. 이번 배포에서는 새 Anthropic 시크릿·프로필을 활성화하거나 유료 검토를 추가 실행하지 않았습니다.
Rebut 0.2.0 — 로컬 실행 기본 지원
npm rebut-mcp@0.2.0 정식 릴리즈입니다. 로컬 실행을 기본으로 제공하며 Cloudflare Worker를 선택적으로 지원합니다.
GitHub 저장소 이름은 abruption/rebut입니다. npm 패키지는 rebut-mcp, 실행 명령은 rebut을 유지합니다. Node.js 24 이상이 필요합니다. 0.1.0에서 바로 업그레이드하는 버전이며, 미발행 중간 버전 0.1.1의 변경을 포함합니다.
로컬 실행을 기본으로 제공
새 설치는 Cloudflare 없이 로컬 stdio MCP 서버에서 자신의 OpenAI API 키로 검토합니다. 별도의 HTTP 서버나 수신 포트를 열 필요가 없습니다. 검토 자료는 OpenAI API로 전송합니다.
로컬 SQLite 원장은 예산 예약·요청 중복 방지·사용량 메타데이터를 재시작 후에도 보존합니다. 코드·리뷰 원문·키는 장부에 저장하지 않습니다. Cloudflare Worker와 D1은 여러 기기가 하나의 원장을 공유하는 선택적 백엔드로 계속 지원합니다.
- 기존 endpoint 설정이 있는 사용자는 Worker 모드를 유지합니다.
rebut set mode local|worker로 명시적으로 선택합니다.rebut set endpoint URL도 Worker 모드를 선택합니다. 장애 시 다른 백엔드로 자동 대체하지 않습니다.- 새 로컬 원장의 기본값은 UTC 하루 $6.66·월 $200·요청당 $6.66, 동시 미해결 요청 1개, 하루 신규 요청 100건입니다.
- 로컬 한도는 해당 기기의 데이터 디렉터리 단위입니다. 다른 Mac·Worker·OpenAI 계정 사용량과 합산하지 않습니다.
- 백엔드 전환은 기존 요청·예약을 이전하거나 해제하지 않습니다. unknown 요청을 다른 백엔드에서 새 ID로 우회 재실행하지 마세요.
긴 검토와 불확실한 결과 처리
- 공급자 대기 상한을 **1,800초(30분)**로 늘립니다.
- HTTP·MCP 클라이언트는 1,830초, Codex 도구 제한은 1,860초로 설정해 공급자 결과와 장부 처리를 기다릴 여유를 둡니다. 초기 접속 제한은 별도입니다.
- npm CLI·stdio 브리지·소스 실행 클라이언트와 저장소의
scripts/bw-client.py경로가 같은 연결 구현을 사용합니다. Node HTTP의 별도 기본 제한도 조정합니다. - 원문 없이 확인 가능한 unknown 원인·경과 시간 등 제한된 진단 메타데이터를 보강합니다. 자동 유료 재시도는 추가하지 않습니다.
- 기본 설정에서는 unknown 한 건이 신규 검토를 막을 수 있습니다. 로컬 복구와 제한된 용량 추가에 따라 원래 예약을 유지하고 운영자 근거로 판단하세요.
- 로컬
rebut status --pending으로 원래 요청 ID를 잃었을 때 미해결 요청을 조회할 수 있습니다. 일반rebut status ID는 키 없이 로컬 메타데이터를 조회합니다. - SIGINT/SIGTERM 취소는 가능한 범위에서 진행 중 요청을 unknown으로 기록하고 예약을 유지합니다. 요청이 공급자에 전달됐다면 과금됐을 수 있습니다. 강제 종료·장애 뒤 남은 불확실한 실행의 예약과 슬롯을 자동 해제하지 않습니다.
30분은 클라이언트와 공급자 호출의 대기 설정입니다. 네트워크·MCP 호스트·운영 환경의 종료나 취소에도 결과 전달을 보장하는 것은 아닙니다. 최초 결과를 받지 못했다면 같은 요청 ID로 상태를 확인하세요. 다른 MCP 호스트도 긴 검토를 위해 도구 제한을 1,860초 이상으로 설정해야 하며, 이를 지원하지 않으면 먼저 연결이 종료될 수 있습니다. 검토 본문 재생은 지원하지 않습니다.
자격증명과 운영 CLI
OpenAI API 키, Worker 접속 토큰, Worker 관리자 토큰을 별도 역할로 관리합니다. Keychain·Vaultwarden·env 백엔드는 명시적으로 선택하며 자동 대체하지 않습니다.
- 로컬 OpenAI 키:
rebut set api-key(macOS Keychain 숨김 입력) - env 기본 변수:
REBUT_OPENAI_API_KEY. 공용OPENAI_API_KEY는rebut set api-key-env OPENAI_API_KEY로 명시적으로 선택 - 로컬 예산:
set daily-budget,set monthly-budget,set request-budget - 로컬 동시 실행 상한:
set max-concurrent(1–10). 변경해도 기존 예약·비용·unknown 상태는 해제되지 않음 - 로컬 프로필은 OS 소유자가 관리하며, Worker 프로필은 기존 관리자 인증을 사용
업그레이드 안내
다음 명령으로 0.2.0을 설치하거나 업데이트합니다.
npm install -g rebut-mcp@0.2.0
rebut setup --client codex --replace0.2.0 전용 설정을 쓰기 전에 기존 config.json을 백업하세요. 0.1.0은 새 설정 필드를 거부하므로 Worker 사용자도 다운그레이드 시 이전 설정의 복원이 필요할 수 있습니다. 장부는 별도로 보존하며 백업 설정에 맞춘다는 이유로 삭제하지 마세요.
별도 Codex home을 사용하면 --codex-home PATH를 지정하고, 사용자 지정 REBUT_CONFIG_DIR이 있다면 setup을 실행하는 셸에도 같은 값을 설정하세요. setup --replace 전에 config.toml 전체를 백업하고 결과를 비교하세요. Rebut 등록을 갱신하며 TOML 형태에 따라 파일 전체를 다시 직렬화할 수 있어 주석·서식이 달라질 수 있습니다. 직접 관리하는 Codex 등록의 tool_timeout_sec는 1,860초 이상으로 맞춥니다. MCP 호스트를 완전히 재시작한 뒤 rebut doctor --connect로 확인합니다. 이 명령은 유료 검토를 실행하지 않습니다.
기존 Worker 사용자는 먼저 CLI를 업데이트하고 MCP 등록·호스트 재시작을 완료한 뒤 Worker를 업데이트합니다. CLI 업데이트만으로 운영 Worker의 공급자 제한이 바뀌지 않습니다. Worker 소유자는 저장소 소스와 자신의 비공개 설정을 사용해 별도로 배포해야 합니다. 0.2.0에 새 D1 마이그레이션은 없으며 기존 0001·0002를 사용합니다. 아직 적용하지 않은 마이그레이션이 있다면 설치 가이드에서 먼저 확인하세요.
로컬 모드를 선택하려면 별도로 설정합니다(macOS Keychain 예시).
rebut set mode local
rebut set api-key
rebut setup --client codex --replace상태 조회에도 MCP 호스트와 같은 REBUT_CONFIG_DIR을 사용하세요. 다른 디렉터리의 not_found는 미실행의 근거가 아닙니다.
이후 MCP 호스트를 재시작하고 rebut doctor --connect로 확인하세요. 설치·전환·등록 제거 과정에서 기존 설정·키·요청 장부를 임의로 삭제하거나 초기화하지 마세요.
검증 범위와 제한
타입 검사·CLI/Worker 빌드·자동화 테스트·설치된 npm tarball smoke를 발행 전에 확인합니다. 공급자는 모의 처리하며 자동 검증은 유료 모델을 호출하지 않습니다. CI는 Node.js 24/26과 macOS/Ubuntu 조합을 사용합니다. Windows 동작·ACL은 검증하지 않았습니다. 30분 전체를 기다리는 실환경 검토 완료를 검증한 것은 아닙니다. 로컬 doctor의 성공은 OpenAI 계정의 모델 사용 권한·잔액·실제 검토 품질을 입증하지 않습니다.
자세한 설정은 설치 안내, 설정, 운영·복구를 참고하세요. 발행 담당자는 릴리즈 체크리스트를 따릅니다.
발행 정보
- 소스 커밋:
2b42a6b0831bde6bf7a173f6333954dcadfccf95 - npm: rebut-mcp@0.2.0
- 패키지 무결성:
sha512-O5gIUbu2bOS+OiVeBzMxNpP4pZd0ZVABwDby95e7tBXDTMgxiYmI5nIb6t+623n98XnA5EyBqw0orR1ZOKghjQ== - 패키지 SHA-256:
259a0a663f9c157275f7e984bbea5a8df7e8dd0569d18d0c347eff7da86b9348
병합된 main에서 타입 검사·빌드·테스트 166개·설치된 패키지 smoke를 다시 통과했습니다. Node.js 24/26 × macOS/Ubuntu CI도 통과했습니다. 자동 검증의 실제 OpenAI API 호출은 0회입니다.
이 릴리즈 발행은 기존 클라이언트 업데이트나 개인 Worker 배포를 자동 수행하지 않습니다. 0.1.1은 별도 npm/GitHub 릴리즈 없이 이번 버전에 포함됩니다.
Rebut 0.1.0 — 최초 공개 릴리즈
npm 패키지 rebut-mcp의 최초 정식 버전입니다. 실행 명령은 rebut이며 Node.js 24 이상이 필요합니다. MIT 라이선스로 공개했습니다.
npm 발행일은 2026년 11월 13일입니다(01:03:25 UTC / 10:03:25 KST). 이 문서는 당시 배포된 0.1.0 패키지와 포함 문서를 기준으로 작성한 사후 릴리즈 기록입니다. GitHub 릴리즈 생성일이나 Git 태그를 발행일로 간주하지 않습니다.
주요 기능
- 직접 호스팅한 Cloudflare Worker에 연결하는 CLI와 로컬 stdio MCP 브리지
review와 메타데이터 조회용review_status도구- 명시한 파일·diff·요구사항 수집, 흔한 비밀 패턴 마스킹, SHA-256으로 검토 자료 고정
- 파일·행 근거를 포함한 구조화된 검토 결과와 모델·사용량·예상 비용 반환
- D1의 원자적 예산 예약, 인증 주체별 요청 ID 중복 방지, 불확실한 실행의 예약 유지
- macOS Keychain, Vaultwarden(
bw-get), 환경변수 자격증명 백엔드의 명시적 선택 - Codex MCP 등록과 유료 검토를 수행하지 않는
doctor --connect - CLI 모델·추론 환경설정과 별도 관리자 인증을 사용하는 서버 프로필 관리
- 한국어·영어·중국어 간체·일본어 사용자 문서
모델에는 저장소 복제, 셸·테스트 실행, 파일·PR 수정 권한을 제공하지 않습니다. 코드·리뷰 원문·키는 D1 장부에 저장하지 않습니다.
0.1.0 설치 방식
이 버전은 사용자 소유 Worker와 D1 배포가 필요합니다. 별도 Worker 없이 OpenAI API 키만으로 실행하는 로컬 검토 모드는 0.2.0에서 추가합니다.
npm install -g rebut-mcp@0.1.0
rebut set endpoint https://YOUR_HOST/mcp
rebut set token
rebut setup --client codex
rebut doctor --connectmacOS 예시이며 set token은 접속 토큰을 숨김 입력으로 받아 Keychain에 저장합니다. OpenAI API 키는 Worker에 설정하며, Worker 접속 토큰·관리자 토큰과 구분합니다. 공개 패키지는 개인 Worker나 OpenAI 크레딧 접근 권한을 제공하지 않습니다.
알려진 한계와 후속 변경
- 초기 Worker 소스의 공급자 대기 제한은 45초이며, npm 0.1.0 클라이언트의 도구 호출 제한은 65초입니다. Worker는 npm 패키지와 별도로 배포하므로 실제 서버의 제한은 배포 소스에 따릅니다. 긴 검토를 위한 30분 공급자 제한과 외부 계층의 여유 시간은 0.2.0에 포함됩니다.
review_status는 검토 본문을 재생하지 않습니다. 최초 성공 응답을 보관해야 합니다.- timeout/unknown은 실패나 미과금을 확정하지 않습니다. 같은 요청 ID로 상태를 확인하며, 자동 재실행·예약 해제를 하지 않습니다.
- 원장은 해당 Worker 배포의 Rebut 사용량을 관리하며 OpenAI 계정 전체의 사용량·잔액을 합산하지 않습니다. 예상 비용은 실제 청구서가 아닙니다.
- 흔한 비밀 패턴의 마스킹은 모든 비밀 제거를 보장하지 않습니다. 전송 자료를 확인해야 합니다.
0.1.1은 중간 개발 버전이며 이 기록 작성 시 npm에 발행되지 않았습니다. 후속 정식 릴리즈는 0.2.0입니다.
소급 릴리즈와 소스 확인
이 GitHub 릴리즈와 v0.1.0 태그는 최초 npm 발행 이후 소급 생성했습니다. 과거 소스 81929754dc3aedd93c863b4c5a1a5ed69dda9729에서 재빌드한 패키지와 실제 npm 0.1.0 배포물의 38개 파일이 바이트 단위로 모두 일치했습니다. 태그는 이 재현 소스를 가리킵니다. npm에 gitHead가 없어 최초 발행 당시의 Git 커밋 자체를 확정한 것은 아닙니다.
- npm: rebut-mcp@0.1.0
- 배포물 무결성:
sha512-VkLHG/d9mttoivPWHg1IsFtRemM7EuXypQPu/nvYiNndXrdA8j6A7u2EK0LkJJ5BozQ21T5Cm9OrGTZqfA0Xaw==