3行でいうと

  • MCPは、公式のMCPのページに、Claude Desktopは「Settings, then Connectors」、Cursorは「Settings, then MCP」、ChatGPTは「Plugins」の中のカスタムMCPサーバー、Codex・VS Code・Windsurf・Zedは「それぞれのリモートMCPの流れ」と書かれています。APIの資料のMCPの節は、Claudeは「Customize > Connectors > Add > Add custom connector」、ChatGPTは「Plugins > Add > Create custom MCP server」と書いていて、MCPのページとClaudeの道順の書き方が違います。つないだあとの確認は、AIに aqua_get_me を呼ばせる、と書かれています。
  • MCPは、AIに「口述させる」ものではありません。履歴、辞書、設定の読み書きです。つなぐと、そのAIが、Aquaにある、あなたの口述の履歴を読めます。見えるのは、つないだ本人の履歴だけ、と公式にあります。
  • APIは、ダッシュボードでキーを作り、Bearerトークンとして付けます。口述、文字起こし、履歴、辞書、設定のルートがあり、要求は米国で処理される、と書かれています。
  • 外し方は、MCPのページに「記載が見つからない」状態です。APIのキーの取り消しの画面も、読んだ範囲では確認できていません。
  • 公式のMCPの手順書（aquavoice.com/docs/mcp）は、2回試して、どちらも取得できませんでした。MCPの節は、MCPのページ（aquavoice.com/mcp）、API紹介のページ、APIの資料（docs/api）のMCPの節の内容だけで書いています。

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

先に結論

前提：用語をそろえる

連携5：API

公式のAPIのドキュメント（aquavoice.com/docs/api）とAPIの紹介ページ（aquavoice.com/api）に基づきます。開発者向けです。

5-1：キーを作る

  1. ブラウザで、API dashboard（https://app.aquavoice.com/api-dashboard）を開きます。
  2. 「Create an API Key」を押して、キーを作ります（APIの紹介ページのボタン名）。
  3. キーはその場で控えます。「Full keys are shown only once」（全文は一度だけ表示される）と公式にあります。
  4. 1つのアカウントで、最大30個まで。最初のキーを作ると、アカウントが有効になる、とあります。
  5. 試すには、APIの紹介ページの「Try in Playground →」のリンクか、ダッシュボードのPlaygroundのタブがある、と書かれています（PlaygroundのURLは、APIの資料には書かれていませんでした）。

キーの権限：公式は、キーには、口述、文字起こし、セッション、カスタマイズ、設定、MCPのすべてへのアクセスがある、と書いています（1つのキーで全部、という意味です）。取り消しや削除の画面は、読んだ範囲では確認できていません。

5-2：呼び出す（公式の例の写し。原文と照らしてください）

ベースURLは https://api.aquavoice.com/v1。すべてのルートで、キーをBearerトークンとして付けます。

curl https://api.aquavoice.com/v1/me \
  -H "Authorization: Bearer <api-key>"

音声ファイルの文字起こし（同期）：

curl -X POST https://api.aquavoice.com/v1/audio/transcriptions \
  -H "Authorization: Bearer <api-key>" \
  -F "file=@audio.mp3" \
  -F "model=avalon-v1.5" \
  -F "language=auto"

口述（短い音声を整えて文字にする）：

curl -X POST https://api.aquavoice.com/v1/dictations \
  -H "Authorization: Bearer <api-key>" \
  -F "audio=@audio.wav" \
  -F "operation=dictate" \
  -F "language=auto"

主なルート（公式の表。「OAuthスコープ」はOAuthのトークンにだけ適用される）：

ルート OAuthスコープ 内容
GET /me なし ユーザー、認証の方式、プラン、history_available
GET /sessions、/sessions/{id}、/sessions/{id}/transcript read セッションの一覧と、文字起こし
POST・DELETE /sessions/{id}/feedback write 評価の登録と消去
POST /dictations write 口述、またはEdit Mode
GET・PATCH /customizations read／write 辞書、置き換え、カスタム指示
GET・PATCH /settings read／write 言語、casual_messaging
POST /audio/transcriptions、/audio/transcription-jobs 記載なし 文字起こし（同期、非同期）

主な条件（公式）： - /dictations：16 kHzのモノラルPCM16のWAV、またはOgg Opus。10分まで。Edit Modeは operation=edit と selected_text（0〜6,000文字）。 - 文字起こし：flac、mp3、mp4、mpeg、mpga、m4a、ogg、opus、wav、webm。最大256 MiB、デコード後4時間まで。model は avalon-v1.5。話者ごとの分け（diarize）や、srt、vtt の形式もある。 - 処理に時間がかかる音声は、非同期のルート（/audio/transcription-jobs）で、状態と結果を別のルートで取る。 - 同期の要求は、最大210秒待つ。504 request_timeout のときは、本文に error.job_id が入り、処理は続く、と書かれています。

料金（公式、確認日 2026年10月25日。変わることがあります）：最初の$1.00分は無料でカード不要。そのあと、口述（Edit Modeを含む）は1時間あたり$0.49、文字起こしは$0.39。秒単位で、最低10秒。支払い方法は、APIダッシュボードで足す、とあります。

5-3：データの扱い（公式の記載）

5-4：うまくいかないときの確認点（API）

症状 公式の記載
402 payment_method_required、billing_past_due 課金の画面（billing_url）で支払い方法を確認
403 subscription_required 同上
400 user_required 組織のキーでは、製品と口述のルートに Aqua-User ヘッダーが要る
403 platform_not_supported プラットフォームのキーは POST /dictations だけ
409 job_not_complete 非同期の結果がまだ。待って再試行
429 レート制限。Retry-After ヘッダーを見る。具体的な数字は、公式のAPIのページには載っていません

