开始之前
您需要：- 一个 AhaSlides 账户（免费或付费）
- 一个支持自定义 MCP 连接器的 AI 助手：Claude、ChatGPT 或 Claude Code
设置：将 AhaSlides 添加到 Claude（无需代码）
对大多数人来说这是最简单的方式，只需点击几下，无需使用终端。1
打开连接器设置
点击您的个人资料，然后前往 Settings → Connectors。
2
添加自定义连接器
点击 Add custom connector，将
https://mcp.ahaslides.com/mcp 粘贴到 Remote server URL 字段中，然后点击 添加 (Add)。3
登录 AhaSlides
首次使用 AhaSlides 工具时，Claude 会打开一个浏览器窗口，供您使用 AhaSlides 账户（邮箱/密码、Google 或 Microsoft）登录。登录后即全部设置完成。
在 Claude 中添加连接器需要 Claude 付费方案。
设置：将 AhaSlides 添加到 ChatGPT（无需代码）
ChatGPT 也可以使用 AhaSlides，并且不需要付费的 ChatGPT 账户。1
开启开发者模式
点击您的个人资料，然后前往 Settings → Security and login 并开启 Developer mode，这样您就可以添加自定义连接。
2
浏览插件
打开 Plugins 标签页并选择 Browse plugin。
3
添加连接
点击加号 (+) 图标，将
https://mcp.ahaslides.com/mcp 粘贴到 Connection 字段中，然后点击 创建 (Create)。4
登录 AhaSlides
首次使用 AhaSlides 工具时，系统会要求您使用 AhaSlides 账户登录。登录后即全部设置完成。
设置：将 AhaSlides 添加到 Claude Code（面向开发者）
如果您使用 Claude Code（CLI、桌面应用，或 VS Code / JetBrains 扩展），可以直接添加该服务器。选项 1：通过 CLI 快速添加
在终端中运行以下命令：选项 2：手动配置
将以下内容添加到您的 Claude Code MCP 设置中（settings.json 或 .mcp.json）：登录 Claude Code
首次使用 AhaSlides 工具时，Claude Code 会打开一个浏览器窗口，供您使用 AhaSlides 账户（邮箱/密码、Google 或 Microsoft）登录。登录后即全部设置完成。您可以使用 AhaSlides MCP 做什么
连接后，只需描述您的需求即可。以下是 MCP 服务器支持的全部功能： 演示文稿 (Presentations)- 创建新的演示文稿
- 查看演示文稿的完整详情（幻灯片、主题、结构）
- 创建 17 种以上类型的幻灯片：测验、投票、词云、头脑风暴、内容幻灯片等
- 编辑幻灯片内容（标题、选项、答案、段落、图片）
- 配置幻灯片属性（计时器、计分、显示设置、图表类型）
- 在演示文稿内重新排列幻灯片
- 删除幻灯片
- 在实时演示期间跳过幻灯片（对观众隐藏而不删除）
- 浏览所有可用主题（官方、自定义和团队共享的主题）
- 将主题应用到任意演示文稿
- 查询您所有演示文稿的观众回应数据
- 分析特定演示文稿的会话数据（参与情况、测验分数、投票结果）
- 创建可固定、设为报告首页或通过链接分享的已保存报告，请参阅使用 AI 创建报告
- 使用内置的 recipe 并保存您自己的，请参阅内置 recipe 与您自己的 recipe
- 生成内嵌实时 AhaSlides 测验、投票和其他互动幻灯片的 PowerPoint (.pptx) 演示文稿，请参阅创建带有实时 AhaSlides 幻灯片的 PowerPoint 演示文稿
创建带有实时 AhaSlides 幻灯片的 PowerPoint 演示文稿
向您的 AI 助手索取一份带有互动幻灯片的 PowerPoint 演示文稿，它会交给您一个 .pptx 文件，其中内嵌实时的 AhaSlides 测验、投票、词云和其他互动幻灯片。当您在 PowerPoint 中演示时，这些幻灯片会实时运行：您的观众用手机加入并作出回应，就像在 AhaSlides 中一样。 在后台，助手会在您的 AhaSlides 账户中的新演示文稿里创建互动幻灯片，生成 PowerPoint 演示文稿，并通过 AhaSlides PowerPoint 加载项将每张互动幻灯片放入其中。您需要准备什么
- 已将 AhaSlides MCP 连接到您的 AI 助手。请参阅本页中针对 Claude、ChatGPT 或 Claude Code 的设置步骤。
- 一个能够创建文件并运行代码的 AI 助手，例如 Claude 或 Claude Code。.pptx 文件在助手一侧生成。
- 已安装 AhaSlides 加载项的 Windows 或 Mac 版 PowerPoint 桌面应用。请参阅设置加载项。
示例提示词
- “创建一份 PowerPoint 演示文稿，其中包含关于我们新产品系列的互动测验。”
- “为周一的团队会议制作一份 .pptx 演示文稿，包含一个实时投票和一个词云。”
- “为我的工作坊制作一份 PowerPoint，在各个主题之间穿插几道观众参与的问题。”
幻灯片在哪里实时运行
互动幻灯片只有在安装了 AhaSlides 加载项的 PowerPoint 桌面应用中才能实时运行。在其他任何地方，包括网页版 PowerPoint、导出或打印的 PDF，或没有安装加载项的计算机，每张互动幻灯片都会显示一张占位图片，而不是空白幻灯片。如果您把文件发给其他人来演示，他们需要在自己的 PowerPoint 中安装 AhaSlides 加载项，幻灯片才能实时运行。
内置 recipe 与您自己的 recipe
recipe 是一组已保存的指令，告诉您的 AI 助手如何构建某一类演示文稿、调查或课程。AhaSlides 自带内置 recipe，您也可以保存自己的 recipe。 要查看它们，请询问您的助手：“你有哪些 AhaSlides recipe？” 然后在您的请求中指明想用的那个，例如 “使用 Classroom lesson recipe，制作一节关于……的课程”
该列表还包括破冰、培训工作坊、全员大会问答、复盘、调查和职场课程的 recipe。有关可复制的课堂提示词，请参阅面向教师的 AhaSlides MCP。
保存您自己的 recipe
描述您希望如何构建演示文稿，然后请助手保存： “将此保存为名为 ‘My quiz style’ 的 AhaSlides recipe：四个答案选项，错误答案基于常见错误，每题 20 秒，每五道题后显示一次排行榜。” 下次，直接按名称调用即可。请注意以下几点：- 您最多可以保存 50 个自己的 recipe。
- recipe 标题最多 80 个字符，指令最多 4,000 个字符。
- 内置 recipe 无法编辑。要修改某个内置 recipe，请让助手将其另存为您自己的 recipe，然后编辑该副本。
- 您可以让助手更新或删除您保存的 recipe。
使用 AI 创建报告
向您的 AI 助手询问观众的结果，它会将自定义报告保存到 报告 (Reports) 页面的 My reports 中。有关如何创建、固定、分享和管理报告，请参阅使用 AI 创建报告。支持的幻灯片类型
示例 MCP 提示词
以下是一些入门的示例提示词：使用 MCP 获得最佳效果的提示
明确说明您想要什么：- 与其说“做一个测验”，不如试试“为新员工制作一个关于工作场所安全的 10 题多选测验，每题 4 个答案选项”
- “在我名为 ‘Sales Kickoff 2025’ 的演示文稿中添加一个投票”
- “为一次 15 分钟的产品培训创建大纲，然后在 AhaSlides 中制作出来”
- “从 Google Docs 读取我的会议议程，然后据此创建一个 AhaSlides 演示文稿”
- “向我展示在我上一次培训中哪些测验题的正确率最低”
AhaSlides MCP 故障排除
MCP 安全与隐私
- 无需管理 API 密钥，身份验证使用安全的 OAuth 2.0（与 Google、GitHub 等使用的标准相同）
- 您使用现有的 AhaSlides 账户登录，无需创建或保存额外的凭据
- AI 只能访问您账户中的演示文稿
- MCP 服务器只会执行您明确要求的操作
- 您可以随时在 AhaSlides 账户设置中撤销访问权限
- 您的登录会话会自动过期，需要时系统会提示您重新验证身份
常见问题
我在哪里可以找到我的 API 密钥？
我在哪里可以找到我的 API 密钥？
AhaSlides 没有公开的 REST API，因此没有可查找的 API 密钥。如果您希望 Claude 等 AI 助手使用您的 AhaSlides 账户，请改用 AhaSlides MCP，它通过您现有的 AhaSlides 账户登录进行连接，无需 API 密钥。请参阅上文的设置部分，将其添加到 Claude Code。