MacWhisperとほかのAIをつなぐ手順：AI Servicesの設定（OpenAI、Anthropic、Gemini、Ollama、LM Studioなど）、クラウド文字起こし、Zapier・Make・n8n・Webhook・Obsidian、コマンドラインとAIエージェントまで

この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。

手順は「公式の手順を順に並べたもの」です。設定の例は、「公式の例の写し」か、「公式の記載に合わせて、この記事で組んだ例（動作は確かめていません）」のどちらかを、そのつど書きました。APIキーはすべてプレースホルダ（<YOUR_..._API_KEY>）で、実際の値は載せていません。画面の表記は版によって変わるので、手元の画面と照らして読んでください。

先に結論

• 連携は5つの口に整理できる。 ①AI Services（文字起こし後の文章をAIにかける）、②クラウド文字起こし（音声を外部に送る）、③Integrations（できた文字を外部に自動で送る）、④ディクテーションのAIプロンプト、⑤コマンドライン mw。
• MCPや、コーディング用AIに登録するプラグインは、読んだ公式ページに記述がなかった。 AIのエージェントとの連携で公式が書いているのは、mw を使う方法です（本記事の最後の節）。
• 行き先は、設定で決まる。 クラウドのAIには文字起こしの文章とプロンプトが、クラウド文字起こしには音声が、Integrationsには title と transcript が渡ります。ローカルのAI（Apple、Ollama、LM Studio）は、公式によると文章をMacの中で処理します。

前提：用語をそろえる

• APIキー：外部のAIサービスを自分のアカウントで使うための秘密の文字列。公式は、人に渡さず、画面の写真に写さないように、と書いています。
• モデルID：AIのモデルを指す名前。公式は、大文字小文字が区別され、消費者向けのアプリでの呼び名と違うことがある、と書いています。
• ベースURL：AIのサーバーの入口になるアドレス。
• OpenAI互換：OpenAIの「chat completions」と同じ形のリクエストを受け付けるサーバー。
• Webhook：決まったURLにデータを自動で送る仕組み。
• POST／PUT：データを送るHTTPのやり方の名前。
• キーチェーン：macOSの、パスワードなどを保管する仕組み。
• CLI（コマンドライン）／ターミナル：文字で命令する画面。
• MCP：AIのツールと外部のツールをつなぐ共通の規格。本記事の範囲では、公式に記述なし。

つなぎ方の一覧

手順1：AI Servicesで提供元を追加する（共通の流れ）

公式ヘルプ「Setting up AI providers in MacWhisper」の流れです。

1. MacWhisperを開き、Settings から AI Services を選びます。
2. Most Popular または All Services の一覧から提供元を選びます。または Add Service ボタンを使います。
3. 提供元ごとの項目を入力し、Add Service または Save で終えます。
4. 最初に追加したサービスは、自動で選ばれます。同じ提供元の設定を複数持つこともできます。
5. 使うとき：文字起こしを開き、AIの機能（要約、プロンプト、チャット）を選び、提供元のピッカーでサービスを選びます。その選択は、変えるまで以降のAIの依頼に使われます。サイドバーのAIのタブは、ショートカット ⌘2 です。
6. 編集、複製、削除：Settings > AI Services で、保存したサービスを編集、複製、削除できます。複製は、同じ提供元でモデルだけ違う設定を作るのに使える、とあります。

共通の注意（ヘルプの記載） - AIの提供元は、文字起こしのモデルとは別の設定です。クラウド文字起こしは、モデルの選択で設定します。 - キーは、余計な空白や引用符をつけず、全部をコピーします。 - 提供元の料金は、MacWhisperの購入や購読とは別に請求されます。ChatGPT、Claude、Geminiの消費者向けの購読には、APIの利用が含まれないことがあります。 - 長い文字起こしは、提供元の文脈の長さやリクエストの上限を超えることがあります。 - 「Test」ボタンについての記載は、このページには見つかりませんでした。ローカルの提供元は、モデルの一覧を更新して、選んだモデルが使えるか確かめる、という案内です。 - キーの保存場所と保護の方法は、このページには書かれていません（Integrationsの認証情報はキーチェーン、と別のページにあります）。

手順2：提供元ごとの設定

クラウド型（APIキー）

ローカル型（キー不要）

• 公式は、ローカルの提供元が、モデルのダウンロードや更新のためにネットワークにつながることはある、と書いています。
• 公式は、認証のないローカルのAIサーバーを、公開のインターネットに出さないように、と書いています。

入力例：この記事で組んだ例（動作は確かめていません）

画面の項目名は公式のヘルプの記載に合わせ、値はプレースホルダにしました。

手順3：AIの組み合わせ方（場面別）

「どの画面で、何を設定し、何が相手に渡り、どう外すか」を、場面ごとに並べます。書かれていない部分は、そう書きました。

