본문으로 건너뛰기

Codex에서 Whisperr 사용하기

이 페이지는 OpenAI의 터미널 앱인 Codex에 Whisperr를 추가하는 방법을 설명합니다. 명령어 두 개를 실행한 다음, 브라우저에서 Whisperr에 로그인하고 Allow를 클릭하면 됩니다. 복사할 키는 없습니다.

연결한 뒤 무엇을 할 수 있는지는 MCP 연동 개요를 참고하세요. 웹 버전 ChatGPT를 쓰시나요? ChatGPT를 확인하세요.

시작하기 전에​

  • 설치하고 로그인한 Codex. 설정이 필요하면 OpenAI의 Codex 문서를 참고하세요.
  • Whisperr 계정 — 웹 앱에 로그인하세요. 미팅 봇을 보내려면 활성 구독이 필요하고, 저장된 대화를 읽는 데는 필요하지 않습니다.

Whisperr 추가하는 방법​

1. Whisperr 서버 추가하기​

터미널에서 다음을 실행합니다:

codex mcp add whisperr --url https://prod-whisperr-mcp.fly.dev/mcp

whisperr는 Codex가 이 서버를 부르는 이름입니다. 주소는 Whisperr 웹 앱의 MCP 연동에 표시되는 것과 같습니다.

2. Whisperr에 로그인하기​

다음을 실행합니다:

codex mcp login whisperr

브라우저에 Whisperr가 열립니다. 로그인하지 않았다면 먼저 로그인하세요(Whisperr에 사용하는 Google, Apple 또는 이메일 중 편한 방법). 그러면 로그인한 계정과 Codex가 할 수 있는 일이 정확히 나열된 Connect Codex to Whisperr 화면이 나타납니다.

  • Zoom, Teams, Google Meet 통화에 Whisperr 미팅 봇 보내기
  • 미팅 봇 상태 확인 및 멈추기
  • 저장된 대화와 전사 읽기

Allow를 클릭하세요. (Cancel을 누르면 아무것도 연결되지 않습니다. 다른 계정이라면 Not you? Use a different account를 클릭하세요.)

Codex가 할 수 있는 일이 나열되어 있고 Cancel과 Allow 버튼이 있는 Whisperr의 Connect Codex to Whisperr 페이지

페이지에는 127.0.0.1로 시작하는 주소로 돌아간다고 표시됩니다. 이는 로그인을 마무리하기 위해 여러분의 컴퓨터에서 대기 중인 Codex입니다. 다른 곳으로는 아무것도 전송되지 않습니다.

주의

codex mcp login whisperr를 방금 직접 실행했을 때만 Allow를 클릭하세요. 예상하지 못한 페이지에서 Codex를 Whisperr에 연결하라고 요청하면 Cancel을 클릭하세요.

3. Codex 시작하기​

터미널로 돌아와 로그인이 끝나면 다음을 실행합니다:

codex

Whisperr가 연결되었는지 확인하려면 언제든 codex mcp list를 실행하세요.

4. Codex에게 요청하기​

평소 말하듯이 요청해 보세요:

요청결과
"Whisperr에서 최근 대화 제목 몇 개 보여 줘"저장된 대화가 링크와 함께 표시됩니다
"가장 최근 Whisperr 대화를 읽고 요약해 줘"Codex가 전사와 번역을 읽은 뒤 요약합니다
"회의 링크에 영어와 일본어로 Whisperr 봇을 보내 줘"봇이 입장하고 Codex가 실시간 전사 링크를 알려 줍니다. 회의에 로비가 있으면 "Whisperr Bot"의 입장을 허용하세요
"봇이 회의에 들어왔어?" / "봇 멈춰 줘"Codex가 봇 상태를 확인하거나 봇을 나가게 합니다

Codex는 사용하는 Whisperr 도구를 하나씩(예: whisperr.list_conversations) 표시한 다음, 찾은 내용을 바탕으로 답합니다:

Whisperr list_conversations 도구를 호출한 뒤 최근 Whisperr 대화 다섯 개를 나열하는 Codex
팁

요금제에서는 한 번에 봇 하나만 실행할 수 있습니다. 한도에 도달했다는 메시지가 나오면 Codex에게 실행 중인 봇을 먼저 멈추라고 하세요.

Whisperr 연결 해제​

  • Whisperr에서: 웹 앱의 MCP 연동을 엽니다. Connected apps 아래에 Codex와 연결된 시각이 표시됩니다. Disconnect를 클릭하세요. Codex는 로그아웃되며 다시 로그인해야 작동합니다.
  • Codex에서: codex mcp logout whisperr를 실행하면 로그아웃되고, codex mcp remove whisperr를 실행하면 Whisperr가 완전히 삭제됩니다.

나중에 다시 연결하려면: logout 뒤에는 codex mcp login whisperr를 실행하세요. remove 뒤에는 먼저 1단계의 명령어로 Whisperr를 다시 추가한 다음 로그인하세요.

문제 해결​

증상해결 방법
codex: command not foundCodex가 설치되어 있지 않거나 경로에 없습니다. OpenAI의 Codex 문서를 참고하세요.
codex mcp add가 whisperr라는 서버가 이미 있다고 함codex mcp remove whisperr를 실행한 다음 다시 추가하세요.
브라우저에 Whisperr가 열리지 않음codex mcp login whisperr가 터미널에 출력한 주소를 브라우저에 복사해 붙여넣으세요.
Whisperr 페이지에 로그인 요청이 유효하지 않거나 만료되었다고 표시됨요청은 짧은 시간 동안만 유효합니다. codex mcp login whisperr를 다시 실행하세요.
Whisperr에 계정의 API 키 한도에 도달했다고 표시됨연결된 앱마다 키를 하나씩 사용합니다. MCP 연동(또는 Developer Console)을 열어 쓰지 않는 키나 앱을 삭제한 뒤 다시 시도하세요.
Codex가 Whisperr를 사용할 수 없거나 로그인하라고 함codex mcp login whisperr를 다시 실행하세요. 웹 앱에서 Disconnect를 클릭했다면 Codex는 다시 로그인해야 합니다.
"subscription_required"봇을 보내려면 활성 구독이 필요합니다. 대화 읽기는 구독 없이도 됩니다.
"concurrency_limit"이미 봇 하나가 회의에 참가 중입니다. 먼저 봇을 멈추세요.
봇이 입장하지 않음회의 링크를 확인하고 로비가 있는지 살펴보세요. 호스트가 "Whisperr Bot"의 입장을 허용해야 합니다.
"No saved conversations"Codex는 클라우드에 저장된 대화만 볼 수 있습니다. 먼저 봇을 실행하거나 클라우드에 저장을 켜세요.

더 자세한 내용은 MCP 연동 개요를 참고하세요.

관련 항목​