GenPPT

GenPPT MCP 服务：AI 幻灯片、路演演示文稿与 PowerPoint（.pptx）导出

只需提供提示词、大纲、笔记或网站 URL，即可生成可直接用于演示的幻灯片、投资人路演演示文稿、咨询幻灯片和高管简报，并可直接通过 Claude Code、Cursor、Claude Desktop、VS Code 和 Codex 将成品导出为原生 PowerPoint（.pptx）、PDF 或高分辨率幻灯片图像。

claude mcp add --transport http genppt https://genppt.com/mcp --header "Authorization: Bearer gppt_YOUR_KEY"

此代码仓库包含适用于托管式 GenPPT Streamable HTTP MCP 服务的配置清单、插件定义和 Agent 技能，该服务位于 https://genppt.com/mcp。

获取 MCP 密钥

1. 在 genppt.com/app/account 登录或创建免费账户。
2. 在 MCP key 部分，点击 Create key 以生成 gppt_... Bearer 令牌。
3. 复制令牌，并通过 Authorization: Bearer gppt_YOUR_KEY 请求头传递。

你也可以不使用密钥直接连接 https://genppt.com/mcp，查看工具定义，或获取任意演示文稿提示词对应的浏览器直接跳转链接（handoffUrl）。

设置说明

Claude Code

claude mcp add --transport http genppt https://genppt.com/mcp --header "Authorization: Bearer gppt_YOUR_KEY"

在 Claude Code 中运行 /mcp，确认 genppt 已连接且其 8 个工具可用。

Cursor

将以下内容添加到 ~/.cursor/mcp.json（全局配置）或项目中的 .cursor/mcp.json：

{
  "mcpServers": {
    "genppt": {
      "url": "https://genppt.com/mcp",
      "headers": {
        "Authorization": "Bearer gppt_YOUR_KEY"
      }
    }
  }
}

Claude Desktop 和 claude.ai

在 Claude Desktop 或 claude.ai 中，打开 Customize → Connectors → + Add → Add custom connector：

• Name： GenPPT
• URL： https://genppt.com/mcp

或者在 claude_desktop_config.json / .mcp.json 中添加：

{
  "mcpServers": {
    "genppt": {
      "type": "http",
      "url": "https://genppt.com/mcp",
      "headers": {
        "Authorization": "Bearer gppt_YOUR_KEY"
      }
    }
  }
}

VS Code

将以下内容添加到 .vscode/mcp.json（VS Code 使用 servers）：

{
  "servers": {
    "genppt": {
      "type": "http",
      "url": "https://genppt.com/mcp",
      "headers": {
        "Authorization": "Bearer gppt_YOUR_KEY"
      }
    }
  }
}

OpenAI Codex CLI

将以下内容添加到 ~/.codex/config.toml：

[mcp_servers.genppt]
url = "https://genppt.com/mcp"
http_headers = { "Authorization" = "Bearer gppt_YOUR_KEY" }

安装 Agent 技能

为 Claude Code、Cursor 或任何兼容技能的编码 Agent 安装 GenPPT Agent 工作流技能：

npx skills add Illyism/genppt-mcp

也可以通过 Claude Code 插件市场安装：

claude plugin marketplace add Illyism/genppt-mcp
claude plugin install genppt@genppt-mcp

演示文稿生成流程

1. 创建演示文稿（genppt_create_deck）： 提供 prompt（主题、大纲、初步笔记或粘贴的文档）、可选的 aspectRatio（16:9、9:16、4:5、1:1）、可选的 websiteUrl（让演示文稿以实时网站内容为依据），以及可选的 attachmentUrls（图像、PDF 或 YouTube URL）。
2. 查看概念预览（genppt_get_deck）： 每隔 30–60 秒轮询一次，直到 phase 为 concepts_ready。服务会返回 conceptPreviewUrl，供聊天客户端在对话中直接渲染概念图。
3. 渲染完整幻灯片（genppt_generate_slides）： 概念获得认可后，启动完整幻灯片渲染（1–3 分钟），并轮询 genppt_get_deck，直到 phase 为 ready。
4. 导出（genppt_export_deck）： 将成品演示文稿导出为 pptx（PowerPoint）、pdf（PDF）或 images（包含幻灯片图像的 ZIP 文件），并获取直接下载链接 downloadUrl。

工具

工具	只读	描述
genppt_account_status	是	显示已连接的 GenPPT 账户：当前套餐级别、本期已使用的演示文稿数量、已保存的付款方式和升级选项。
genppt_list_decks	是	列出用户的 GenPPT 演示文稿（按最近编辑时间从新到旧排序），可选参数 limit（1–100）和标题 search。
genppt_get_deck	是	获取演示文稿当前的 phase（drafting_concepts、concepts_ready、rendering_slides、ready、error）、概念预览图、幻灯片列表、行内幻灯片图片 URL 和 studioUrl。
genppt_create_deck	否	根据 prompt 创建新的 AI 演示文稿，可选参数包括 aspectRatio（16:9、9:16、4:5、1:1）、websiteUrl、attachmentUrls 和 webSearchEnabled。
genppt_generate_slides	否	当 genppt_get_deck 到达 concepts_ready 阶段后，渲染所有幻灯片（相当于在 GenPPT Studio 中点击 Generate）。
genppt_export_deck	否	将已就绪的演示文稿导出为 pptx（PowerPoint）、pdf（PDF）或 images（包含 PNG 幻灯片的 ZIP），并返回 downloadUrl。
genppt_upgrade_plan	是	预览 GenPPT 套餐（growth_monthly、growth_yearly、max_yearly）的价格。不会扣款；当 confirmPaymentSpend: true 时返回浏览器 checkoutUrl。
genppt_submit_feedback	否	向 GenPPT 团队发送 Bug 报告、功能请求或问题（bug、missing_feature、question、other）。

链接

• 网站： https://genppt.com
• MCP 端点： https://genppt.com/mcp
• MCP 发现清单： https://genppt.com/.well-known/mcp
• MCP 服务卡片： https://genppt.com/.well-known/mcp/server-card.json
• 技能指南： https://genppt.com/SKILL.md
• 账户与 MCP 密钥： https://genppt.com/app/account
• 支持： https://genppt.com/contact
• 隐私政策： https://genppt.com/blog/privacy-policy
• 服务条款： https://genppt.com/blog/terms-of-service