Vocatimの録音をMacのAIアプリで使う

まず、Vocatimで

Macで設定 → データとデバイス → このMacのAIアプリを開き、オンにします。AIアプリが見られる内容を説明する画面を読んでから、オンにするをクリックします。その後、使っているAIアプリの手順に進みます。

Claude Desktop

1. Claude Desktopにインストールをクリックし、Vocatim.mcpbを好きな場所（たとえば「ダウンロード」フォルダ）に保存します。ファイルが保存されると、VocatimがVocatimのキーをコピーします。
2. Vocatim.mcpbを開きます。Claude DesktopにVocatimの拡張機能が表示され、インストールするかどうかを尋ねられます。
3. Claude DesktopがVocatimのキーを求めたら、貼り付けます。vocatim-mcpプログラムはそのままにしておきます。
4. 新しいチャットで、たとえば「Vocatimの最新の録音で、何が決まりましたか？」と質問します。ClaudeからVocatimツールの使用許可を求められることがあります。

設定ファイルを自分で編集したい場合は、Claude Desktop用の設定をコピーをクリックします。Claude Desktopで、macOSのメニューバーにあるClaudeメニュー（Claudeのウインドウ内の設定ではありません）を開き、Settings… → Developer → Edit Configを選びます。ファイルにまだ"mcpServers"がない場合は、ファイルの内容を下の例全体で置き換えます。すでにサーバが記載されている場合は、"vocatim"の項目だけを"mcpServers"の中に貼り付け、直前の項目との間にカンマを入れます。ファイルを保存し、Claude Desktopを完全に終了してから、もう一度開きます。

{
  "mcpServers": {
    "vocatim": { … paste from Vocatim … }
  }
}

ChatGPTとCodex

1. ChatGPTとCodex用の設定をコピーをクリックします。
2. テキストエディタで~/.codex/config.tomlファイルを開きます。まだない場合は作成します。~/.codexはホームフォルダ内の隠しフォルダです。Finderで移動 → フォルダへ移動…を選び、~/.codexと入力します。
3. ファイルに[mcp_servers.vocatim]セクションがない場合は、末尾の新しい行に設定を貼り付けます。以前の設定ですでにこのセクションがある場合は、そのセクション全体を新しいセクションで置き換えます。ファイル内にこのセクションが2つあってはいけません。
4. ファイルを保存し、ChatGPTまたはCodexを再起動します。
5. 新しいチャットで、たとえば「Vocatimの最新の録音で、何が決まりましたか？」と質問します。ChatGPTでは、通常のチャットではなく、Codexの会話でVocatimを使ってください。

[mcp_servers.vocatim]
command = "/Applications/Vocatim.app/Contents/MacOS/vocatim-mcp"
args = ["--port", "…", "--token", "…"]

codex mcp listの出力では、Args列にVocatimのキーが表示されます。このキーでできるのは、このMac上のアプリがVocatimを読み取ることだけで、それもVocatimが開いている間に限られます。この出力は共有しないでください。共有してしまった場合は、Vocatimで「キーをリセット」を使ってください。

VS Code、Cursor、LM Studio

1. VS Codeにインストール、Cursorに追加、またはLM Studioに追加をクリックします。VocatimがVocatimの設定を渡して、そのアプリを開きます。
2. そのアプリで、Vocatimを追加することを確定します。
3. VS Codeの場合は、VocatimがVocatimのキーをコピーします。VS CodeがVocatimのキーを求めたら、貼り付けます。CursorとLM Studioは設定と一緒にキーを受け取り、それぞれの設定に保存します。
4. そのアプリのAIチャットで、たとえば「Vocatimの最新の録音で、何が決まりましたか？」と質問します。

ほかのアプリ：Cursor、LM Studio、JetBrains AI Assistant、Junie

1. ほかのアプリ用の設定をコピーをクリックします。
2. アプリのMCP設定を開きます。Cursorでは~/.cursor/mcp.jsonファイル、LM Studioでは同アプリのmcp.json、JetBrains AI AssistantではSettings → Tools → AI Assistant → MCPとAdd、Junieでは~/.junie/mcp/mcp.jsonファイルです。
3. まだ"mcpServers"がない場合は、設定全体を貼り付けます。すでにサーバが記載されている場合は、"vocatim"の項目だけを"mcpServers"の中に追加するか、古い"vocatim"の項目をそれで置き換えます。同じ項目が2つあってはいけません。
4. 保存してから、アプリを再起動します。

Zed

