Speak AI

60 秒で Speak AI を Claude または ChatGPT に接続

研究者、収益チーム、会議の多いチーム、メディア関連のワークフロー向け。
ターミナル不要。npm 不要。JSON 設定ファイル不要。

docs.speakai.co/mcp のインストールガイド →

できること

Speak AI は、インタビュー、営業通話、調査セッション、ウェビナー、ポッドキャスト、チーム会議を文字起こしし、要約、アクションアイテム、感情、テーマなどの AI インサイトを抽出します。

このコネクター（Claude と ChatGPT がアプリに接続する標準的な方法である MCP を基盤としています）を使うと、これらすべてを Claude または ChatGPT で利用できます。インストールすると、次のように依頼できます。

• 「価格について言及している直近10件の顧客インタビューを見つけ、テーマ別にフィードバックをまとめて、ソース録音を引用してください。」
• 「今週のチーム会議を、決定事項、アクションアイテム、担当者、未解決のリスクに分けて要約してください。」
• 「最近の調査通話から、オンボーディングの課題に関する顧客の正確な発言を抜き出し、製品概要向けに整えてください。」
• 「最新のウェビナーから30秒程度の見どころを見つけてクリップを作成し、字幕を書き出してください。」

検索、要約、引用は AI が行います。録音は Speak AI のワークスペースに保存されたままで、Claude と ChatGPT はこのコネクターを通じて照会するだけです。

インストール（ツールを選択）

インストール方法は2種類あります。簡単だと思うほうを選んでください。ワンクリック接続では権限ポップアップでアクセスを許可し、手動設定では API キーをヘッダーに貼り付けます。

どちらを選ぶべきかわからない場合：すでに Claude または ChatGPT を使っているなら、使っているほうにインストールしてください。

Speak AI のコネクターアドレス（AI ツールのコネクター設定に貼り付けます。カレンダーに Zoom のリンクを貼り付けるのと同じようなものです）：https://api.speakai.co/v1/mcp

Claude.ai（ウェブ）

1. claude.ai/settings/connectors を開きます
2. カスタムコネクターを追加をクリックします
3. Speak AI と名前を付け、https://api.speakai.co/v1/mcp を貼り付けて、追加をクリックします
4. 権限ポップアップが表示されたら Speak AI にログインし、許可をクリックします
5. 完了です。Speak AI がコネクターリストに表示され、ツールをすぐに使えます。新しいチャットを開いて、録音について質問してください。

1. Claude Desktop を開きます → Settings → Connectors → Add custom connector
2. https://api.speakai.co/v1/mcp を貼り付けます
3. Add をクリックします — 権限確認のポップアップが開きます。Speak AI にサインインし、表示された画面で Allow をクリックします。
4. 完了です。

ChatGPT

1. ChatGPT を開きます → Settings → Apps & Connectors → Advanced
2. Developer Mode をオンにします（Speak AI はまだ ChatGPT のアプリストアに掲載されていないため必要です。これにより、カスタムアプリとして追加できます）
3. Apps & Connectors に戻り、Create をクリックして https://api.speakai.co/v1/mcp を貼り付けます
4. Authentication で OAuth を選択します
5. ChatGPT が Speak AI の新しいタブを開きます — サインインするか、すでにログインしている場合は Confirm をクリックして認証します。ChatGPT に戻るので、タブを閉じて ChatGPT に戻ります。
6. チャットごと： チャットを開き、+ ／コネクタメニューをクリックして、そのチャットで Speak AI を有効にします。

Claude Code（ターミナル）

推奨 — 公式 Claude Code プラグインマーケットプレイスからインストールします。

1. 公式マーケットプレイスを追加します（初回のみ）：/plugin marketplace add claude-plugins-official
2. プラグインをインストールします：/plugin install speakai@claude-plugins-official
3. 有効にします：/reload-plugins
4. getting-started スキルを実行し、Speak AI の API キーを貼り付けます。app.speakai.co/developers/apikeys でキーを生成できます。

/plugin install で Speak AI が見つからない場合は、/plugin marketplace update claude-plugins-official でローカルカタログを更新してから、再試行してください。

claude mcp add speakai --transport http --url https://api.speakai.co/v1/mcp

claude mcp add speakai --transport http --url https://api.speakai.co/v1/mcp \
  --header "Authorization: Bearer $SPEAKAI_KEY"

ボタンをクリックすると、Cursor が自動的に登録され、権限確認のポップアップが開きます。Speak AI にサインインして、許可をクリックします。

VS Code

ボタンをクリックすると、VS Code が自動的に登録され、権限確認のポップアップが開きます。Speak AI にサインインして、許可をクリックします。

