Wisprs

Wisprs AI コネクター

ChatGPT、Codex、Claude Code、リモート MCP クライアント向けの、Wisprs 公式配布パッケージです。Wisprs はホスト型のリモート MCP サーバーです。音声、動画、公開メディアのリンクを文字起こしし、その後、文字起こしの検索、要約、翻訳、エクスポートを行えます。このリポジトリには、クライアント設定、プラグインマニフェスト、スキルが含まれています。サーバー自体は wisprs.co で稼働しています。

認証が必要な Streamable HTTP エンドポイント（OAuth 2.1）は次のとおりです。

• ChatGPT：https://wisprs.co/api/mcp（チャットに添付されたファイル用の transcribe_file と、インライン文字起こしカードを含む23個のツール）。
• Claude コネクターおよびプラグイン：https://wisprs.co/api/mcp/claude（STT と TTS 以外のワークフロー向け、39個のツール）。
• Codex およびその他の直接接続型 MCP クライアント：https://wisprs.co/api/mcp（TTS を含む汎用エンドポイント、43個のツール）。
• ブラウザー設定ガイド：https://wisprs.co/mcp/setup。

公式 MCP Registry に co.wisprs/wisprs として登録されています（server.json を参照）。

Claude リリースは、文字起こし、ライブラリ、会議、クリエイター、サポート、開発者のワークフローに対応しています。

• transcribe_url は、公開 HTTPS メディア URL から非同期の文字起こしを開始します。
• get_private_media_upload_handoff は、ファイルのバイト列やアップロードトークンをモデル経由で送信せずに、ローカルメディアまたは非公開メディア用の認証済み Wisprs アップローダーを開きます。
• get_job_status は、重複した処理を作成せずに、永続的な操作の状態を確認します。
• get_transcript は、完了した文字起こしを、上限付きのカーソルベースのページで取得します。
• get_transcript_artifact は、生成されたコンテンツを、上限付きのページで取得します。
• search_library は、接続されたテナントのライブラリから、関連度順の場面を検索します。
• export_transcript は、TXT、SRT、VTT、JSON、Markdown、DOCX 形式のファイルを、期限付きの非公開 MCP リソースとして作成します。
• summarize_transcript と generate_chapters は、再利用可能な構造化アーティファクトを作成します。
• repurpose_transcript は、番組の概要、スレッド、ブログの下書き、引用文の選集を作成します。
• translate_transcript は、特定の言語で再利用可能なアーティファクトを作成します。

認証、認可、テナントの分離、冪等性、レート制限、コスト管理、監査記録、データ保持はサーバーが担います。このリポジトリには、Wisprs のサービスソースコード、認証情報、顧客データは含まれていません。

Claude Code にインストールする

ローカルのチェックアウトでテストします。

claude --plugin-dir ./wisprs-ai-connectors/claude

または、このリポジトリをマーケットプレイスとして追加します。

/plugin marketplace add Wisprs/wisprs-ai-connectors
/plugin install wisprs-ai-connectors@wisprs-plugins

Claude Code で /mcp コマンドを実行し、ブラウザーで OAuth を完了します。トークンをリポジトリ、プロンプト、設定ファイルに貼り付けないでください。

ChatGPT と Codex にインストールする

Wisprs は ChatGPT のアプリディレクトリで公開されています。Wisprs を検索して接続し、サインインしてください。録音を添付するかリンクを貼り付けて、文字起こしを依頼すると、チャット内の文字起こしカードに進行状況と完了したテキストが表示されます。

.codex-plugin/plugin.json マニフェストは、Codex 用に .mcp-openai.json と汎用エンドポイントを使用します。その他の MCP クライアントも https://wisprs.co/api/mcp に直接接続し、ブラウザーで OAuth を完了できます。

MCP の直接設定

Claude ホストでは claude/.mcp.json を使用します（Claude プラグインは claude/ にあり、マニフェスト、MCP 設定、スキル、アイコンのみを含みます）。その他のホストでは、汎用エンドポイント用に .mcp-openai.json を使用できます。各エンドポイントは OAuth 保護リソースのメタデータを返し、ブラウザーでの認可を実行します。このパッケージでは、静的なベアラートークンは不要であり、受け付けていません。

非同期処理の正しい使い方

1. ホスト側でまだ確認を取っていない場合は、文字起こしによって課金対象の非同期処理が開始されることをユーザーに伝え、確認を得てください。
2. 論理リクエストごとに、不透明な冪等性キーを1つ生成してください。
3. transcribe_urlを1回呼び出し、返されたoperationIdを保持してください。
4. retryAfterSeconds以上の間隔を空けてget_job_statusをポーリングしてください。
5. completedになったら、返された不透明なtranscriptionIdを使ってget_transcriptを呼び出してください。
6. nextCursorに正確に従い、レスポンスが部分的なものである場合はその旨を明示してください。

エクスポートとAI変換では、同じ冪等性キーを使い、返されたオペレーションをポーリングしてから、正確なエクスポートリソースURIを読み取るか、完了結果のメタデータを使ってget_transcript_artifactを呼び出してください。MCPリソースが利用できる場合は、大きなエクスポートを会話コンテキストに直接含めないでください。

結果が不明確なtranscribe_urlの呼び出しを、新しい冪等性キーで再試行しないでください。課金対象の処理が重複して作成される可能性があります。

開発

要件：Node.js 22以降。ホスト検証には、最新のClaude CodeおよびCodexツールも必要です。

npm test
npm run validate
npm run package

npm run validate:live-linksでは、HTTPS経由で公開されているポリシーとサポートリンクも検証します。ホスト固有のテストケースとリリースゲートについては、docs/HOST_COMPATIBILITY.mdおよびdocs/REVIEWER_GUIDE.mdを参照してください。

セキュリティとプライバシー

脆弱性を報告する前にSECURITY.mdを、パッケージのデータ境界についてはPRIVACY.mdをお読みください。サービスのポリシーはwisprs.co/privacyおよびwisprs.co/termsで公開されています。

リリース状況

バージョン0.30.0です。ChatGPTのアプリディレクトリおよび公式MCP Registryで公開済みです。Claudeのディレクトリへの掲載は審査中です。互換性と来歴については、CHANGELOG.mdおよびrelease.jsonを参照してください。

ライセンス

MITです。LICENSEを参照してください。