メインコンテンツまでスキップ

CodexでWhisperrを使う

このページでは、OpenAIのターミナルアプリCodexにWhisperrを追加する手順を説明します。コマンドを2つ実行し、ブラウザで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、メールのいずれかです）。するとConnect Codex to Whisperrが表示され、サインインしているアカウントと、Codexにできることが正確に示されます。

  • 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があなた自身のパソコンで待ち受けているもので、ほかの場所には何も送信されません。

注意

Allowをクリックするのは、自分でcodex mcp login whisperrを実行した直後だけにしてください。思いがけないページから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の直近の会話を5件一覧にしているCodex
ヒント

ご利用のプランでは同時に動かせるボットは1つです。上限に達したと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キーの上限に達したと表示される接続したアプリごとに1つキーを使います。MCP連携（またはDeveloper Console）を開き、使っていないキーやアプリを削除してから、もう一度お試しください。
CodexがWhisperrを使えない、またはサインインが必要だと言うもう一度codex mcp login whisperrを実行してください。ウェブアプリでDisconnectをクリックした場合は、Codexで再度サインインが必要です。
"subscription_required"ボットの送信には有効なサブスクリプションが必要です。会話の閲覧には不要です。
"concurrency_limit"あなたのボットがまだ会議に参加中です。先に止めてください。
ボットが入室しないミーティングリンクを確認し、待機室がないかも見てください。ホストが「Whisperr Bot」を許可する必要があります。
"No saved conversations"Codexが見られるのは、クラウドに保存された会話だけです。先にボットを実行するか、クラウドに保存をオンにしてください。

詳しくはMCP連携の概要をご覧ください。

関連情報​