Cursor・VS Codeに接続先とAPIキーを設定します
Cursorでは.cursor/mcp.json、VS Codeでは.vscode/mcp.jsonに接続先を設定します。どちらもセットアップガイドからワンクリックで追加できます。
リモートMCPとstreamable HTTPに対応し、Authorizationヘッダーを送れるクライアントが必要です。CursorとVS Codeでは設定ファイルの構造が違います。ファイル名だけを変えず、それぞれの設定例を使ってください。
接続後は、まずget_accountかlist_transcriptionsを呼ぶようアシスタントに頼みます。課金対象のジョブを作らずに認証を確認できます。ツールが見つからない場合は設定の読み込みとサーバーの有効化、認証エラーならクライアントに設定したキーを確認します。
{
"mcpServers": {
"transcript1": {
"url": "https://api.transcript1.com/mcp",
"headers": {
"Authorization": "Bearer t1_YOURKEY"
}
}
}
}Claude Codeはコマンドで、Claude・ChatGPTはログインで接続します
Claude Codeでは、接続先とAPIキーを付けてclaude mcp addを実行します。ClaudeとChatGPTでは、同じURLをカスタムコネクターに設定してログインします。クライアント別の手順を確認してください。
ClaudeとChatGPTはOAuthで接続します。カスタムコネクターを使えるかどうかは、アシスタントのプランとワークスペース設定によります。APIキーを使うコードエディター向けの設定とは別なので、利用中のアプリの手順に従います。
接続できたら、公開動画のURLと作業内容を伝えます。たとえばInstagramのReelを文字起こししてから、話している手順を抜き出すよう頼めます。transcript1が渡すのは音声のテキストです。アシスタントが見ていない映像まで理解できるようになるわけではありません。
claude mcp add --transport http transcript1 https://api.transcript1.com/mcp --header "Authorization: Bearer t1_YOURKEY"文字起こしを作成し、続きのページまで読みます
アシスタントがtranscribeを呼び、処理が完了したら最初のページを読みます。まだ処理中なら、返されたIDをget_transcriptionに渡します。ツール一覧とエージェント向けの使い方に引数と読み進め方をまとめています。
標準ではタイムスタンプ付きテキストを返します。長い文字起こしにはnext_from_secondsが付きます。この値を次のfrom_secondsに指定して読み進めます。最初のページだけで全文と判断したり、必要なページを読む前に録音全体を要約したりしないようにします。
完全な動画リンクは24時間以内の文字起こしと照合できますが、短縮リンクでは作成時の再利用ができません。どのリンクでも、既存のIDが分かっていればget_transcriptionで読み直せます。以下の例のプレースホルダーは、実際の公開TikTok動画のURLに置き換えます。
transcribe(url="[public TikTok video URL]")
get_transcription(id="tr_8fK2Lm0PqRsTuVwXyZaBcD", format="srt")ローカルの録音は、ファイルを送れる環境が必要です
MCPのやり取りだけでは、録音のバイト列は送信されません。create_uploadで予約した後、ファイルを読めるエージェントがMCPの外でHTTPを使ってチャンクを送り、complete_uploadを呼びます。ファイル送信の手順で役割を確認できます。
アシスタントがローカルファイルを読めない場合や、バイナリをHTTP送信できない場合は、ダッシュボードで録音をアップロードします。完了した文字起こしのIDをアシスタントに渡してください。チャットにファイル名を書くだけでは、transcript1にファイルは届きません。
MCPにはWebhookの設定項目がありません。完了通知が必要ならREST APIを使います。会話中は一定時間待ち、同じIDで確認する方法が使えます。接続が切れてもジョブが未作成とは限りません。最近の一覧や保存したIDから再開します。
同じ接続でBluesky動画の要約やTikTok動画の台本確認も頼めます。投稿は公開されている必要があります。テキストで分かる音声の内容と、別途確認が必要な映像の内容を分けて扱います。