SpeechdashHelp Center

MCP サーバー

Cursor、Claude Desktop、ChatGPT、またはその他の MCP クライアントを Speechdash のパブリック API に接続します。

Speechdash では、ライブラリと音声合成を ツール として公開する公式の Model Context Protocol (MCP) サーバーを提供しています。このサーバーを使用すると、AI アシスタントがドキュメント（完了した音声認識を含む）を一覧表示したり、テキストのインポート、翻訳、エクスポート、ウォレットの確認、または HTTP 呼び出しを手動で書かずに音声合成を行うことができます。ライブラリには完了した音声認識 (source=transcription) が含まれています。音声認識ツールはありません：これらのジョブはドキュメントツールで読み込みます。MCP は音声認識のジョブを開始しません。

また、パブリック REST API を直接 curl または独自のクライアントで呼び出すこともできます。MCP と HTTP は同じエンドポイント、クレジット、および両方のインターフェースが存在する場合のレート制限を共有します。

インバウンド（このページ）: Speechdash の公式 MCP である mcp.speechdash.com は、外部のアシスタントが あなたの Speechdash ライブラリを呼び出すことを可能にします。

アウトバウンド（アプリ設定）: 設定 → コネクタ は、その機能が有効な場合に、インアプリのチャット UI に 第三者 の MCP サーバーを接続します。これは Speechdash のパブリック MCP サーバーではありません。

パブリックデプロイメントの mcp.speechdash.com で SPEECHDASH_API_KEY を設定しないでください。各クライアントは OAuth または Authorization ヘッダー内の個人用の sh_live_… キーで認証する必要があります。

開始する前に

Cursor、Claude Desktop、およびその他のベアラーキーを受け入れるクライアント用に、アプリ内の 設定 → API で API キーを作成してください。MCP は HTTP と同じ sh_live_… キーを使用します。詳細は API 概要 を参照してください。

ChatGPT (OAuth)

ChatGPT は OAuth 2.1 + PKCE を必要とします。ChatGPT コネクタ UI に API キーを貼り付けないでください。

  1. MCP URL: https://mcp.speechdash.com/mcp
  2. OAuth リソース: https://mcp.speechdash.com
  3. 保護されたリソースメタデータ: https://mcp.speechdash.com/.well-known/oauth-protected-resource
  4. 認可サーバー（ディスカバリー): https://speechdash.com/.well-known/oauth-authorization-server

ChatGPT がプロンプトを表示したときに Speechdash アカウントでサインインしてください。アプリによってトークンが鋳造され、MCP サーバーとパブリック API が受け入れます。

セットアップのガイド: Agents hub。

ツール

各 MCP ツールは REST エンドポイントに対応しています：

MCP ツールREST
speechdash_get_accountGET /v1/me
speechdash_list_documentsGET /v1/documents
speechdash_get_documentGET /v1/documents/{document_id}
speechdash_create_documentPOST /v1/documents
speechdash_update_documentPUT /v1/documents/{document_id}
speechdash_translate_documentPOST /v1/documents/{document_id}/translate
speechdash_export_documentGET /v1/documents/{document_id}/export
speechdash_delete_documentDELETE /v1/documents/{document_id}
speechdash_list_voicesGET /v1/voices
speechdash_get_voiceGET /v1/voices/{voice_id}
speechdash_synthesize_speechPOST /v1/audio/speech

サーバーはリソース speechdash://openapi（ライブの OpenAPI JSON）も公開しています。

MCP と REST の機能比較

機能MCPREST
アカウントスナップショットはい (speechdash_get_account)GET /v1/me
ドキュメント CRUD（ライブラリ、完了した音声認識を含む）はいはい
音声認識ジョブの開始いいえ（アプリ専用）いいえ（アプリ専用）
非ストリーミング音声（5,000 文字）はいPOST /v1/audio/speech
ストリーミング音声（20,000 文字）いいえ、REST を使用POST /v1/audio/stream
タイムスタンプ付きストリーミングいいえ、REST を使用POST /v1/audio/stream/with-timestamps
翻訳はい (speechdash_translate_document)POST /v1/documents/{document_id}/translate
ファイルエクスポートはい (speechdash_export_document)GET /v1/documents/{document_id}/export
アーカイブ / 復元はい (is_archived を speechdash_update_document で使用)PUT /v1/documents/{document_id}
ヘルスチェックいいえGET /health
OpenAPI JSONリソース speechdash://openapiGET /v1/openapi.json

請求

MCP の音声合成は REST とアプリ内のクラウド再生と同じ クレジットウォレット から請求されます。MCP を通じてドキュメントを作成してもクレジットは消費されませんが、アプリと REST API と同じように、1 日あたりのドキュメント上限にカウントされます。音声合成前に speechdash_get_account を呼び出してバランスを確認してください。

speechdash_translate_document は MP3 エクスポートと同じクレジットウォレットから請求されます（推定音声の開始 30 秒あたり 0.5 クレジット）。speechdash_export_document は大容量のファイルバイトを返すことがあります：MCP では txt、csv、または srt を優先してください。pdf と docx はバイナリです。speechdash_update_document は非公開共有ページの visibility とアーカイブまたは復元のための is_archived を受け入れます。

Cursor または Claude Desktop

ホストされた MCP サーバーに対して Streamable HTTP を使用し、個人用 API キーを使用してください。.cursor/mcp.json の例:

{
  "mcpServers": {
    "speechdash": {
      "url": "https://mcp.speechdash.com/mcp",
      "headers": {
        "Authorization": "Bearer sh_live_your_key_here"
      }
    }
  }
}

アプリ内の 設定 → API でキーを作成してください。

ローカル開発（リポジトリクローン）

Speechdash リポジトリのクローンから作業する場合:

export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcp

オプション: SPEECHDASH_API_BASE=http://localhost:3003/v1 を指定してローカル API に接続し、同時に bun dev:api を実行してください。

Streamable HTTP (ローカル)

ローカル開発中の HTTP MCP クライアント用:

export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcp:http

デフォルトのエンドポイント: http://127.0.0.1:3010/mcp

変数目的
SPEECHDASH_API_KEYstdio で必須；ローカル HTTP サーバーではクライアントが Authorization: Bearer を送信する場合はオプション
SPEECHDASH_API_BASEAPI ベース URL（デフォルト https://api.speechdash.com/v1）
MCP_TRANSPORTstdio（デフォルト）または http
MCP_HOSTHTTP バインディングホスト（デフォルト 127.0.0.1）
MCP_PORTHTTP ポート（デフォルト 3010）

エージェント向けドキュメント

AI クローラー向けの機械読み取り可能な製品コンテキスト:

Agents hub（ウェブサイト）

agents.md

OpenAPI JSON

GitHub 上のサンプル

関連項目

API 概要

API キーと MCP（ユーザーガイド）

クレジットウォレット

コネクタ（アプリ設定）

API の概要

自社のアプリケーションから Speechdash を呼び出し、認証に使用する API キーを作成します。

Account

Authenticated account and wallet.

On this page

開始する前にChatGPT (OAuth)ツールMCP と REST の機能比較請求Cursor または Claude Desktopローカル開発（リポジトリクローン）Streamable HTTP (ローカル)エージェント向けドキュメント関連項目