> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ahaslides.com/llms.txt
> Use this file to discover all available pages before exploring further.
# AhaSlides MCP — はじめてのガイド
> AhaSlides MCP サーバーを使うと、Claude や ChatGPT などの AI アシスタントが AhaSlides を操作して、プレゼンテーションや Quiz の作成、回答の分析を行えます。
AhaSlides を接続すると、AI アシスタントがスライドの作成と編集、制限時間やポイントの設定、プレゼンテーションへのテーマの適用を行えます。ライブの AhaSlides スライドを組み込んだ PowerPoint ファイルを作ることもできます。Model Context Protocol は、AI アシスタントを外部のツールやサービスにつなぐオープンな標準です。アプリを行き来する代わりに、必要なことを伝えるだけで、AI が AhaSlides 内で作業を進めます。Claude に AhaSlides アカウントの席を用意するようなものだと考えてください。
## 始める前に
必要なものは次のとおりです。
* AhaSlides アカウント（無料または有料）
* カスタム MCP コネクタに対応した AI アシスタント — Claude、ChatGPT、Claude Code
API キーは不要です。初めて接続するときに AhaSlides アカウントでサインインします。サーバーの URL はどこでも同じです。
```
https://mcp.ahaslides.com/mcp
```
## セットアップ：Claude に AhaSlides を追加する（コード不要）
ほとんどの方にとって最も簡単な方法です。数クリックで完了し、ターミナルは不要です。
プロフィールをクリックし、**Settings → Connectors** に移動します。
**Add custom connector** をクリックし、**Remote server URL** 欄に `https://mcp.ahaslides.com/mcp` を貼り付けて、**追加** (Add) をクリックします。
AhaSlides のツールを初めて使うとき、Claude がブラウザーウィンドウを開き、AhaSlides アカウント（メールアドレスとパスワード、Google、または Microsoft）でのサインインを求めます。サインインすれば準備完了です。
Claude でコネクタを追加するには、Claude の有料プランが必要です。
## セットアップ：ChatGPT に AhaSlides を追加する（コード不要）
ChatGPT でも AhaSlides を使えます。ChatGPT の有料アカウントは不要です。
プロフィールをクリックし、**Settings → Security and login** に移動して **Developer mode** をオンにします。これでカスタム接続を追加できるようになります。
**Plugins** タブを開き、**Browse plugin** を選びます。
プラス (**+**) アイコンをクリックし、**Connection** 欄に `https://mcp.ahaslides.com/mcp` を貼り付けて、**作成する** (Create) をクリックします。
AhaSlides のツールを初めて使うとき、AhaSlides アカウントでのサインインを求められます。サインインすれば準備完了です。
## セットアップ：Claude Code に AhaSlides を追加する（開発者向け）
Claude Code（CLI、デスクトップアプリ、または VS Code / JetBrains 拡張機能）を使っている場合は、サーバーを直接追加できます。
### オプション 1：CLI でクイック追加
ターミナルで次のコマンドを実行します。
```bash theme={null}
claude mcp add ahaslides --transport http https://mcp.ahaslides.com/mcp
```
### オプション 2：手動で設定
Claude Code の MCP 設定（settings.json または .mcp.json）に次の内容を追加します。
```json theme={null}
{
"mcpServers": {
"ahaslides": {
"type": "url",
"url": "https://mcp.ahaslides.com/mcp"
}
}
}
```
### Claude Code でサインインする
AhaSlides のツールを初めて使うとき、Claude Code がブラウザーウィンドウを開き、AhaSlides アカウント（メールアドレスとパスワード、Google、または Microsoft）でのサインインを求めます。サインインすれば準備完了です。
## AhaSlides MCP でできること
接続したら、必要なことを伝えるだけです。MCP サーバーが対応している内容は次のとおりです。
**プレゼンテーション** (Presentations)
* 新しいプレゼンテーションを作成する
* プレゼンテーションの詳細（スライド、テーマ、構成）をすべて表示する
**スライド** (Slides)
* Quiz、Poll、Word Cloud、Brainstorm、コンテンツスライドなど、17 種類以上のスライドを作成する
* スライドの内容（タイトル、選択肢、答え、段落、画像）を編集する
* スライドのプロパティ（タイマー、採点、表示設定、グラフの種類）を設定する
* プレゼンテーション内でスライドを並べ替える
* スライドを削除する
* ライブのプレゼン中にスライドをスキップする（削除せずに参加者から非表示にする）
**テーマ** (Themes)
* 利用可能なすべてのテーマ（公式、カスタム、チーム共有）を一覧表示する
* 任意のプレゼンテーションにテーマを適用する
**アナリティクス** (Analytics)
* すべてのプレゼンテーションにわたる参加者の回答データを照会する
* 特定のプレゼンテーションのセッションデータ（参加状況、Quiz のスコア、Poll の結果）を分析する
* ピン留め、レポートのホームへの設定、リンクでの共有ができる保存済みレポートを作成する。[AI でレポートを作成する](/jp/integrations/create-reports-with-ai)をご覧ください
**レシピ**
* 組み込みのレシピを使い、ご自身のレシピも保存する。[組み込みレシピとご自身のレシピ](#組み込みレシピとご自身のレシピ)をご覧ください
**PowerPoint ファイル**
* ライブの AhaSlides の Quiz、Poll、その他のインタラクティブなスライドを組み込んだ PowerPoint (.pptx) デッキを作成する。[ライブの AhaSlides スライド入りの PowerPoint デッキを作成する](#ライブの-ahaslides-スライド入りの-powerpoint-デッキを作成する)をご覧ください
## ライブの AhaSlides スライド入りの PowerPoint デッキを作成する
AI アシスタントにインタラクティブなスライド入りの PowerPoint プレゼンテーションを依頼すると、ライブの AhaSlides の Quiz、Poll、Word Cloud、その他のインタラクティブなスライドを組み込んだ 1 つの .pptx ファイルが作成されます。PowerPoint でプレゼンすると、それらのスライドがライブで動作します。参加者はスマートフォンで参加して回答でき、AhaSlides で実施する場合と同じ体験になります。
内部では、アシスタントがお使いの AhaSlides アカウントの新しいプレゼンテーションにインタラクティブなスライドを作成し、PowerPoint デッキを作成して、[AhaSlides PowerPoint アドイン](/jp/integrations/using-powerpoint-s-ahaslides-add-in)を通じて各インタラクティブスライドをデッキに配置します。
### 必要なもの
* AI アシスタントに接続した AhaSlides MCP。このページの Claude、ChatGPT、Claude Code のセットアップ手順をご覧ください。
* ファイルの作成とコードの実行ができる AI アシスタント（Claude や Claude Code など）。.pptx ファイルの作成はアシスタント側で行われます。
* AhaSlides アドインをインストールした、Windows または Mac 版の PowerPoint デスクトップアプリ。[アドインを設定する](/jp/integrations/using-powerpoint-s-ahaslides-add-in#アドインを設定する)をご覧ください。
### プロンプトの例
* *"新製品ラインについてのインタラクティブな Quiz を使った PowerPoint プレゼンテーションを作成して。"*
* *"月曜日のチームミーティング用に、ライブの Poll と Word Cloud を入れた .pptx デッキを作って。"*
* *"ワークショップ用に、トピックの合間に参加者への質問をいくつか入れた PowerPoint を作って。"*
### スライドがライブで動作する場所
インタラクティブなスライドがライブで動作するのは、AhaSlides アドインを入れた PowerPoint デスクトップアプリだけです。それ以外の場所、つまりウェブ版 PowerPoint、PDF のエクスポートや印刷物、アドインのないコンピューターでは、各スライドは空白ではなくプレースホルダー画像で表示されます。
ファイルを他の人に送ってプレゼンしてもらう場合、スライドをライブで動作させるには、その人の PowerPoint にも AhaSlides アドインをインストールしてもらう必要があります。
インタラクティブなスライドは AhaSlides アカウント内のプレゼンテーションとして保存されるため、そちらでいつもどおり編集できます。変更を PowerPoint に反映するには、アドインの **再読み込み** (Reload) を使います。[スライドを再読み込みする](/jp/integrations/using-powerpoint-s-ahaslides-add-in#スライドを再読み込みする)をご覧ください。
## 組み込みレシピとご自身のレシピ
レシピとは、特定の種類のプレゼンテーション、アンケート、コースをどのように作るかを AI アシスタントに伝える、保存済みの指示のセットです。AhaSlides には組み込みのレシピがあり、ご自身のレシピも保存できます。
一覧を見るには、アシスタントに *"AhaSlides のレシピにはどんなものがありますか？"* と尋ねます。その後、リクエストの中で使いたいレシピ名を指定します。たとえば *"Classroom lesson レシピを使って、…の授業を作成して"* のようにします。
| レシピ | 用途 |
| - | - |
| **Classroom lesson** | 導入、直接指導、理解度の確認、終了時のチケットで構成される学校の授業 |
| **Quiz game** | スコアとリーダーボードのある、ライブの対戦型 Quiz |
| **Secondary school course** | 11 歳から 18 歳くらいまでの生徒向けに、短いレッスンと頻繁な低リスクの確認を組み合わせたコース |
| **Bloom's taxonomy course** | 事実の記憶から、応用や評価へとレッスンが進んでいくコース |
この一覧には、アイスブレイク、研修ワークショップ、タウンホールの Q\&A、振り返り、アンケート、職場向けコースのレシピも含まれます。そのまま使える授業向けのプロンプトは、[教師向け AhaSlides MCP](/jp/integrations/ahaslides-mcp-for-teachers)をご覧ください。
### ご自身のレシピを保存する
プレゼンテーションをどのように作ってほしいかを説明してから、アシスタントに保存を依頼します。
*"これを「My quiz style」という名前の AhaSlides レシピとして保存して。選択肢は 4 つ、不正解の選択肢はよくある間違いに基づく、1 問あたり 20 秒、5 問ごとにリーダーボードを表示。"*
次回からは、名前を指定して呼び出せます。次の点にご注意ください。
* ご自身のレシピは最大 50 個まで保存できます。
* レシピのタイトルは 80 文字まで、指示は 4,000 文字まで入力できます。
* 組み込みのレシピは編集できません。変更するには、アシスタントにご自身のレシピとしてコピーを保存してもらい、そちらを編集します。
* 保存したレシピの更新や削除も、アシスタントに依頼できます。
## AI でレポートを作成する
AI アシスタントに参加者の結果について尋ねると、カスタムレポートが **レポート** (Reports) ページの **My reports** に保存されます。レポートの作成、ピン留め、共有、管理の方法は、[AI でレポートを作成する](/jp/integrations/create-reports-with-ai)をご覧ください。
## 対応しているスライドタイプ
| カテゴリー | スライドタイプ |
| - | - |
| **クイズ** (Quiz) | Pick Answer, Short Answer, Match Pairs, Correct Order, Categorise |
| **インタラクティブ** (Interactive) | Poll, Word Cloud, Brainstorm, Open Ended, Scale, Q\&A, Spinner Wheel |
| **コンテンツ** (Content) | Presentation Title, Content, Listing, Content with Image (left or right) |
| **Utility** | QR Code, Leaderboard |
## MCP のプロンプトの例
始めるためのプロンプトの例です。
| タスク | プロンプト |
| - | - |
| プレゼンテーションを作成する | *"「Q2 Team Update」という名前の新しい AhaSlides プレゼンテーションを、ウェルカムスライドとアジェンダ付きで作成して。"* |
| Poll や Quiz を追加する | *"私のプレゼンテーションに、「仕事で最も大きな課題は何ですか？」という 4 択の選択式の質問を追加して。"* |
| Quiz を作成する | *"チーム研修で使う、自社製品の機能についての 5 問のトリビア Quiz を作成して。"* |
| Word Cloud を追加する | *"参加者に「あなたにとって理想的なコラボレーションとはどのようなものですか？」と尋ねる Word Cloud スライドを追加して。"* |
| 既存のスライドを編集する | *"プレゼンテーションの 3 枚目のスライドのタイトルを「Quarterly Highlights」に更新して。"* |
| スライドを並べ替える | *"リーダーボードのスライドを、最後の Quiz の質問の直後に移動して。"* |
| 見た目を変える | *"利用可能なテーマをすべて表示して、ダークなテーマをプレゼンテーションに適用して。"* |
| 参加者の回答を分析する | *"「Sales Kickoff 2025」プレゼンテーションには何人が参加しましたか？Quiz のスコアの内訳を見せて。"* |
| レポートを作成する | *"今月、クラスが苦戦した Quiz の質問はどれですか？レポートとして保存して。"* |
| スライドをスキップする | *"ライブセッション中は Brainstorm スライドをスキップして。残しておきたいけれど、今日は表示したくないんだ。"* |
| 授業を計画する | *"水の循環についての 8 年生向けの 45 分の授業を、各パートの後に Quiz、最後に 3 問の終了時のチケットを付けて作成して。"* |
| PowerPoint デッキを作成する | *"営業研修用に、インタラクティブな Quiz とライブの Poll を入れた PowerPoint プレゼンテーションを作成して。"* |
## MCP で最良の結果を得るためのヒント
**希望を具体的に伝える：**
* 「Quiz を作って」ではなく、「新入社員向けに、職場の安全についての 10 問の選択式 Quiz を、各 4 択で作って」のように伝えます
**プレゼンテーションを名前で指定する：**
* 「「Sales Kickoff 2025」というプレゼンテーションに Poll を追加して」
**まず構成を依頼し、それから調整する：**
* 「15 分の製品研修の構成案を作って、それから AhaSlides で作成して」
**他のツールと組み合わせる：**
* 「Google Docs にある会議のアジェンダを読み取って、そこから AhaSlides プレゼンテーションを作って」
**分析を活用して改善する：**
* 「前回の研修で、正答率が最も低かった Quiz の質問を教えて」
## AhaSlides MCP のトラブルシューティング
| 問題 | 対処法 |
| - | - |
| **サインインのポップアップが表示されない** | Claude Code を再起動して、もう一度お試しください |
| **「Not authenticated」エラー** | セッションの有効期限が切れた可能性があります。Claude Code が再度サインインを促します |
| **「Connect your app」ページで接続を求められる** | ご利用中のアプリが AhaSlides アカウントへの接続を求めています。そのアプリに表示されているコードと一致することを確認し、**接続する** (Connect) を選択してください。コードには有効期限があるため、コードが無効または期限切れと表示された場合は、アプリからもう一度サインインをやり直してください。サインインを始めた覚えがない場合は、タブを閉じてください。 |
| **ツールが表示されない** | サーバーを追加した後、Claude Code を再起動してください |
| **「Presentation not found」** | 正しいプレゼンテーション名または ID を指定しているか確認してください |
| **応答が遅い** | スライドが多い大きなプレゼンテーションでは普通のことです。しばらくお待ちください |
## MCP のセキュリティとプライバシー
* 管理する API キーはありません。認証には、Google や GitHub などと同じ標準である安全な OAuth 2.0 を使用します
* 既存の AhaSlides アカウントでサインインします。新たな認証情報を作成・保存する必要はありません
* AI がアクセスできるのは、お使いのアカウント内のプレゼンテーションだけです
* MCP サーバーは、ユーザーが明示的に依頼した操作だけを実行します
* AhaSlides のアカウント設定から、いつでもアクセスを取り消せます
* サインインのセッションは自動的に期限切れになり、必要に応じて再認証を求められます
## よくある質問
AhaSlides には公開 REST API がないため、確認できる API キーはありません。Claude などの AI アシスタントでお使いの AhaSlides アカウントを操作したい場合は、代わりに AhaSlides MCP を使用してください。既存の AhaSlides アカウントのサインインで接続でき、API キーは不要です。Claude Code に追加する方法は、上の**セットアップ**のセクションをご覧ください。
**ご質問はありますか？**
サポートチームまでお問い合わせください。ログイン済みの場合はダッシュボード右下のチャットアイコンから、ログインしていない場合は[こちらからお問い合わせ](https://ahaslides.com/contact-us/)いただくか、[hi@ahaslides.com](mailto:hi@ahaslides.com) までメールをお送りください。
他のユーザーと交流したい方は、[AhaSlides コミュニティ](https://community.ahaslides.com/)に参加して、コツを共有したり、機能をリクエストしたり、他の人がどのように聴衆を巻き込んでいるかを確認しましょう。
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.