Quiet Typist MCP の設定方法：Claude Code・Codex・Cursor などのエージェントに接続

プロンプトをエージェントに送って Quiet Typist MCP を自動で設定する方法と、Claude Code、Codex、Cursor、VS Code にローカルの文字起こしサーバーを手動で追加する方法を説明します。

Quiet Typist MCP は、このコンピューター上で動く Streamable HTTP サーバーです。エージェントを接続すると、ローカルの録音・動画ファイルを送って文字起こしし、その結果を読み取れます。

エージェントにまかせて設定する

Quiet Typist の MCP 画面で「エージェント設定用プロンプト」の「コピー」をクリックし、エージェントのチャットに貼り付けて送信します。エージェントがこのページの手順に沿って設定を行います。アプリが生成するプロンプトには、現在の MCP URL が含まれています。

次のプロンプトをコピーして使うこともできます。

https://quiettypist.com/ja/docs/mcp-setup.md のガイドを読み、手順どおりに Quiet Typist MCP を設定してください。

エージェント向けの指示

ユーザーが MCP URL を指定した場合はその URL を使い、指定がなければデフォルトの http://127.0.0.1:36158/mcp を使う。
まず下記の「サーバーの確認」でサーバーが応答するか確かめる。応答しない場合は、Quiet Typist を開いて MCP 画面の「MCP サーバーを有効にする」をオンにするようユーザーに依頼し、その後で設定を続ける。
使用中のクライアントに合った設定方法を選び、できるだけユーザー単位の設定に書き込む。anxinzhuan がすでにある場合は URL だけを更新し、ほかの MCP サーバーには手を加えない。
完了したら、どのクライアントを再起動または再読み込みする必要があるかと、接続後に使えるツールをユーザーに伝える。

接続情報

項目	値
サーバー名	`anxinzhuan`
通信方式	Streamable HTTP（クライアントによっては HTTP、ストリーミング HTTP と表示）
MCP URL	`http://127.0.0.1:36158/mcp`
認証	なし

デフォルトのポートが使用中の場合、Quiet Typist は空いている次のポートに自動で切り替えます。実際の URL は MCP 画面に表示される MCP URL で確認してください。以下の例はデフォルトの URL を使っているため、異なる場合は置き換えてください。利用中は Quiet Typist を起動したままにしておく必要があります。

サーバーの確認

curl http://127.0.0.1:36158/health

{"status":"ok"} が返れば正常に動作しています。Windows PowerShell では curl.exe を使ってください。

クライアントに追加する

Claude Code

claude mcp add --transport http --scope user anxinzhuan http://127.0.0.1:36158/mcp

追加後、claude mcp list で接続状態を確認できます。

Codex

codex mcp add anxinzhuan --url http://127.0.0.1:36158/mcp

~/.codex/config.toml に直接追加することもできます。

[mcp_servers.anxinzhuan]
url = "http://127.0.0.1:36158/mcp"

Codex アプリで追加する場合は「ストリーミング HTTP」を選んで MCP URL を入力します。画面の例は MCP の使い方を参照してください。

Cursor

~/.cursor/mcp.json に次の内容を追加します。

{
  "mcpServers": {
    "anxinzhuan": {
      "url": "http://127.0.0.1:36158/mcp"
    }
  }
}

VS Code

ユーザー単位の mcp.json（コマンドパレットで「MCP: Open User Configuration」を実行）か、ワークスペースの .vscode/mcp.json に次の内容を追加します。

{
  "servers": {
    "anxinzhuan": {
      "type": "http",
      "url": "http://127.0.0.1:36158/mcp"
    }
  }
}

その他のクライアント

クライアントの MCP 設定で、Streamable HTTP 形式のサーバー（HTTP、ストリーミング HTTP、streamableHttp と表示される場合があります）を追加します。名前は anxinzhuan、URL には MCP URL を入力し、認証情報は不要です。stdio にしか対応していないクライアントからは、現時点では直接接続できません。

接続を確認する

設定を保存したら、クライアントを再起動するか MCP 接続を再読み込みします。接続に成功すると、次のツールが表示されます。

ツール	用途
`submit_task`	ローカルの録音・動画ファイルを文字起こしに送る。話者分離も指定可能
`query_tasks`	タスクの状態と進捗を確認する
`get_result`	文字起こし結果を取得する。話者情報があればあわせて返す
`save_result`	文字起こし結果を新しい .txt または .md ファイルに保存する。長時間の録音向け

あとはエージェントに「Quiet Typist でこのファイルを文字起こしして」と頼み、録音または動画ファイルのフルパスを添えるだけです。

MCP の設定

目次