txscribe

@txscribe/mcp

txscribe 開発者 API 用の MCP サーバーです。AI アシスタントが txscribe アカウントを使ってリンクを文字起こしし、同じく https://txscribe.ai/developers に記載されている API を通じて、文字起こし結果と要約を読み取れるようにします。

接続方法は 2 つあり、どちらも同じ 8 つのツールを使います。

• ホステッド — https://txscribe.ai/mcp（ストリーミング可能な HTTP）。Claude と ChatGPT はカスタムコネクターとして接続し、OAuth で txscribe にサインインします。インストールは不要です。ヘッダーを指定できるクライアントは、代わりに API キーを送信できます。
• ローカル — このパッケージを、Claude Desktop、Claude Code、Cursor など、MCP サーバーを自ら起動するクライアントからコマンド（npx -y @txscribe/mcp）として実行し、環境変数に API キーを設定します。

どちらも薄いラッパーです。各ツールは、あなたとして開発者 API を 1 回呼び出します。ツールが実行できる操作と消費する時間は、アプリであなたのアカウントが実行できる操作とまったく同じです。キャッシュや、マシン上への保存は行われません。

ホステッド：Claude と ChatGPT

• Claude（claude.ai、デスクトップアプリ）：設定 → コネクター → カスタムコネクターを追加し、URL に https://txscribe.ai/mcp を指定します。Claude が txscribe を開くので、サインインして 許可 を選択します。
• ChatGPT（開発者モードを有効にした状態）：URL に https://txscribe.ai/mcp を指定し、認証方式として OAuth を選択してコネクターを追加します。その後、開いた txscribe のページで許可します。
• Claude Code：claude mcp add --transport http txscribe https://txscribe.ai/mcp（OAuth でサインインします）。または、キーを使う場合： claude mcp add --transport http txscribe https://txscribe.ai/mcp --header "Authorization: Bearer txs_live_…".
• Cursor など、URL とヘッダーを指定できるクライアント：上記の URL と、ヘッダー Authorization: Bearer txs_live_… を指定します。

許可 を選択して接続すると、アプリがあなたに代わって API キーを保持します。キーは プランと請求 → 開発者 API に表示され、取り消す を選ぶと、そのアプリとの接続が解除されます。キーは自動では期限切れになりません。

ローカル：このパッケージ

1. アプリで プランと請求 → 開発者 API を開き、キーを作成します（txs_live_ で始まり、一度だけ表示されます）。
2. 環境変数にキーを設定して、クライアントにサーバーを追加します。

Claude Desktop（claude_desktop_config.json）またはコマンドを指定できるクライアント：

{
  "mcpServers": {
    "txscribe": {
      "command": "npx",
      "args": ["-y", "@txscribe/mcp"],
      "env": { "TXSCRIBE_API_KEY": "txs_live_…" }
    }
  }
}

Claude Code：

claude mcp add txscribe --env TXSCRIBE_API_KEY=txs_live_… -- npx -y @txscribe/mcp

TXSCRIBE_API_BASE を設定すると、サーバーが別のデプロイ先を参照します（デフォルトは https://txscribe.ai/api/v1 です）。

ツール

ツール	説明	書き込み？
list_transcriptions	新しい順の文字起こし一覧。ページ分割に対応しています	いいえ
search_transcriptions	単語やフレーズが含まれる録音と、その箇所を検索します。各録音から最大5件の一致を返し、開始時刻を秒単位で示します。新しい録音500件のうち、完了済みの録音を対象に、タイトルではなく発話内容を検索します。	いいえ
transcribe_link	リンク（YouTube、Google Drive、Dropbox など）から文字起こしを作成します。録音は文字起こしされますが、ダウンロードはされません。利用時間を消費します。	はい
get_transcription	1件の文字起こしのステータスとメタデータ	いいえ
get_transcript	完了した文字起こしを json（セグメント、単語のタイミング、話者）、txt、srt、vtt 形式で取得します。ある瞬間の前後にある段落だけを取得するには from と to（秒単位）を指定し、要約を取得するには summaryOnly を指定します	いいえ
get_summary	要約とそのステータス	いいえ
request_summary	録音の言語と種類を指定して、要約または新しい要約をリクエストします	はい
delete_transcription	文字起こしと、そこから作成されたすべてのものを削除します。元に戻すことはできません。	はい、破壊的

5つのツールは読み取り専用で、3つはアカウントを変更します。ファイルのアップロードはツールではありません。API の アップロードはファイル全体を送信する署名付き PUT であり、アシスタントはチャットから実行できません。ファイルの操作には アプリ、または API を直接使用してください。

一般的なやり取り：「この講演を文字起こしして、確認すべき主張を3つ教えて」 → transcribe_link → status が done になるまで get_transcription → get_transcript（txt） → アシスタントが内容を読み取ります。要約については request_summary + get_summary を使って txscribe が作成した要約を取得します。

すでにある録音から情報を探す場合：「予算について何に合意しましたか？」 → search_transcriptions（"budget"）→ 一致箇所の前後を指定して get_transcript の from/to を使います。返された 一致箇所を確認するため、文字起こし全体を取得する必要はありません。

エラー

API による拒否は、API 独自のコード（invalid_api_key、 quota_exceeded、not_ready、unsupported_link など）、HTTP ステータス、 サポートへの問い合わせ時に伝えるリクエスト ID とともに、ツールエラーとして返されます。また、429 の場合は Retry-After の秒数も返されます。サーバー自体は再試行を行いません。

開発

npm ci
npm test

テストでは、偽の fetch を使い、インメモリトランスポート経由でサーバーを実行します。ネットワークには何も送信されません。ホスト型サーバーはウェブアプリ（web/src/lib/mcp/）にあり、そのツール一覧がこの一覧と一致することをテストで確認します。

公開（メンテナー向け）

cd mcp
npm ci && npm test
npm login                      # an npm account that owns the @txscribe scope
npm publish                    # publishConfig makes it public; prepublishOnly runs the tests

server.json は MCP レジストリ（registry.modelcontextprotocol.io）へのエントリーです。その name は package.json の mcpName と一致しており、これによってレジストリは npm パッケージが当社のものかを確認します。npm パッケージの公開後、ホスト型エンドポイントを有効にしてから、mcp-publisher と txscribe.ai の DNS による所有権証明を使って公開してください。