組み合わせA：MacWhisper × Anthropic（Claude）／OpenAI／Gemini／xAI

• やること：手順1と2のとおり、AI Servicesに提供元を追加します。
• 渡るもの：文字起こしの文章と、自分のプロンプト。公式は、機密、個人、医療、法律、仕事の資料を送る前に、その提供元のプライバシーや規則の条件に合うか確認するよう書いています。
• 権限：提供元の側でAPIキーを作ります。キーの権限の細かい設定は、MacWhisperのヘルプには書かれていません。
• 外し方：MacWhisper側は、Settings > AI Services で削除します。提供元の側でキーを無効にする手順は、MacWhisperのヘルプには見つかりませんでした（各社の画面で確認）。
• うまくいかないとき（ヘルプの注意から）：モデルIDの大文字小文字や、古いIDになっていないか。キーに空白や引用符が入っていないか。長い文字起こしが上限を超えていないか。提供元の請求（APIの利用の支払い）が有効か。

組み合わせB：MacWhisper × Ollama（ローカル、キー不要）

• やること：Ollamaを入れてモデルをダウンロードし、Ollamaを動かしておきます。AI ServicesにOllamaを追加し、モデルの一覧を更新して選びます。
• 渡るもの：Macの中のOllamaに、文章とプロンプトが渡ります。公式の説明では、AIの応答にインターネットは要りません。
• 外し方：Settings > AI Services で削除します。
• 確認点：Ollamaが動いているか。ベースURLが http://localhost:11434 になっているか。モデルがダウンロード済みか。

組み合わせC：MacWhisper × LM Studio（ローカル）

• やること：LM Studioでモデルを読み込み、ローカルサーバーを開始します。AI ServicesにLM Studioを追加し、モデルの一覧を更新して、読み込んだモデルを選びます。
• 確認点：サーバーを開始しているか。ベースURLが http://localhost:1234/v1 か。

組み合わせD：MacWhisper × 自分のOpenAI互換サーバー（Custom）

• やること：AI Servicesで Custom を選びます。名前、ベースURL（多くは /v1）、正確なモデルIDを入れます。キーは、サーバーが求めるときだけ入れます。
• 条件：サーバーがOpenAI式のchat completionsに対応していること。チャットの画面があるだけのサイトは使えない、と03に書きました。
• 渡るもの：文章とプロンプトが、そのサーバーに渡ります。そのサーバーでの扱いは、サーバーの運営次第です。

組み合わせE：音声を外部の文字起こしに渡す（クラウド文字起こし）× 文字をAIにかける

2つの段階を別々に選びます。

1. 文字起こしの段階：公式ヘルプ「How to use the Cloud Transcription feature」（2025年7月15日更新と表示）。
2. MacWhisperの設定を開き、クラウド文字起こしのページに進みます。
3. 使いたい提供元ごとに、APIキーを追加します。キー欄の場所の細かい名前は、そのページには書かれていません。
4. 必要なら、ほかの提供元の設定を変えます。
5. ホーム画面の右上のモデルの選択から、クラウドの提供元を選びます。
6. AIの段階：手順1のとおり、AI Servicesで提供元を選びます。

• 渡るもの：音声ファイル（クラウド文字起こしの提供元へ）。このページにはプライバシーの記述はありません。
• 外し方：キーの削除の手順と、ローカルのモデルへ戻す手順は、そのページには書かれていません（記載が見つかりません）。
• データの扱い・料金：そのページには、料金、保存と削除、処理される国は書かれていません。提供元の規約で確認します。

組み合わせF：MacWhisper × Zapier／Make／n8n／Custom Webhook（外部に自動で送る）

公式ヘルプ「Integrating MacWhisper with other services」の内容です。

共通 - 場所：Settings → Integrations（ページの途中で「Preferences → Integrations」とも書かれています）。 - バージョン13.6以降。Proが必要です。Proがないと、アップグレードの案内が出て、設定が使えません。 - 認証情報（WebhookのURL、APIキー、Obsidianのトークン）は、macOSのキーチェーンに保存される、と書かれています。 - 画面の上の Automatically send after finished transcription：オンだと、文字起こしが終わるたびに、正しく設定されたすべての連携先に送ります。オフなら、自動では何も送りません。後からオンにもできます。 - Test ボタン：必須の項目を入れると出ます。ダミーのデータを送り、結果を横のラベル（Success、またはサービスが返したエラー、たとえば「Not found」）に出します。ラベルをクリックすると消えて、再テストできます。 - WebhookのJSONの項目：title（題名）と transcript（文字起こしの全文）。

送られるJSONの形：この記事で組んだ例（動作は確かめていません）。項目名は公式の記載どおりで、値は仮です。

{
  "title": "<文字起こしの題名>",
  "transcript": "<文字起こしの全文>"
}