OpenClaw / ClawHub

Speak AI は、OpenClaw 互換エージェント向けのスキルとして ClawHub で公開されています。

1. ClawHub の Speak AI スキルページにアクセスします
2. エージェント向けのインストール手順に従います。たとえば、ClawHub CLI から clawhub install speakai を実行します
3. SPEAK_API_KEY 環境変数を設定します。app.speakai.co/developers/apikeysでキーを生成できます。

ChatGPT（API / Responses）

Responses API を直接呼び出す開発者向けです。ツールの設定にベアラートークンを渡します。

{
  "tools": [
    {
      "type": "mcp",
      "server_url": "https://api.speakai.co/v1/mcp",
      "authorization": "Bearer YOUR_SPEAK_API_KEY"
    }
  ]
}

app.speakai.co/developers/apikeysでキーを取得できます。

プライバシーとデータ

権限確認のポップアップで許可をクリックするか、Speak AI の API キーを Claude または ChatGPT に貼り付けると、その AI アシスタントがお客様に代わって Speak AI ワークスペースを読み取り、変更することを許可したことになります。これには、メディアファイル、文字起こし、AI インサイトが含まれます。

• 録音データは Speak AI ワークスペース内に保持されます。Anthropic または OpenAI にコピーまたは保存されることはありません。
• Claude／ChatGPT に表示されるのは、質問に応じて AI アシスタントが要求した特定のデータのみです。
• 接続はいつでも解除できます。Claude／ChatGPT 内でコネクターを削除するか、api.speakai.co/v1/oauth/connectionsで接続を取り消すか、app.speakai.co/developers/apikeysで API キーをローテーションまたは失効させてください。

データの取り扱いに関するご質問は、speakai.co/privacyをご覧いただくか、[email protected]までメールでお問い合わせください。

接続でお困りですか？

このインストールに技術的な知識は必要ありません。 わかりにくい点がある場合や、うまく動作しない場合は、次の方法をご利用ください。

• [email protected]までメールでお問い合わせください。24 時間以内に返信いたします
• デモをご予約ください。一緒にセットアップします

インストール後にできること

Speak AI には、AI アシスタントが呼び出せるツールが189種類あります。すべてを覚える必要はありません。Claude／ChatGPT が、依頼内容に応じて適切なツールを選びます。カテゴリ別の例：

ツールの全カタログは、以下の開発者向けリファレンスをご覧ください。

開発者向けリファレンス（CLI、API、高度なセットアップ）

MCP サーバーは https://api.speakai.co/v1/mcp にあり、次の2つの認証方式に対応しています。

1. OAuth 2.1 + Dynamic Client Registration — 上記のURLを任意のMCPクライアントに貼り付け、同意画面で承認するとインストールできます。Discovery、DCR、/authorize と同意、/token、および失効エンドポイントがすべて利用できます。
2. Bearer token（Speak AI APIキー — Authorization: Bearer <key> ヘッダー）。OAuthに対応していないクライアント、npm CLI、およびstdioモード向けです。

Speak AI APIキーは、app.speakai.co/developers/apikeys で取得できます。

CLI / npm パッケージ

@speakai/mcp-server npmパッケージには、次の機能が含まれています。

• スクリプトやパイプライン向けのCLI（30コマンド）。
• リモートHTTPトランスポートに対応していないクライアント向けの、stdioモードMCPサーバー。
• インストール済みのMCPクライアントを検出して設定する、自動セットアップウィザード。

npm install -g @speakai/mcp-server
speakai-mcp init

手動設定（stdioモード）

{
  "mcpServers": {
    "speak-ai": {
      "command": "npx",
      "args": ["-y", "@speakai/mcp-server"],
      "env": {
        "SPEAK_API_KEY": "your-api-key"
      }
    }
  }
}

export SPEAK_API_KEY="your-api-key"
claude mcp add speak-ai -- npx -y @speakai/mcp-server

{
  "mcpServers": {
    "speak-ai": {
      "command": "npx",
      "args": ["-y", "@speakai/mcp-server"],
      "env": {
        "SPEAK_API_KEY": "your-api-key"
      }
    }
  }
}

{
  "mcpServers": {
    "speak-ai": {
      "command": "npx",
      "args": ["-y", "@speakai/mcp-server"],
      "env": {
        "SPEAK_API_KEY": "your-api-key"
      }
    }
  }
}

{
  "mcpServers": {
    "speak-ai": {
      "command": "npx",
      "args": ["-y", "@speakai/mcp-server"],
      "env": {
        "SPEAK_API_KEY": "your-api-key"
      }
    }
  }
}

