企业官网建设流程全解析

MCP 集成指南

2slides 提供了一个 MCP（模型上下文协议）服务器，用于与 Claude Desktop 和其他兼容 MCP 的 AI 代理无缝集成。

什么是 MCP 服务器？

2slides MCP 服务器通过标准化的工具接口暴露与直接 API 调用相同的功能，Claude 可以直接使用，无需执行脚本。

可用工具：

1. slides_generate- 从内容生成幻灯片
2. slides_create_like_this- 从参考图片生成幻灯片
3. slides_create_pdf_slides- 生成自定义设计的幻灯片（新增）
4. slides_generate_narration- 添加 AI 语音旁白（新增）
5. slides_download_pages_voices- 导出幻灯片和语音为 ZIP（新增）
6. themes_search- 搜索可用主题
7. jobs_get- 检查作业状态

注意：新工具（3-5）可能需要将 MCP 服务器更新到最新版本。

安装与配置

2slides MCP 服务器支持两种集成模式：

模式 1：流式 HTTP 协议（推荐）

最简单的设置，使用 HTTP 端点。无需本地安装。

步骤 1：从 https://2slides.com/api 获取你的 API 密钥

步骤 2：配置 Claude Desktop

编辑：~/Library/Application Support/Claude/claude_desktop_config.json（macOS）

{"mcpServers":{"2slides":{"url":"https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"}}}

步骤 3：完全重启 Claude Desktop

优势：

• ✅ 无需 Node.js 或 npm
• ✅ 始终使用最新版本
• ✅ 更快的设置
• ✅ 无本地依赖

模式 2：NPM 包（stdio）

使用本地 npm 包运行 MCP 服务器。

步骤 1：从 https://2slides.com/api 获取你的 API 密钥

步骤 2：配置 Claude Desktop

编辑：~/Library/Application Support/Claude/claude_desktop_config.json（macOS）

{"mcpServers":{"2slides":{"command":"npx","args":["2slides-mcp"],"env":{"API_KEY":"YOUR_2SLIDES_API_KEY"}}}}

步骤 3：完全重启 Claude Desktop

要求：

• 已安装 Node.js 和 npm
• 首次下载包需要互联网连接

验证安装

重启后，2slides 工具应可用。通过询问以下内容进行测试：
“使用 2slides 搜索商业主题”

何时使用 MCP vs 直接 API

使用 MCP 服务器：

• 在 Claude Desktop 或其他兼容 MCP 的环境中工作
• 想要无缝工具集成，无需管理脚本
• 希望 Claude 直接处理 API 调用
• 需要实时交互和反馈

使用直接 API 脚本：

• 在 Claude Code CLI 中工作
• MCP 服务器未配置或不可用
• 需要对参数和错误处理有更多控制
• 集成到自定义工作流或自动化中
• 需要批量处理多个请求

MCP 工具详情

slides_generate

从用户内容生成幻灯片。

参数：

• userInput（字符串，必需）：要转换的内容
• themeId（字符串，必需）：来自 themes_search 的主题 ID
• responseLanguage（字符串，可选，默认：“Auto”）：语言名称
• mode（字符串，可选，默认：“sync”）：“sync” 或 “async”

示例：

首先搜索主题： 使用 themes_search： - query: "business" 然后使用主题 ID 生成： 使用 slides_generate： - userInput: "Python 入门：变量、函数、类" - themeId: "theme_abc123" - mode: "sync"

slides_create_like_this

生成与参考图片匹配的幻灯片。

参数：

• userInput（字符串，必需）：幻灯片内容
• referenceImageUrl（字符串，必需）：参考图片的 URL 或 base64
• responseLanguage（字符串，可选，默认：“Auto”）：语言名称
• aspectRatio（字符串，可选，默认：“16:9”）：宽:高格式
• resolution（字符串，可选，默认：“2K”）：“1K”、“2K” 或 “4K”
• page（数字，可选，默认：1）：幻灯片数量（0 为自动检测，最大 100）
• contentDetail（字符串，可选，默认：“concise”）：“concise” 或 “standard”

示例：