• 渡るもの：題名と全文。話者の分け、時刻などを含むかは、そのページには書かれていません。
• 向こう側：その先（Notionなど、ZapierやMakeやn8nから先）は、それぞれの会社のサービスの設定次第です。Notionは、このヘルプでは内蔵の連携ではなく、自動化ツール（ZapierやMake、独自のWebhook）経由の行き先の例として触れられています。
• 外し方：連携ごとの削除の手順は、そのページには書かれていませんでした。自動送信は、「Automatically send after finished transcription」をオフにすることで止められます。入れたURLやキーを消す方法は、記載が見つかりません。
• つまずき：Testの結果のラベルを見る。URLとキーを再確認する。Custom Webhookは、サーバーに届いて、返事が正しいかを確かめられます。

組み合わせG：MacWhisper × Obsidian

• 前提：Obsidianの側に、Local REST API のようなローカルのREST APIのコミュニティプラグインを入れて使います（ヘルプの表記は「such as」）。Obsidian本体の公式機能ではなく、コミュニティ製のプラグインを前提にした連携です。
• Obsidian側の準備：プラグインを入れて有効にし、ポートを決め（MacWhisper側の既定は27124）、APIトークンを作り、そのトークンにVaultのファイルの作成と更新を許可します。HTTPSでつなぎたいときは、証明書を入れる、とも書かれています。
• MacWhisper側：Settings → Integrations の Obsidian の欄に、IP Address（既定は127.0.0.1）、Port（既定は27124）、API Token を入れます。
• 送り方：…/vault/<題名>.md というアドレスを作り、PUTで送ります。Authorization: Bearer <token> と Content-Type: text/markdown が付き、本文は、JSONではなく生のmarkdownです。1つの文字起こしにつき、題名が名前のmarkdownが1つできます。
• Test：小さなmarkdownを送ります。Vaultにファイルが現れれば、ヘルプの意図どおりです。
• 確認点：プラグインが動いているか、Vaultが開いているか、IPとポートがプラグインの設定と合っているか。
• 注意（ヘルプの書き方の食い違い）：IPの欄の例と手順の文は https://127.0.0.1 と書かれています。一方、ヘルプに載る送信先のアドレスの例は http://127.0.0.1:27124/vault/<Title>.md で、http です。どちらの方式を使うかは、そのページでは決まっていません。証明書を入れるのは「https でつなぎたいとき」と書かれています。手元の画面とプラグインの設定で確認してください。
• 外し方：記載が見つかりません。

組み合わせH：ディクテーション × AI

• やること：Settings > Dictation で、AIのプロンプトを作ります。アプリごとに変えるなら、App Specific Prompts（06）。
• 条件（2025年2月24日更新と表示のヘルプ）：有効なProのライセンスと、自分のAPIキーが必要です。ヘルプが書くのはOpenAIのキーで、支払い方法を登録したAPIのアカウントが要ります。AnthropicなどはSoon（近日）と書かれています。
• 食い違い：AI Servicesのヘルプは「2026年7月14日更新」と表示され、Anthropicなど複数の提供元が並んでいます。ディクテーションのどのプロンプトが、AI Servicesのどのサービスを使うのかは、どちらのページにも書かれていませんでした。
• 渡るもの：話した内容の文字とプロンプト。外へ出る範囲は、使う提供元しだいです。

手順4：コマンドライン mw と、AIのコーディング用エージェント

公式ヘルプ「MacWhisper Command-Line Tool」の内容です。

インストール

1. MacWhisper → Settings → Advanced を開きます。
2. Command-Line Tool の欄の Install を押します。
3. mw が /usr/local/bin/mw に入ります。初回に、macOSがパスワードを聞くことがあります。
4. 緑のチェックと「installed at /usr/local/bin/mw」の表示が出ます。
5. ターミナルで確かめます。

mw version

出力の例として、ヘルプには MacWhisper 14.4.1 (1467) の形が載っています。

外し方

Settings → Advanced → Command-Line Tool → Uninstall で、/usr/local/bin/mw が消えます。

仕組みと渡るもの

• mw は、動いているMacWhisperのアプリと、ローカルのソケット（同じMacの中の連絡口）でつながります。アプリと同じエンジン、モデル、設定を使います。アプリが動いていなければ、起動します（待ち時間は5秒と書かれています）。
• 結果は標準出力に出て、進み具合は標準エラーに出ます。
• 文字起こしは既定で、履歴に残らない一時のものです。--persist で履歴に残します。
• クラウドのモデルを選んでいると、そのモデルの規則で音声が外に出ます。mw が新しく外へ送る口を作る、とは書かれていません。

主なコマンド