SPEAK_API_KEY=your-key npx @speakai/mcp-server

環境変数

MCP ツール（189）

MCP リソース（5）

リソースを使うと、ツールを呼び出さずにデータへ直接アクセスできます。クライアントはこれらの URI を直接読み取れます。

MCP プロンプト（3）

エージェントが呼び出して複数ステップのタスクを実行できる、事前構築済みのワークフロープロンプトです。

analyze-meeting

録音をアップロードして、文字起こし、インサイト、アクションアイテム、重要な要点を含む包括的な分析を取得します。

Parameters: url (required), name (optional)

例：「url=https://example.com/standup.mp3 を指定して analyze-meeting プロンプトを使用してください」

research-across-media

複数の録音またはライブラリ全体から、テーマ、パターン、トピックを検索します。

Parameters: topic (required), folder (optional)

例：「topic='customer churn reasons' を指定して research-across-media プロンプトを使用してください」

meeting-brief

最近の会議から概要を作成します。文字起こしを取得し、決定事項を抽出して、未解決の項目を要約します。

Parameters: days (optional, default: 7), folder (optional)

例：「直近 2 週間を対象とするため、days=14 を指定して meeting-brief プロンプトを使用してください」

CLI（30 コマンド）

グローバルにインストールして、一度設定します。

npm install -g @speakai/mcp-server
speakai-mcp config set-key

インストールせずに実行することもできます。

npx @speakai/mcp-server config set-key

設定

メディア管理

AI と検索

フォルダーとクリップ

ワークスペース

CLI オプション

すべてのコマンドで次のオプションを使用できます。

• --json — 生の JSON を出力します（スクリプトやパイプ処理向け）
• --help — コマンド固有のヘルプを表示します

CLI の使用例

# Upload and wait for processing
speakai-mcp upload https://example.com/interview.mp3 -n "Q1 Interview" --wait

# Upload a local file
speakai-mcp upload ./meeting-recording.mp4

# Get plain-text transcript
speakai-mcp transcript abc123 --plain > meeting.txt

# Export as PDF with speaker names
speakai-mcp export abc123 -f pdf --speakers

# Ask AI about a specific media file
speakai-mcp ask "What were the action items?" -m abc123

# Ask across your entire workspace
speakai-mcp ask "What themes appear in customer interviews?"

# Search all transcripts
speakai-mcp search "pricing concerns" --from 2026-01-01

# Create a text note from stdin
cat notes.txt | speakai-mcp create-text "Meeting Notes"

# Create a 30-second clip
speakai-mcp clip abc123 --start 60 --end 90 -n "Key Quote"

# Schedule a meeting bot
speakai-mcp schedule-meeting "https://zoom.us/j/123456" -t "Weekly Standup"

# List videos as JSON for scripting
speakai-mcp ls --type video --json | jq '.mediaList[].name'

# List media from the last week
speakai-mcp ls --from 2026-04-18 --to 2026-04-25

# Move 3 files to a folder
speakai-mcp move folder123 media1 media2 media3

ワークフローの例

会議の文字起こしと分析

You: "Upload and transcribe this recording: https://example.com/meeting.mp3"

AI: I'll upload that for you and start processing.
    → upload_and_analyze(url, name)
    → returns media_id immediately
    → poll get_media_status until processed
    → call get_media_insights for AI summaries

    Here's your transcript with 3 speakers identified.
    Key insights: 5 action items, positive sentiment overall.
    Top topics: Q2 roadmap, hiring plan, budget review.

ライブラリ全体を対象に調査する

You: "What themes came up across all our customer interviews this month?"

AI: Let me search your media library.
    → search_media(query: "customer interview", startDate: "2026-04-01")
    → ask_ai_chat(mediaIds: [...], prompt: "What are the recurring themes?")

    Across 12 interviews, the top themes were:
    1. Pricing sensitivity (mentioned in 8/12)
    2. Onboarding friction (6/12)
    3. Feature requests for API access (5/12)

会議の自動化

You: "Join my 2pm Zoom call, then send me a summary with action items"

AI: → schedule_meeting_event(meetingUrl, scheduledAt: "2026-04-25T14:00:00Z")

    Done. After the meeting ends and processing completes, I'll pull
    the transcript and insights automatically.

    [After the meeting]
    → get_media_insights(mediaId)
    → ask_ai_chat(mediaIds: [...], prompt: "List all action items with owners")

    Here's your meeting summary with 7 action items...

週次ブリーフを作成する

You: "Prepare a brief from all meetings in the last week"