1. Zed用の設定をコピーをクリックします。
2. Zedでzed: open settings fileを実行します。
3. "context_servers"の部分を、そのファイルのいちばん外側の波かっこの中に入れます。"context_servers"がすでにある場合は、その中に"vocatim"の項目だけを追加するか、古い"vocatim"の項目をそれで置き換えます。同じ項目が2つあってはいけません。
4. ファイルを保存してから、Zedを再起動します。

ターミナルでVocatimを使う（コマンドライン）

このMacのターミナルでも、AIアプリが使うのと同じ4つの読み取り専用ツール（一覧、検索、文字起こし、要約）で録音を読むことができます。コマンドラインはAIアプリと同じスイッチと同じVocatimのキーを使い、Vocatimが開いていてスイッチがオンのときだけ動作します。

1. このコマンドをコピーしてターミナルのウインドウにペーストします。ただし、returnキーはまだ押さないでください：

   printf '\n%s\n' "$(pbpaste | grep -m 1 '^alias vocatim=')" >> ~/.zshrc

2. VocatimでCLIコマンドをコピーをクリックします。Vocatimは1行をコピーします。macOSのデフォルトのシェルであるzsh用の、vocatimという名前のエイリアスです。
3. ターミナルに戻ってreturnキーを押します。このコマンドは、コピーした行を~/.zshrcの末尾に追加します。これは、ターミナルのウインドウを開くたびにzshが読み込むファイルです。追加するのはalias vocatim=で始まる行だけなので、クリップボードのほかの内容がファイルに入ることはありません。
4. ターミナルで新しいウインドウを開き、vocatim listと入力します。エイリアスは、手順3の後に開いたウインドウで使えます。

4つのコマンド：

• vocatim listは、新しい順に20件の録音を1行に1件ずつ表示します（ID、日時、長さ、タイトル）。vocatim list --limit 50では最大50件を表示します。
• vocatim search 予算は、タイトル、文字起こし、要約、メモ、または翻訳に「予算」を含む録音を探します。スペースを含む検索語は引用符で囲みます：vocatim search "weekly review"。表示される結果は最大10件で、--limit 20を付けると最大20件です。
• vocatim transcript <id>は、1件の録音の文字起こし全体を表示します。IDはvocatim listとvocatim searchの結果の最初の列にあります。
• vocatim summary <id>は、その録音の要約を表示します。

どのコマンドにも--jsonを付けると、自分のスクリプトで使えるJSONで出力されます。vocatim helpはコマンドの一覧を表示します。

キーについて：~/.zshrcのvocatimの行には、Vocatimのキーが含まれています。その行をターミナルに直接ペーストすると、キーはターミナルの履歴にも残ります。このキーでできるのは、このMac上のアプリがVocatimを読み取ることだけで、それもVocatimが開いている間に限られます。この行やファイルは共有しないでください。共有してしまった場合は、Vocatimで「キーをリセット」を使ってください。

「キーをリセット」した後や、Vocatimに「設定が変わりました。AIアプリをもう一度設定してください。」と表示されたときは、古い行は使えなくなります。手順1〜4をもう一度行ってください。有効なのは~/.zshrcにある最も新しいvocatimの行です。古い行は削除してかまいません。

コマンドを実行すると、Vocatimの「設定」のこのMacのAIアプリに、AIアプリの名前と同じようにvocatim-cliと表示されます。

コマンドラインが通信するのはこのMac上のVocatimだけで、結果はターミナルのウインドウに表示されます。その結果をオンラインのAIサービスなどほかの場所に渡すと、結果はそこに届きます。

削除するには、~/.zshrcからvocatimの行をすべて削除します。手順1〜4を繰り返した場合は、行が複数あることがあります。Vocatimでスイッチをオフにするか「キーをリセット」しても、使えなくなります。

うまくいかない場合：Vocatimのコマンドラインのメッセージはvocatim-mcp:で始まります。

• vocatim-mcp: Vocatim is not open on this Mac, or AI app access is turned off in Vocatim Settings.（このMacでVocatimが開いていないか、Vocatimの「設定」でAIアプリによるアクセスがオフになっています）と表示される場合は、Vocatimを開いてスイッチを確認します。「キーをリセット」した後や「設定が変わりました」と表示された後は、手順1〜4をもう一度行います。その上に行がある場合は、技術的な理由が表示されています（例：vocatim-mcp: connect: Connection refused）。
• zsh: command not found: vocatimと表示される場合は、ターミナルで新しいウインドウを開きます。それでも同じ表示になる場合は、~/.zshrcにalias vocatim=で始まる行があるかを確認し、なければ手順1〜4をもう一度行います。echo $SHELLで/bin/zshと表示されるかも確認してください。
• vocatim-mcpへのパスとともにzsh: no such file or directoryと表示される場合は、その行が指している場所にVocatimがもうありません（アプリを移動した場合など）。手順1〜4をもう一度行います。
• vocatim-mcp: Too many requests, try again in a moment.（リクエストが多すぎます。しばらくしてからやり直してください）と表示される場合は、少し待ってからコマンドをもう一度実行します。
• コマンドを付けずにvocatimを実行すると（vocatimやvocatim --jsonなど）、何も表示されずに待機したままになります。control＋Cを押してから、vocatim listなどのコマンドを入力してください。

