Hedy MCPサーバー：25個のツールとAPIアクセスの開発者ガイド

Hedy MCPサーバーの開発者ガイド

これは、最初のMCPリリース発表の技術的な補足資料です。ClaudeなどのMCP対応クライアントを、全25ツールを備えたAIミーティングアシスタントであるHedyを通じて、ミーティングデータに接続したい開発者向けに、ツールの全カタログ、認証モデル、ワークフローのパターンを説明します。

Hedyは、Model Context Protocol（MCP）を通じて、ClaudeなどのAIアシスタントと直接連携します。情報をアプリ間で手作業でコピーしなくても、AIツールがミーティングデータにアクセスし、整理し、活用できます。

具体的にできること

MCPサーバーは、Claude DesktopなどのAIアシスタントに、25個のツールを通じてHedyのデータへ直接アクセスする手段を与えます。次のようなことが可能になります。

セッション管理
AIアシスタントは、ミーティングの文字起こし、要約、インサイトを取得できます。Claudeに「先週のクライアントミーティングの予算の話を探して」と頼めば、該当するセッションを、文脈ごと正確に取り出します。

トピックの整理
プログラムからトピックを作成・管理できます。AIが関連するミーティングを自動的に整理し、連続した会話からナレッジベースを作り、複数のセッションにまたがるプロジェクトの進展を追跡できます。

ハイライトの取り込み
保存したハイライトを、AIによる分析付きで参照できます。講義のハイライトから学習ガイドを作成したり、ビジネスミーティングから意思決定のポイントをまとめたり、インタビューから重要な発言を抜き出したりできます。

タスクとの連携
ToDoの項目を、そのままワークフローに取り込めます。AIアシスタントは、プロジェクトをまたいでアクションアイテムを集約したり、期限を過ぎたタスクを見つけたり、複数のミーティングから統合したタスクリストを作成したりできます。

技術的な実装

MCPサーバーはhttps://api.hedy.bot/mcpで動作し（EUアカウントはhttps://eu-api.hedy.bot/mcp）、OAuth 2.1でサインインします。このサーバーにAPIキーはありません。セットアップは約2分で完了します。

1. AIクライアントのコネクタまたはMCPの設定に、サーバーのURLを追加します
2. 開いたブラウザウィンドウで、Hedyアカウントでサインインします
3. 権限を確認して、許可をクリックします
4. ミーティングについて、普段の言葉で質問を始めます

APIキーしか受け付けないクライアントや、ローカルサーバーしか実行できないクライアントは、オープンソースのmcp-remoteブリッジを使って接続できます。セットアップガイドで、クライアントごとの手順とあわせて説明しています。

この連携は、セッション単位のクエリ（「価格について何を話しましたか？」）と、セッションをまたぐ分析（「今月のクライアントミーティングのアクションアイテムをすべて見せて」）の両方に対応しています。

プライバシーのアーキテクチャ

データは、転送中も保存時も暗号化されます。アシスタントは、あなたが頼んだときにだけデータを読み取り、書き込みツールは、要約、ToDo、トピック、セッションコンテキスト、語彙といった整理のためのものに限られます。録音や文字起こしを削除できるツールはありません。

アクセスはアカウントに紐づいています。サインインで承認したクライアントだけがデータにアクセスでき、どのクライアントも、Hedyの設定から取り消せます。

利用できるツール

MCPサーバーは25個のツールを提供しています。14個はデータを読み取り、11個はデータを変更します。

セッション

• GetSessions：最近のセッションを新しい順に一覧表示します
• GetSessionDetails：1つのセッションの文字起こし、要約、メタデータを取得します
• GetSessionHighlights、GetSessionToDos：1つのセッションのハイライトとToDoを取得します
• UpdateSessionSummary：セッションの要約を置き換えます。たとえば、文字起こしが間違えた名前を直すときに使います

ハイライト

• GetHighlights、GetHighlightDetails：セッションをまたいで保存されたハイライトを、Hedyの分析付きで取得します

ToDo

• GetToDos：すべてのセッションのToDoを取得します
• UpdateToDoCompletion、UpdateToDoDueDate：ToDoのチェックや、期限の設定を行います

トピック

• GetAllTopics、GetTopicDetails、GetTopicSessions：トピックと、その中のセッションを閲覧します
• CreateTopic、UpdateTopic、DeleteTopic：トピックを管理します。ライブセッション中にHedyが使うトピックコンテキストも含みます（トピックを削除しても、セッションは残ります）
• AssignSessionToTopic：セッションをトピックに振り分けます

セッションコンテキスト

• ListSessionContexts、GetSessionContext：ライブ提案のためにHedyが使う、保存済みの背景情報を読み取ります
• CreateSessionContext、UpdateSessionContext、DeleteSessionContext：それを書き込んだり変更したりします。たとえば、明日の通話に向けたブリーフィングです

アカウントと語彙

• GetAccount：サインインしているアカウントを取得します
• GetVocabulary、SetVocabulary：Hedyが聞き取るカスタム用語を読み取る、または置き換えます

各ツールには、読み取り専用かどうか、データを上書きするかどうか、Hedyの外部に接続するかどうかをクライアントに伝えるMCPアノテーションが付いています。クライアントはこれを使って、何かを変更するツールを実行する前に、確認を求めることができます。

実際の活用例

リサーチ分析
研究者は、この連携を使って、連続講義にまたがる知見をまとめています。Claudeに「第4〜6週で議論された3つの理論的枠組みを比較して」と頼めば、複数のセッションから関連する内容を取り出し、概念を相互参照して、比較分析を生成します。