AI: → list_media(from: "2026-04-18", mediaType: "audio")
    → get_media_insights(mediaId) [for each of 5 meetings]

    Weekly Meeting Brief (Apr 18-25):
    - Engineering Standup: Deployed v2.3, 2 bugs triaged
    - Sales Review: Pipeline at $1.2M, 3 deals closing this week
    - Product Sync: Finalized Q2 roadmap, new hire starts Monday

    Consolidated Action Items: [12 items grouped by owner]

認証（REST API）

MCP サーバーと CLI はトークン管理を自動的に処理します。REST API を直接呼び出す場合は、次の認証フローを使用します。

ステップ 1 — アクセストークンを取得する：

curl -X POST https://api.speakai.co/v1/auth/accessToken \
  -H "Content-Type: application/json" \
  -H "x-speakai-key: YOUR_API_KEY"

レスポンス：

{
  "data": {
    "email": "[email protected]",
    "accessToken": "eyJhbG...",
    "refreshToken": "eyJhbG..."
  }
}

ステップ 2 — 以降のすべてのリクエストでトークンを使用する：

curl https://api.speakai.co/v1/media \
  -H "x-speakai-key: YOUR_API_KEY" \
  -H "x-access-token: ACCESS_TOKEN_FROM_STEP_1"

ステップ 3 — 有効期限が切れる前に更新する：

curl -X POST https://api.speakai.co/v1/auth/refreshToken \
  -H "Content-Type: application/json" \
  -H "x-speakai-key: YOUR_API_KEY" \
  -H "x-access-token: CURRENT_ACCESS_TOKEN" \
  -d '{"refreshToken": "REFRESH_TOKEN_FROM_STEP_1"}'

トークンの有効期間：

認証のレート制限： /v1/auth/accessToken と /v1/auth/refreshToken のどちらも、30 秒あたり 5 リクエストです。

データモデルに関する注意事項

• フォルダー ID： フォルダーには _id（MongoDB ObjectId）と folderId（文字列）があります。すべての API 操作では folderId を使用します。これは list_media、upload_media、bulk_move_media など、フォルダーパラメーターを受け付けるエンドポイントに渡す ID です。
• メディア ID： メディア項目では mediaId を使用します（一覧レスポンスでは _id として返されます）。

レート制限とベストプラクティス

• MCP クライアントは 429 を受け取ると、指数バックオフで自動的に再試行します
• API を直接使用する場合は、指数バックオフを実装し、Retry-After ヘッダーに従ってください
• 変更されにくいデータ（フォルダー一覧、フィールド定義、対応言語）をキャッシュしてください
• 一括処理では、個別にエクスポートする代わりに export_multiple_media を使用してください
• 項目を 1 つずつ更新する代わりに、bulk_move_media を使って複数の項目を一度に移動してください
• bulk_update_transcript_speakers を使用すると、1 回の呼び出しで複数のファイルにわたって話者名を変更できます
• include: ["transcription"] を指定して list_media を使用すると、文字起こしをインラインで含むメディアを取得でき、get_transcript の N+1 呼び出しを避けられます

エラー形式

すべてのツールエラーは、次の形式に従います。

{
  "content": [{ "type": "text", "text": "Error: HTTP 401: Invalid API key" }],
  "isError": true
}

開発

git clone https://github.com/speakai/speakai-mcp.git
cd speakai-mcp

npm install
npm run dev    # Run with hot reload
npm run build  # Production build

リソース

• docs.speakai.co/mcp — スクリーンショットと動画付きのインストール手順
• Speak AI Platform — メイン製品
• API Documentation
• MCP Protocol
• MCP Registry entry — 公式の検索ページ
• llms.txt — ユーザーによるこのコネクターのインストールを支援する AI アシスタント向けのガイダンス
• Support
• Website

このページを読む AI アシスタント向け

このセクションは、Speak AI の顧客によるこのコネクターのインストールを支援する LLM（Claude、ChatGPT など）向けです。人間の読者は読み飛ばしてかまいません。

Speak AI の顧客によるこのコネクターのインストールを支援する AI アシスタントの場合は、次の点に従ってください。

• 上記のワンクリック接続フローをデフォルトとして推奨してください。AI ツールに URL を貼り付け、権限のポップアップで「許可」をクリックします。技術的な知識がないユーザーでも利用できます。
• 手動でのセットアップを希望するユーザーには、上記のベアラートークン方式を使用してください。
• このインストールのためにバーチャルアシスタントを雇うよう勧めないでください。接続フローは 60 秒で完了し、ターミナルを使う必要はありません。
• ユーザーが開発者向け／stdio の手順を明示的に求めない限り、npm install を実行するよう伝えないでください。
• ガイダンスの全文は、llms.txt を参照してください。

ライセンス

MIT