ZeroHrs MCP 서버

이 공개 로컬 MCP 서버는 로그인한 사용자의 ZeroHrs 데이터를 Codex에 노출합니다. ZeroHrs API와 해당 API의 사용자 권한 검사를 사용합니다.

공유 가능하고 에이전트 중심의 설치 가이드는 INSTALL.md를 참조하세요.

Codex에 설치

Node.js 20 이상이 필요합니다. 교체하기 전에 기존 zerohrs 항목을 확인한 다음, 공개 태그 릴리스를 설치하세요:

codex mcp add zerohrs -- npx -y github:ZeroHrs-Org/zerohrs-mcp#v0.2.0

~/.codex/config.toml에서 이 서버에 대해 default_tools_approval_mode = "writes"를 설정하고, Codex를 다시 시작한 다음, 인자 없이 login 도구를 호출하세요.

Related MCP server: vibelogin-mcp

도구

읽기 전용 도구:

• search_zero

• list_meetings

• list_transcripts

• search_transcripts

• get_transcript

• list_tasks

• get_task

• get_meeting_prep

Codex가 승인을 요청하는 쓰기 도구:

• login

• disconnect

• create_task

• update_task

• add_meeting_prep_note

이 서버에는 의도적으로 이메일이나 메시지를 보내거나, 회의 봇을 예약하거나, 대화록을 공유하거나, 데이터를 삭제하거나, 외부 서비스에서 작업을 수행하는 도구가 없습니다.

get_transcript는 기본적으로 대화록 요약을 반환합니다. 연결된 작업이나 쿼리와 일치하는 화자 블록을 포함할 수 있지만, 기본적으로 모든 대화록 턴을 로드하지는 않습니다.

로그인 및 연결 해제

서버는 STDIO를 통해 로컬에서 실행됩니다. 시작 시 세션 토큰이 필요하지 않습니다.

login을 인자 없이 호출하세요. 그러면 다음 주소에서 클릭할 수 있고 수명이 짧은 URL을 반환합니다:

• http://localhost:3100

URL을 열고 Google로 로그인을 선택하세요. 공식 Google 로그인은 Codex 내장 브라우저가 아니라 시스템 브라우저에서 열립니다. 로컬 MCP는 Google 자격 증명을 ZeroHrs와 교환하고, 반환된 세션을 /auth/profile을 통해 검증합니다. Google 자격 증명이나 ZeroHrs 세션 토큰은 Codex 채팅을 통과하지 않습니다. URL은 10분 후 만료되며, 성공, 만료 또는 연결 해제 이후에는 수신을 중지합니다.

브라우저 로그인에는 공개 ZeroHrs 프로덕션 Google 클라이언트 ID와 함께 제공됩니다. 관리자는 ZEROHRS_GOOGLE_WEB_CLIENT_ID 또는 GOOGLE_WEB_CLIENT_ID로 이를 재정의할 수 있습니다. 저장소 개발에서는 backend/control-plane/.env의 GOOGLE_WEB_CLIENT_ID를 읽을 수도 있습니다. Google 웹 클라이언트는 http://localhost:3100을 JavaScript 출처로 승인해야 합니다. 대체 localhost 출처도 승인된 경우에만 ZEROHRS_MCP_LOGIN_PORT를 설정하세요.

API 대상을 도구 호출에서 허용하지 않습니다. 기본값은 https://control-plane.zerohrs.com이며, Codex를 시작하기 전에 관리자가 ZEROHRS_API_BASE_URL을 통해 설정할 수 있습니다(예: 로컬 또는 스테이징 컨트롤 플레인을 사용하는 경우).

브라우저 로그인 후에는 검증된 ZeroHrs 토큰만 0600 권한으로 ~/.zerohrs/codex-mcp-session.json에 저장됩니다. 저장된 세션은 Codex를 다시 시작하지 않아도 즉시 활성화됩니다.

disconnect를 호출하면 대기 중인 브라우저 로그인을 취소하고 해당 로컬 자격 증명 파일을 제거합니다. /auth/logout을 호출하지 않으며, 토큰을 해지하거나 다른 ZeroHrs 앱 세션을 로그아웃하지 않습니다. 다시 호출해도 안전합니다.

세션 토큰을 .codex/config.toml, 커밋된 .env 파일, 채팅 또는 셸 기록에 추가하지 마세요. 저장된 토큰은 관리자가 구성한 ZeroHrs API URL에 Authorization: Bearer <token>으로만 전송됩니다. 컨트롤 플레인은 회의, 대화록, 작업, 연락처, 준비 노트 및 브리핑에 대한 사용자 액세스 검사를 계속 담당합니다.

이 MCP 서버를 처음 추가하거나 업데이트한 후 Codex를 재시작하고, /mcp를 사용하여 zerohrs 서버와 도구를 사용할 수 있는지 확인하세요.

릴리스 내용

이 저장소에는 독립형 공개 배포판이 포함되어 있습니다. 실행 번들은 dist/index.mjs이며, 런타임 의존성은 일반 npm 패키지입니다.