mw transcribe の主なフラグ：--speakers ／ --no-speakers、--format（txt、srt、vtt、json、csv、md、html、avid）、--style（transcript、subtitles、segments）、--model <id>（その1回だけ）、--language <コード|auto|multilingual>、--output ／ -o、--output-dir、--overwrite、--recursive、--stream、--persist、--timestamps、--end-timestamps、--milliseconds、--speaker-names、--group <none|words|sentences|people>、--max-chars-per-line <n>、--fps <n>。どのサブコマンドにも --help が使えます。

• Proが必要なのは json md html avid です。txt srt vtt csv は無料と書かれています。
• json は、ミリ秒の時刻、話者ごとの区切り、語ごとの時刻を含みます。
• --stream は、ローカルのエンジン（WhisperKit、ParakeetKit、Appleの音声認識）だけで効きます。
• --output は、既存のファイルを上書きしません。
• 複数のファイルやフォルダーは順に処理され、失敗したファイルは報告されて飛ばされます。1つでも失敗すれば、終了コードは0以外です。
• モデルが入っていないときは失敗します。先にアプリでダウンロードします。
• 言語は、モデルに対して検証されます。対応しない言語は、無視されずにエラーになります。Appleのモデルは単一の言語です。Appleのオンデバイスの音声モデルはmacOS 26以降が必要です。

AIのコーディング用エージェントから使う（公式の記載）

• ヘルプには、AIのコーディング用エージェントから使う節があり、エージェントに mw help transcribe を読ませて、使い方を調べさせる、という案内があります。
• 語の時刻つきの構造化された文字起こしは、--format json で得られる、と書かれています（Proが必要）。
• エージェントが隔離された環境（サンドボックス）で動くと、ソケットが遮られて「Sandboxed process」のエラーになることがあります。ヘルプの案内は、そのコマンドをサンドボックスの外で動かすか、ターミナルで直接 mw を動かすこと、です。

例：この記事で組んだ例（動作は確かめていません）

エージェントにJSONを渡す形の一例です。ファイル名は仮のものです。

mw transcribe interview.m4a --format json --speakers -o interview.json

その interview.json を、AIのエージェントや自分のスクリプトに渡す、という流れです。エージェントに渡る内容は、文字起こしの全文などです。エージェントの側のサービスの扱いは、そのサービスの規約によります。

つまずき（ヘルプの記載）

データはどこへ流れるか（この記事のまとめ）

気をつけること

• この記事は、実際に使って確かめた記録ではありません。設定例は、公式の記載に合わせて、この記事で組んだものです。動作は確かめていません。
• ヘルプの記事ごとに、更新の時期と書き方が違います。たとえば、ディクテーションのヘルプ（2025年2月）はOpenAIだけを書き、AI Servicesのヘルプには多くの提供元が載っています。クラウド文字起こしのヘルプは2025年7月15日の更新と表示されています。
• MCPや、コーディング用AIのプラグインは、読んだ公式ページに記述がありませんでした。「公式にない」と言い切るものではなく、読んだ範囲では見つからなかった、という意味です。
• MacWhisperのCLIのヘルプには、AIのエージェント向けの案内の節（mw help transcribe を読ませる、など）があります。この記事はそれを事実として紹介しているだけで、記事の作成では、その案内に従った作業はしていません。ページには、Proの割引を案内する文もあります。
• Integrationsの外し方、クラウド文字起こしのキーの削除、AIの提供元側のキーの取り消しは、読んだ範囲では記載が見つかりませんでした。
• Notionについて、Integrationsのヘルプは内蔵の連携とは書かず、自動化ツール経由の行き先の例として触れています。公式サイトには、文字起こしをNotionなどへ送る自動化がある、という書き方があります。細かい設定は、公式で確かめてください。
• 外部に文字起こしを送る機能は、他人の声や会議の内容を第三者のサービスに渡すことにもなります。同意や規則は、自分で確認してください。この記事は法律の助言ではありません。
• APIキーは秘密にして、画面の写真や設定ファイルに残さないよう、公式のヘルプも書いています。この記事の例は、すべてプレースホルダです。

出典

• Setting up AI providers in MacWhisper（MacWhisper Support、確認日 2026-10-25）
• Integrating MacWhisper with other services（MacWhisper Support、確認日 2026-10-25）
• MacWhisper Command-Line Tool（MacWhisper Support、確認日 2026-10-25）
• How to use the Cloud Transcription feature（MacWhisper Support、2025年7月15日更新と表示、確認日 2026-10-25）
• How to use the Dictation feature（MacWhisper Support、2025年2月24日更新と表示、確認日 2026-10-25）
• App Specific Dictation Prompts（MacWhisper Support、確認日 2026-10-25）
• MacWhisper & Whisper Transcription Difference（MacWhisper Support、確認日 2026-10-25）
• Transcription Is Slower Than Expected（MacWhisper Support、確認日 2026-10-25）
• Keyboard Shortcuts（MacWhisper Support、確認日 2026-10-25）
• MacWhisper（公式サイト、確認日 2026-10-25）