使用 slides_create_like_this： - userInput: "2025 年 Q4 销售报告" - referenceImageUrl: "https://example.com/template.jpg" - resolution: "2K" - page: 0 # 自动检测幻灯片数量 - contentDetail: "standard"

themes_search

搜索可用主题。

参数：

• query（字符串，必需）：搜索关键词
• limit（数字，可选，默认：20，最大：100）：最大结果数

示例：

使用 themes_search： - query: "business" - limit: 10

注意：查询参数是必需的。使用关键词如 “business”、“professional”、“creative”、“education”、“modern” 搜索合适的主题。

slides_create_pdf_slides

从文本生成自定义设计的幻灯片，无需参考图片。

参数：

• userInput（字符串，必需）：幻灯片内容
• responseLanguage（字符串，可选，默认：“Auto”）：语言名称
• aspectRatio（字符串，可选，默认：“16:9”）：宽:高格式
• resolution（字符串，可选，默认：“2K”）：“1K”、“2K” 或 “4K”
• page（数字，可选，默认：1）：幻灯片数量（0 为自动检测，最大 100）
• contentDetail（字符串，可选，默认：“concise”）：“concise” 或 “standard”
• designSpec（字符串，可选）：设计规格

示例：

使用 slides_create_pdf_slides： - userInput: "2025 年 Q4 销售报告" - designSpec: "现代简约，蓝色配色方案" - resolution: "2K" - page: 0 # 自动检测幻灯片数量

slides_generate_narration

为已完成的幻灯片添加 AI 语音旁白。

参数：

• jobId（字符串，必需）：幻灯片生成的作业 ID（UUID 格式）
• language（字符串，可选，默认：“Auto”）：旁白语言
• voice（字符串，可选，默认：“Puck”）：语音名称（30 种选项可用）
• multiSpeaker（布尔值，可选，默认：false）：启用多说话人模式

可用语音：
Puck, Aoede, Charon, Kore, Fenrir, Phoebe, Asteria, Luna, Stella, Theia, Helios, Atlas, Clio, Melpomene, Calliope, Erato, Euterpe, Polyhymnia, Terpsichore, Thalia, Urania, Zeus, Hera, Poseidon, Athena, Apollo, Artemis, Ares, Aphrodite, Hephaestus

示例：

使用 slides_generate_narration： - jobId: "abc-123-def-456" - voice: "Aoede" - multiSpeaker: true - language: "English"

注意：作业必须已完成才能添加旁白。成本：每页 210 点数。

slides_download_pages_voices

将幻灯片下载为 PNG 图像，将语音文件下载为 WAV，打包为 ZIP 归档。

参数：

• jobId（字符串，必需）：幻灯片生成的作业 ID

示例：

使用 slides_download_pages_voices： - jobId: "abc-123-def-456"

注意：完全免费（不消耗点数）。下载 URL 有效期为 1 小时。

jobs_get

检查异步作业的状态。

参数：

• jobId（字符串，必需）：异步生成的作业 ID

响应包含：

• 幻灯片生成状态
• 旁白状态（如适用）
• 下载 URL（完成后）

示例：

使用 jobs_get： - jobId: "abc123..."

故障排除

工具未显示

1. 验证配置文件语法是否为有效的 JSON
2. HTTP 模式：检查 API 密钥是否正确在 URL 中
3. npm 模式：确保 API 密钥在env部分中正确设置
4. 完全重启 Claude Desktop（完全退出，不仅是关闭窗口）
5. 检查 Claude Desktop 控制台中的错误消息

API 密钥问题

• 在 https://2slides.com/api 验证 API 密钥是否有效
• 检查配置中是否有拼写错误
• 确保密钥周围没有多余的引号或空格
• HTTP 模式：API 密钥必须在 URL 查询参数中

HTTP 模式问题

• 验证 URL 格式：https://2slides.com/api/mcp?apikey=YOUR_KEY
• 检查互联网连接
• 确保 API 密钥没有需要 URL 编码的特殊字符

NPM 模式问题

• 确保npx可用（需要 Node.js）
• 尝试手动运行npx 2slides-mcp检查错误
• 验证包下载的互联网连接
• 检查 Node.js 版本兼容性

GitHub 仓库

更多信息，请访问：https://github.com/2slides/mcp-2slides