5-5：外し方（API）

連携6：MCP（AIがAquaの履歴・辞書・設定を読み書きする）

公式のMCPのページ（aquavoice.com/mcp）、APIの紹介ページ、APIの資料（aquavoice.com/docs/api）のMCPの節に基づきます。MCPの手順書（aquavoice.com/docs/mcp）は、取得できませんでした（2回試しました）。

6-1：できること、できないこと

6-2：つなぐ手順（公式のMCPのページの順）

  1. MCPのページで、接続のURLをコピーします。公式は「リモートMCPに対応するすべてのクライアントに1つのURL」と書いています。
  2. AIアプリで、リモートのMCPサーバーとして追加します。
  3. Claude：MCPのページは「Claude Desktop: Settings, then Connectors.」と書いています。APIの資料は、「Customize > Connectors > Add > Add custom connector」を開き、続けて「Continue」「Add」「Connect」を押す、と書いています。同じ画面の書き方が2つのページで違うため、手元の画面と照らしてください。
  4. ChatGPT：MCPのページは、「Plugins」の中の、カスタムMCPサーバー（FAQの表記は「custom MCP server in Plugins」）と書いています。APIの資料は、「Plugins > Add > Create custom MCP server」を開き、チェックボックスを選んで「Create as a plugin」を押す、と書いています。
  5. Cursor：MCPのページは「Cursor: Settings, then MCP.」とだけ書いています。APIの資料には、Cursorの記載はありませんでした。設定ファイルの書き方は、公式で確認できていません。
  6. Codex、VS Code、Windsurf、Zed：MCPのページは、それぞれの「リモートMCPの流れ」を使う、と書き、道順は示していません。
  7. Aquaのアカウントでサインインし、求められている許可を確認します。AIアプリによっては、読み取りと書き込みを同時に求めてくる、と公式は書いています。APIの資料は、許可したあとに、会話の中でAquaを有効にする、とも書いています（その画面の表記は、公式で確認できていません）。
  8. つながったか確かめるには、AIに aqua_get_me を呼ばせます。「アカウントとプライバシーモードが返るはず」と公式にあります。

6-3：権限（スコープ）

範囲 何ができるか（公式）
read アカウントの情報、保存されているセッションと文字起こし、カスタマイズ（辞書など）、対応する設定を読む
write フィードバックの追加、カスタマイズと設定の変更

6-4：渡るデータ

6-5：外し方

6-6：うまくいかないときの確認点（MCP）

症状 確認すること（公式の記載の範囲）
追加できない AIアプリがリモートMCP（OAuth付き）に対応しているか。ワークスペースで、管理者の承認が要るか
つながったか分からない AIに aqua_get_me を呼ばせ、アカウントとプライバシーモードが返るか
書き込みで403 読み取りだけの許可。許可し直す（insufficient_scope）
履歴が空 Privacy Mode、ZDR、履歴がまだない、のいずれか。/me の history_available を見る（APIでつなぐ場合）
見えるはずのチームの履歴が見えない 見えるのは、つないだ本人の履歴だけ

組み合わせの一覧（AI × Aqua Voice）

「公式のページに書かれている範囲」と、「この記事の案」を分けます。案は、動作を確かめていません。

組み合わせ 公式のページに書かれている範囲 この記事の案（動作は確かめていない）
Aqua × ChatGPT 入力欄に話す（ChatGPTのページ）。MCP：「Plugins」の中のカスタムMCPサーバー 入力欄に話すのは、06の場面4。MCPは、履歴や辞書を読ませたいときだけ検討する
Aqua × Claude 入力欄に話す（Claudeのページ）。MCP：Claude Desktopの「Settings, then Connectors」（MCPのページ）、「Customize > Connectors > Add > Add custom connector」（APIの資料） 同上
Aqua × Claude Code 入力欄（ターミナル）に話す。CLI：aqua setup claude でスキルを入れる 話しかけてClaude Codeに頼み、辞書の更新は、エージェント経由のCLIに任せる。実行の確認を求める設定は、Claude Code側で決める
Aqua × Codex 入力欄に話す。CLI：aqua setup codex。MCP：Codex独自のリモートMCPの流れ（道順は書かれていない） 同上
Aqua × Cursor 入力欄、Cmd+K、ターミナルに話す。File Tagging（対応）。MCP：「Settings, then MCP」（MCPのページ） File Taggingは、Cursorのチャットで、ファイル名を話して指す
Aqua × Slack・Gmail 話して入れる。Send Itで、Slackは Enter、メールは ⌘+Enter または Ctrl+Enter 初めはPaste Onlyにして、送るのは手で行う
Aqua（CLI）× 別のAI 音声ファイルを文字にして、ファイルや標準出力へ出す 文字起こしの結果（テキスト）を、別のAIに貼って要約させる。音声はAquaへ、文字はそのAIへ渡る。録音に他人の声が入る場合は、利用規約の録音に関する注意を読む（04）
Aqua（API）× 自作のプログラム キー、ルート、料金、データの扱い（5節） 公式のPlaygroundで、先に呼び方を試す

外し方のまとめ

連携 外し方（公式の記載）
AIの入力欄に話す 接続がないので、外すものがない
File Tagging 記載が見つからない
CLI aqua auth logout。CLIの削除は記載が見つからない
スキル 記載が見つからない
APIのキー ダッシュボードで管理。取り消しの画面は確認できていない
MCP 記載が見つからない。AIアプリ側の設定で外す

気をつけること

出典