クライアント管理
コンサルタントは、クライアントごとの包括的な履歴を維持しています。AIは「明日の[クライアント]とのミーティングに向けて、第4四半期の戦略についてこれまでの議論をすべて見直して準備して」という依頼に応えて、関連する背景、未解決のコミットメント、話題の候補をまとめたブリーフィング資料を生成します。

ナレッジマネジメント
チームは、組織の知見を築いています。MCP連携により、AIアシスタントは、連続したミーティングから構造化されたドキュメントを作成し、振り返りからベストプラクティスを抽出し、設計の議論から技術仕様をまとめられます。

ワークフローの自動化
開発者は、Hedyのデータを独自のシステムに組み込んでいます。MCPアクセスにn8nやMake.comを組み合わせれば、ミーティングのインサイトをプロジェクト管理ツールに送ったり、CRMを更新したり、フォローアップのアクションを起動したりする自動ワークフローを構築できます。

要件と互換性

このサーバーは、OAuthサインインによるリモートサーバーに対応した、あらゆるMCPクライアントで動作します。動作確認済みのものは次のとおりです。

• Claude（Web、デスクトップ、Claude Code）
• ChatGPT
• Cursor、Windsurf、Zed、Cline
• 有料プランのPerplexity
• MCP SDKで構築したカスタムクライアント

MCPアクセスは、Hedy ProとHedy Teamに含まれており、サーバーがHedyのクラウドからセッションを読み取るため、クラウド同期をオンにする必要があります。クラウド同期がオフの場合、セッションは端末内にとどまり、どの連携からもアクセスできません。無料プランにはMCPは含まれません。

はじめに

セットアップガイドには、クライアントごとの手順、OAuth非対応のクライアント向けのmcp-remoteブリッジ、トラブルシューティングがあります。

AIアシスタントではなく、ご自身のコードから使う場合は、APIキーを使ったHedy APIと、セッションのイベントが発生するたびにシステムへプッシュするWebhookをご利用ください。

これで何が可能になるか

MCP連携は、プロフェッショナルがミーティングインテリジェンスを活用する方法を変えます。過去のセッションを手作業で検索したり、情報をドキュメントにコピーしたりする代わりに、AIアシスタントが面倒な作業を引き受け、関連する背景を見つけ、会話をまたいで情報を整理し、実行につながるインサイトを提示します。

プロの仕事は、ますます会話の中で進んでいくため、これは重要です。ミーティング、通話、議論の中で得られた知識は、組織にとって大きな知的資産です。MCP連携は、その知見を、分析、執筆、意思決定にすでに使っているAIツールから利用できるようにします。

組織にとっては、ミーティングデータが検索可能なナレッジベースになるということです。個人にとっては、Hedyで行ったすべての会話が、今の仕事を助けるために利用できるようになり、手作業での整理も不要になるということです。

技術的な基盤

このサーバーは、Streamable HTTP上でMCPを使って通信します。PKCEと動的クライアント登録を備えたOAuth 2.1を実装しているため、クライアントが自分で登録し、キーを貼り付ける必要はありません。ツールは、テキストとあわせて、それを読み取るクライアント向けに構造化された結果も返します。

今後の開発

ツールセットは、人々がアシスタントに頼みたいことに合わせて成長していきます。次に欲しいものは、機能リクエストボードでお知らせください。

サポート

セットアップガイドでは、各クライアントの設定、よくある設定の問題、プロンプトの例を説明しています。ご質問は、Hedy Slackコミュニティにご参加ください。

MCPアクセスは、Hedy ProとHedy Teamに含まれています。AIアシスタントにhttps://api.hedy.bot/mcpを追加し、Hedyアカウントでサインインして接続してください。

よくある質問

Hedy MCPサーバーは、いくつのツールを提供していますか？

セッション、ハイライト、ToDo、トピック、セッションコンテキスト、アカウント、カスタム語彙の7つのグループに、25個のツールがあります。そのうち14個はデータを読み取り、11個はデータを変更します。

Hedy MCPサーバーは、書き込み操作に対応していますか？

はい。AIアシスタントは、セッションの要約の書き換え、ToDoのチェックと期限の設定、トピックの作成・編集・削除、セッションのトピックへの振り分け、セッションコンテキストの管理、カスタム語彙の置き換えができます。録音や文字起こしを削除できるツールはありません。Webhookは、MCPではなくHedy APIで設定します。

Hedy MCPの認証はどのように行われますか？

Hedy MCPサーバーは、OAuth 2.1を使用します。AIクライアントがサインインと権限の確認のためにブラウザウィンドウを開き、承認するとアクセストークンが発行されます。ローテーションが必要な固定のAPIキーはありません。アクセスは、Hedyの設定からいつでも取り消せます。

Hedy MCPサーバーのURLは何ですか？

米国のアカウントはhttps://api.hedy.bot/mcpです。EUデータレジデンシーのアカウントはhttps://eu-api.hedy.bot/mcpを使います。このURLを、MCP対応のクライアント（Claude、ChatGPT、Cursor、Windsurf、Zed、Cline、Claude Code）に追加し、OAuthで認証します。

Hedy MCPサーバー、API、Webhookの違いは何ですか？

MCPサーバーはAIアシスタント向けで、OAuthでサインインし、会話中にツールを呼び出します。Hedy APIはご自身のコード向けで、APIキーを使います。Webhookは、セッションのイベントが発生するたびに、指定したエンドポイントにプッシュします。3つとも、クラウド同期をオンにした有料のHedyプランが必要です。