スクリプトで使う場合：データは、コマンドが成功したときにだけ、すべてまとめて標準出力に出力されます。メッセージは標準エラー出力に出力されます。--jsonを付けると、Vocatimからの応答は1つにつき1行のJSONになるため、長い文字起こしではtranscriptがページごとに1行を出力します。出力は1つのJSONドキュメントとしてではなく、1行ずつ読み取ってください。終了コード：0 完了、1 その他のエラー、2 コマンドまたはオプションの誤り、3 Vocatimが開いていないかアクセスがオフ、4 リクエストが多すぎる。

Macの外に出るもの

AIアプリによる録音へのアクセスは、デフォルトでオフです。文字起こしをこのMac上のAIアプリと共有すると決めた場合にだけ、Vocatimの「設定」で自分でオンにします。

Vocatim自体は何も送信しません。AIアプリがオンラインのモデルを使う場合（Claude Desktop、ChatGPT、Codexは通常そうです）、Vocatimから読み取った内容は、あなたのアカウントでその会社（AnthropicまたはOpenAI）に送信されます。チャットに貼り付けた場合と同じです。

停止するには

Vocatimでスイッチをオフにします。キーをリセットすると、これまでにコピーしたキーと貼り付けた設定はすべて使えなくなります。再び接続するには、AIアプリをもう一度設定します。Claude Desktopの拡張機能の場合は、Vocatimでもう一度Claude Desktopにインストールをクリックし、ファイルを保存して開きます。ファイルが保存されると、Vocatimが新しいキーをコピーします。そのキーは、Claude Desktopに求められたときに貼り付けるか、Claude DesktopにあるVocatim拡張機能のVocatimのキー欄に貼り付けます。CursorとLM Studioの場合は、もう一度Cursorに追加またはLM Studioに追加をクリックします。貼り付けた設定の場合は、設定をもう一度コピーし、古い項目またはセクションに上書きして貼り付けます。その後、AIアプリを完全に終了し（ウインドウを閉じるだけでは不十分です）、もう一度開きます。それまでAIアプリは古いキーを使い続けます。AIアプリからVocatimを削除することもできます。削除するのは、Claude DesktopのVocatim拡張機能、Claude Desktopの設定ファイル・ほかのアプリのMCP設定・Zedの設定ファイルにある"vocatim"の項目、または~/.codex/config.tomlの[mcp_servers.vocatim]セクションです。

うまくいかない場合

• 「このMacでVocatimが開いていないか、Vocatimの『設定』でAIアプリによるアクセスがオフになっています。」と表示される場合は、Vocatimを開いてスイッチを確認します。「キーをリセット」した後は、AIアプリをもう一度設定してから完全に終了し（ウインドウを閉じるだけでは不十分です）、もう一度開きます。
• Vocatimに「設定が変わりました。AIアプリをもう一度設定してください。」と表示される場合は、上記の手順で、古い項目やセクションに上書きして各AIアプリを設定し直し、再起動します。
• Vocatimに「アプリが開きませんでした。このMacにインストールされていますか？」と表示される場合は、そのアプリをこのMacにインストールします。CursorとLM Studioでは、ほかのアプリ用の設定をコピーを使うこともできます。
• 設定を2回貼り付けた後に、ChatGPTやCodexが動かなくなったり、config.tomlのエラーが報告されたりする場合は、ファイルに[mcp_servers.vocatim]セクションが2つあります。最新のものだけを残します。
• CodexでVocatimのツールがないと表示される場合は、フォルダがこのMac上にあるプロジェクトで新しい会話を始めます（ほかのコンピュータから同期されたプロジェクトは、このMacにフォルダがない場合があります）。
• Vocatimより先にAIアプリを開いた場合は、Vocatimを開いた状態でAIアプリを再起動します。
• 録音が見つからない場合：ゴミ箱の録音とサンプル録音は表示されません。また、新しい録音は、文字起こしが完了するか停止されるまで表示されません。文字起こしが最後まで終わっていない録音は一覧に表示されますが、その文字起こしと要約は、最後まで文字起こしされるまで利用できません。