Transcripted

Transcripted MCP

Transcripted の会議、口述、文章作成に対応する読み取り専用のローカルツールです。

Claude Desktop ユーザーには、アプリ内でのセットアップが最適です。

1. Transcripted を開きます。
2. Settings を開きます。
3. Agent に移動します。
4. Install in Claude をクリックします。
5. Claude Desktop を再起動します。

この方法では、同梱のヘルパーをインストールし、Claude Desktop の設定を更新して、 ローカルのセルフテストを実行します。

インタラクティブ UI（MCP Apps）

このサーバーは、MCP Apps 拡張機能 （io.modelcontextprotocol/ui、SEP-1865）を介して、1 つのインタラクティブなウィジェットを公開します。show_recent_meetings を呼び出すと、最近の会議をカード形式の一覧で表示します。各カードにはインライン音声再生と生の文字起こし表示が含まれ、描画に対応したクライアント内に表示されます。完全に自己完結しており（ネットワーク不要。ローカルの音声／文字起こしデータはローカルトランスポート経由で送信されます）、インライン UI を描画しないクライアント（例：Claude Code CLI）ではプレーンテキストの一覧に切り替わります。現在、ChatGPT、VS Code、Cursor、Goose でインライン表示できます。クライアントごとの対応状況と試し方については、 docs/mcp-ui-recent-meetings.md を参照してください。

ソースからのビルド

MCP サーバーを直接開発する場合にのみ使用してください。

swift build -c release
swift test

バイナリ：

.build/release/transcripted-mcp

セルフテスト：

.build/release/transcripted-mcp --self-test

Transcripted がローカルディレクトリのマニフェストまたは transcriptSaveLocation 設定を書き込んでいる場合、サーバーはアプリで選択されたキャプチャライブラリを最初に読み取ります。 カスタムライブラリがない場合は、次を読み取ります。

~/Library/Application Support/Transcripted/captures/meetings
~/Library/Application Support/Transcripted/captures/dictations
~/Library/Application Support/Transcripted/captures/writing

TRANSCRIPTED_DATA_DIR、TRANSCRIPTED_MEETINGS_DIR、 TRANSCRIPTED_DICTATIONS_DIR、TRANSCRIPTED_WRITING_DIR、または TRANSCRIPTED_INDEX_DIR でパスを上書きできます。 TRANSCRIPTED_DATA_DIR が meetings/、dictations/、または writing/ サブフォルダーを含む共有ルートを指している場合、transcripted-mcp はそれらのサブフォルダーを自動的に使用し、TRANSCRIPTED_INDEX_DIR も設定されていない限り、その共有ルートに SQLite インデックスを保存します。会議または口述に種類別の上書きパスを指定した場合、TRANSCRIPTED_WRITING_DIR も設定されているときに限り、文章作成データが読み取られます。

文章作成

list_writing と read_writing は、Writing_<date>.md の日別ファイル（ユーザーが Transcripted キーボードで入力した内容）を対象に、list_dictations と read_dictation と同様に動作します。search_context と recent_context では kind: "writing" を指定でき、all には文章作成データが含まれます。文章作成データの検索は全文検索のみです。デバイス上の埋め込みデータが対象とするのは、会議と口述です。

テレメトリ

このサーバーは、追跡対象のキャプチャクエリが完了するたびに、匿名の PostHog イベントを 1 件送信できます（agent_capture_query_observed。詳細は AgentCaptureQueryTelemetry.swift を参照してください）。result は success、 empty_not_found、invalid_input、internal_error のいずれかです。ペイロードは、許可リストで定めた大まかなメタデータに限定されます。クライアント、ツール、キャプチャの種類、レイテンシとソース数／結果数の範囲、結果、および利用可能な場合は、所有するアプリの検証済み app_version、ビルドチャネル、リビジョンです。アプリがビルド識別情報をインストールしていない場合、その情報は省略されます。ヘルパー自身のサーバーバージョンがアプリバージョンの代わりに使われることはありません。source_count_bucket は、応答に寄与した異なるキャプチャファイルの数を意味します。result_count_bucket は、そのツール固有の自然な応答単位で返されたレコード数を意味します。文字起こしテキスト、クエリ文字列、キャプチャ ID、タイトル、名前、ファイルパス、音声、ユーザー識別子がプロパティとして送信されることはありません。

送信には 2 段階の条件があります。

• アプリの匿名分析設定（observability-anonymous-analytics-enabled）に従います（オフの場合は何も送信されません）。
• POSTHOG_API_KEY／POSTHOG_HOST、ローカルの上書き設定、またはバンドル内の TranscriptedPostHogAPIKey を使って PostHog API キーと HTTPS ホストが設定されていない限り、何も実行しません。ソースビルドでは、デフォルトでどちらも設定されていません。

どのモードでも、文字起こしと音声が Mac から外部に送信されることはありません。

ミーティング横断レシートツール

WS2.3 では、エージェント向けにローカルで構造化データを検索するツールを追加します。

• decisions(topic, range)
• commitments(person, range)
• open_questions(project, range)
• search_meetings(query, range)

各ツールは、meetingId、timestamp、quote を中心とした JSON レシートを返します。要約から生成されたレシートでは、正確な音声アンカーを利用できるようになるまで、timestamp: null になります。発話の生データを検索する場合は、文字起こしのタイムスタンプが含まれます。これらのツールは、ローカルの SQLite インデックスと保存済みの要約・パーサー出力のみを使用します。

MCP バンドルとレジストリ

各リリースでは、バンドルを直接インストールするクライアント向けに、ヘルパーを MCP バンドル（transcripted-mcp.mcpb）として配布し、公式 MCP レジストリにも io.github.r3dbars/transcripted として登録できます。

Publish MCP Bundle ワークフローで、その両方を行います。リリース DMG から署名済みヘルパーをコピーし、mcpb/manifest.json とともにパッケージ化して、バンドルをリリースに添付した後、ルートの server.json に情報を入力して公開します。リリースの公開時に実行されます。手動実行はできません（どのブランチからでも実行される可能性があるためです）。再試行するには、ジョブを再実行してください。 何も再ビルドされないため、バンドルには公証済みアプリの署名が維持されます。

リポジトリのルートにある glama.json は、メンテナー向けの Glama 登録を申請します。