被迫做 PPT 的工程师
你平时活在终端里，架构评审排在周四，而画方框不是你想用来过周三晚上的方式。在对话里把幻灯片描出来很快，难的是让它变成同事真的能接着改的东西。
Codex 里画的幻灯片，直接转成能改的 PPT
Codex 刚给你的那张幻灯片，本质上是一张图。它看着像模像样——标题、要点、一张整齐的表格——但这些全是刷在画布上的颜色。标题里有个错字点不进去，框拖不动，表格里的数字改不了。常规做法是把图存下来、打开浏览器、传到某个网站、下载结果、再拿回来。这个插件把这一趟来回省掉：图片从对话里直接过去，可编辑的 PPT 以下载链接的形式回到同一个任务里。
什么人会需要它
要跟人来回改稿的人
第二版永远要动一个数字、翻译一个标签、换一个 logo。幻灯片要是一张平图，每一处小改都得整张重画一遍——顺带把本来已经对的地方也弄丢。
要把稿子交出去的人
图片做的 PPT 交出去，就变成了接手人的麻烦：他打开、想改个日期、发现没东西可点。交出真正的文本框和形状，他才能自己收尾，不用再回头找你。
怎么装上
Image2PPT 对外只有一个地址，三种客户端都连它：
https://image2ppt.com/mcp
它是一个 Streamable HTTP 的 MCP 服务，用 OAuth 授权。也就是说：没有 API key 要复制，没有 token 要粘贴，没有配置文件非改不可。你要做的是把上面这个地址填进客户端，然后在浏览器里登录一次自己的 Image2PPT 账号并点同意。
下面三条路互相独立，选一条走完就行，不用三条都做。但今天能走完授权的只有 ②——① 和 ③ 用的本机回调还没上线，详见各自那一节：
① Codex App（推荐）
在 Codex 桌面应用里点几下菜单就装好。绝大多数人走这条。本机授权尚未上线，动手前先看那一节顶部的提示。
② ChatGPT 开发者模式
你在 chatgpt.com 网页里用，而不是在 Codex App 里用。这是另一套设置，跟上面那条不通用。不受本机授权那件事影响，现在就能用。
③ Codex CLI（可选）
命令行用户的等价做法。不是必须的——用 App 的人不需要碰终端。授权环节与 ① 相同，同样要等上线。
① Codex App（推荐）
在 Codex 应用里设置动手之前先看一眼：本机授权尚未上线
Codex App 和 CLI 都靠一个本机回调地址接收授权结果。服务端对这种回调的支持代码已经写好，但还没有部署到线上——所以在部署之前，下面第 9 步的 Authenticate 一定走不完，浏览器会报 invalid_redirect_uri。这不是概率问题，也不是你哪里填错了：现在线上的服务端会拒绝每一个本机回调。
在那之前，请走 ② ChatGPT 开发者模式——那条路用的是 HTTPS 回调，不经过本机回调，现在就能用。下面的步骤本身是对的，部署之后照着走即可；这段提示届时会撤掉。
- 打开 Codex App。
- 进入 Settings → MCP servers。
- 点击 Add server。
- Name 填
image2ppt。 - Type 选择 Streamable HTTP。（有的版本写作 HTTP / Streamable HTTP；不要选 stdio 或 SSE。）
- URL 填
https://image2ppt.com/mcp。 - 点击 Save。
- 重启 Codex App。这一步经常被跳过，但新加的服务往往要重启之后才真正加载。
- 回到 MCP servers，在 image2ppt 这一条上点击 Authenticate。
- 浏览器会打开 image2ppt.com。用你平时那套方式登录——Google 或邮箱验证码——然后批准授权。没有账号的话，这一步会顺带建一个，新用户的免费试用积分照给。
- 回到 Codex，新建一个 task，输入
/mcp，确认 image2ppt 已连接。 - 上传图片后，可以输入：
使用 Image2PPT 把这张图片转换成可编辑 PPTX。
如果第 9 步点完 Authenticate 之后浏览器报 redirect_uri 相关的错误，看下面排查那一节的最后一条。
② ChatGPT 开发者模式
在 chatgpt.com 网页里设置这条路是给「我在 ChatGPT 网页里用，不在 Codex App 里用」的人准备的。它和上面那条是两套彼此独立的设置：在 Codex App 里加过一遍，ChatGPT 网页里不会自动出现，反过来也一样。
- 在 ChatGPT 的设置里打开 开发者模式（Developer mode）。它属于实验功能，位置和可用性由 OpenAI 决定，不同账号类型可能不一样。
- 新建一个 connector，把服务地址填成
https://image2ppt.com/mcp。 - 保存后按提示完成授权：同样是在浏览器里登录 Image2PPT 并点同意。
- 在对话里确认 image2ppt 已连接，然后照常说「把这张图转成可编辑 PPT」。
开发者模式的入口和字样由 OpenAI 那边控制，我们无法保证它在你的账号里叫什么名字、在哪一级菜单下，不同账号类型也可能根本没有。如果你的账号里找不到，请写信到 support@image2ppt.com，我们会告诉你本机授权上线的进度——在那之前 ① 和 ③ 走不完授权，不要拿它们当替代方案。
③ Codex CLI（可选）
给愿意用终端的人这一节是可选的。如果你已经在 Codex App 里装好了，就不用再做一遍；命令行只是同一件事的另一种做法，不是必经步骤。
同样卡在本机授权那件事上：codex mcp login 走的也是本机回调，所以在那项上线之前它同样走不完，原因和处理办法与 ① Codex App 顶部那段提示一样。
codex mcp add image2ppt --url https://image2ppt.com/mcp
codex mcp login image2ppt
codex mcp list
codex mcp add：把服务地址登记进你的 Codex 配置。codex mcp login：打开浏览器完成 OAuth 授权，跟 App 里那个 Authenticate 按钮是同一件事。codex mcp list：列出已登记的服务和它们的连接状态，用来确认这一条真的接上了。
命令行参数由 Codex CLI 自己定义，可能随版本变化。codex mcp --help 打出来的永远是你这一版的准确写法。
以后：从插件目录直接装
尚未上架Codex 有一个官方插件目录，上架之后按名字搜索就能装，不用手填地址。Image2PPT 目前还没有上架——我们正在按官方要求准备提交材料，还没有提交、也没有通过审核。
所以这条路现在还走不通，写在这里只是说明以后会有。今天要用，请走上面的 ② ChatGPT 开发者模式——① 和 ③ 的本机授权还在等上线。真正上架之后，我们会在产品更新里说明。
用之前请知道：文件会上云处理
这不是一个本地转换工具
你交给插件的图片会上传到 Image2PPT 的云端服务器处理，不是在你自己电脑上转换的。这一点值得在装之前想清楚，尤其当图片里有不该外传的内容时。
另一个方向的事实：Image2PPT 拿不到你的 OpenAI / ChatGPT 身份。连接用的是标准 OAuth——你在浏览器里登录自己的 Image2PPT 账号并点同意，我们只知道这个账号。这份授权只能转换幻灯片和查看这些转换的结果，随时可以收回。
用起来是什么样
- 把幻灯片图准备好。对话里生成的、从桌面拖进去的、对着已有幻灯片截的，对插件来说都一样。
- 说一句要什么。「把这几张转成能编辑的 PPT」。图片按你列出的顺序交过去，那个顺序就是成品里的页序。
- 等它转完。多页的话要几分钟。你可以接着干别的，回头问一句进度就能接上。
- 打开下载链接。标准的 PPTX，PowerPoint、Google Slides、Keynote、LibreOffice 都能打开，重建出来的元素照样可编辑。
哪些能变回可编辑，哪些留成图
不是幻灯片上每一样东西都该被重建，硬要全都重建反而更糟。这条线是有意划的：
重建成 PowerPoint 对象
标题、正文、要点列表、指标行里那几个大数字、表格里的每一格文字、方框和圆角卡片、连接两块内容的箭头、左右对照的两栏、图注。这些变成你能选中、能重打、能换色、能拖动的东西。
保留成图片
照片、人物插画、手绘的装饰笔触、标签互相压着的密集图表、有纹理或渐变的底图。这些留成图片元素，能移动能缩放，但不能一笔一笔重画——勉强重画出来只会更难看。
积分不够，不会让你白干
这一段值得单独讲，因为这正是转换类服务最容易出岔子的地方。如果启动时余额不够，图片已经保存好了，而且一分没扣。你会拿到一个链接，在浏览器里买完积分，回到原来那个对话说一句「继续」。
保存好的任务随即启动。你不用重发图片，同一份也不会被扣两次——重复的请求会落到已经存在的那个任务上，而不是又建一个。转换过程中某一页失败了，那一页不计费。
转出来什么样
左边是一张生成出来的幻灯片图，跟你在对话里得到的是同一类东西。右边是转换之后用 PowerPoint 打开的样子。此时标题、正文、指标卡、表格里的每一格，都是各自独立的对象，不再是图片上的一块。
连不上？按这个顺序排查
绝大多数「装不上」都卡在同样几处。先按顺序把这六步走一遍，走完还不行再看下面的具体症状。
先分清你在哪条路上。① Codex App 和 ③ CLI 的本机授权尚未上线，所以在那两条路上，本节任何「重新授权 / 重新点 Authenticate / codex mcp login」的建议现在都不会生效——请改走 ② ChatGPT 开发者模式。下面的建议对 ② 以及部署之后的 ①③ 都正常有效。
- 确认地址和类型。URL 必须是
https://image2ppt.com/mcp（结尾就是/mcp，不要多加斜杠或路径），Type 必须是 Streamable HTTP，不是 stdio、不是 SSE。这两处填错是最常见的原因。 - 保存，然后重启 Codex。改完配置不重启，客户端可能一直拿着旧状态，界面上看着已经加好了，实际没加载。
- 点 Authenticate。光把地址填进去还不算连上——所有工具都要授权才能用。授权前的状态本来就是「未连接」，这不是故障。（Codex App 与 CLI 的本机授权尚未上线，这一步现在走不完，见 ① Codex App 顶部那段提示。）
- 用
/mcp或codex mcp list检查。以这里显示的状态为准，不要凭设置页面上那一行有没有出现来判断。 - 还不行就重新授权，或者删掉重加。先重新点一次 Authenticate（或
codex mcp login image2ppt）；再不行就把这条服务删掉，从第 1 步重新加一遍，让客户端把缓存的旧信息丢掉。（但如果你在 ① Codex App 或 ③ CLI 上撞的是invalid_redirect_uri，重试和删掉重加都不会有用——那是服务端还没上线，跳到第 6 步，或者直接走 ② ChatGPT 开发者模式。） - 仍然失败就联系支持。写信到 support@image2ppt.com，附上：客户端和版本（Codex App 还是 CLI、哪个版本）、你填的 URL 和 Type、卡在第几步、界面上的完整错误原文、大致发生时间。不要发 token、authorization code、授权链接的完整 URL 或任何密钥——排查用不到这些，发过来反而有风险。
Couldn't connect to image2ppt
客户端连不上这个地址。九成是 URL 或类型填错了：确认是 https://image2ppt.com/mcp，且类型选的是 Streamable HTTP。也确认这台机器能正常访问 image2ppt.com——公司网络的代理或防火墙拦掉它，症状就是这一条。改完记得保存并重启。
Not logged in / Authentication required
地址是通的，只是还没授权，或者授权已经过期。回到 MCP servers 点 Authenticate（命令行是 codex mcp login image2ppt），在浏览器里登录并点同意。授权是有期限的，长期不用之后需要重来一次是正常的，不是出错。
在 ① Codex App 或 ③ CLI 上看到这一条：本机授权尚未上线，重新点 Authenticate 也走不完，请改走 ② ChatGPT 开发者模式。
浏览器里授权完成了，Codex 还是显示没连上
先回到 Codex 里用 /mcp（或 codex mcp list）看一眼真实状态——有时候只是界面没刷新。仍然显示未连接的话，重启 Codex 再看，还不行就重新点一次 Authenticate（① 和 ③ 除外：本机授权尚未上线，重来一次也走不完）。
注意别把另一件事误诊成这一条：如果浏览器当时登录的是你另一个 Image2PPT 账号，授权会正常完成、Codex 也会显示已连接，只是用的是那个账号的积分和记录。分辨方法是让 Codex 调用 get_account，看它报的邮箱是不是你要的那个；不是的话在浏览器里换账号重新授权即可。
保存配置后没有出现 Authenticate
通常是这条服务还没被真正加载，或者类型选错了——只有 Streamable HTTP 这类远端服务才会走 OAuth，才会出现这个按钮。先重启 Codex；重启后仍然没有，就把这条删掉，按第 1 步重新添加一遍，特别核对 Type 那一栏。
授权信息或 MCP metadata 缓存过期
客户端会把服务的工具清单和授权信息缓存下来。我们这边更新之后，你手上那份可能还是旧的，表现为工具列表不对、或者授权明明有效却被当成无效。处理办法是让它重新取一次：重启 Codex；不行就删掉这条服务再重新添加，然后重新授权（① 和 ③ 现在走不完这最后一步，见本节开头）。
授权时浏览器报 redirect_uri 无效
错误里出现 invalid_redirect_uri，或者「Only OpenAI Codex/ChatGPT connector callbacks are supported」这句话，说明服务端拒绝了 Codex 用来接收结果的那个本机回调地址。这不是你填错了，你这边没有什么可改的。请联系 support@image2ppt.com 并附上完整错误原文（同样不要附授权链接本身，里面带着一次性的 code）。在此期间，ChatGPT 开发者模式那条路不经过本机回调，可以先用那条。
这个插件能看到什么、看不到什么
| 问题 | 答案 |
|---|---|
| Image2PPT 会知道我的 OpenAI 身份吗？ | 不会。你的 OpenAI / ChatGPT 账号从不交给我们，我们只知道你自己登录的那个 Image2PPT 账号。 |
| 那它怎么知道该扣谁的积分？ | 你在浏览器里登录 Image2PPT 之后亲手同意过一次。那份授权属于你，花的是你的积分。 |
| 这份授权能干什么？ | 转换幻灯片，以及查看这些转换的状态和下载链接。改不了你的账号，也看不到别人的东西。 |
| 能收回吗？ | 能，随时在 Image2PPT 账号里收回。已经下载的成品不受影响。 |
| 图片会一直留在你们服务器上吗？ | 转好的文件保留 30 天供下载，之后原图和成品一起删除。不用于训练任何模型。 |
插件、网站、接口，该用哪个
| Codex 插件 | 网站 | 开发者接口 | |
|---|---|---|---|
| 什么时候用 | 图已经在对话里 | 文件在自己电脑上 | 让别的程序去转 |
| 一次几张 | 最多 20 张 | 最多 50 张 | 最多 50 张 |
| 怎么登录 | 浏览器里同意一次 | 正常登录 | 把密钥填进代码 |
| 账号和积分 | 同一个账号、同一份积分，三边通用 | ||
常见问题
在 Codex App 里怎么装 Image2PPT？
Settings → MCP servers → Add server，Name 填 image2ppt，Type 选 Streamable HTTP，URL 填 https://image2ppt.com/mcp，Save，然后重启 Codex App，回来点 Authenticate 完成浏览器授权。逐步说明在上面这一节。注意：本机回调授权尚未部署到线上，Authenticate 这一步目前一定走不完；在那之前请改用 ChatGPT 开发者模式。
Codex App 和 ChatGPT 开发者模式是同一套设置吗？
不是，是两套彼此独立的设置。在 Codex App 里加过一遍，ChatGPT 网页里不会自动出现，反过来也一样。你在哪边用，就在哪边设置一次。
一定要用命令行吗？
不用。codex mcp add 那一套只是同一件事的另一种做法，是可选方案。在 App 里点菜单装好之后，不需要再碰终端。
能在插件目录里搜索安装吗？
目前还不能。Image2PPT 还没有上架 Codex 官方插件目录，也还没有提交审核。今天要用，请走 ChatGPT 开发者模式手动添加服务地址；Codex App 与 CLI 的本机授权还在等上线，现在走不完。上架之后我们会在产品更新里说明。
我的图片会上传到你们的服务器吗？
会。这不是本地转换工具：图片会上传到 Image2PPT 的云端服务处理，过程中还会用到第三方云基础设施和模型服务。保留规则以隐私政策为准。涉及公司机密、客户资料、个人信息或受监管数据时，请先确认本单位的政策。
为什么 Codex 不能直接给我一个能改的 PPT？
因为它给的是一张图。画图的模型把文字和背景一样刷在画布上，文件一存下来，标题就不再是标题，只是一片有颜色的像素，PowerPoint 无从点起。Image2PPT 做的事，就是把这张图读一遍，在重建质量够用的前提下还原成真正的对象。
还要下载图片再传到别处吗？
不用——省掉这一趟正是这个插件存在的理由。图片直接过去，成品以链接的形式回到同一个对话里。
Image2PPT 会拿到我的 OpenAI 账号吗？
不会。你的 OpenAI / ChatGPT 身份从不交给我们。你在浏览器里登录自己的 Image2PPT 账号，同意一份只能转换和查看结果的权限，随时可以收回。
转到一半积分不够怎么办？
图片在那之前已经存好，一分没扣。点链接买完积分，回来说一句「继续」，保存好的任务直接启动，不用重传，同一份也不会被扣两次。
一次能转多少张？
一次最多 20 张，按你给的顺序合成一个文件，一张一个积分。要更多的话网站上一次能到 50 张。
自己拖进去的图片能转吗？
能。图从哪来不重要，清不清楚才重要。文字锐利、版面不挤的图，比对着投影幕拍的模糊照片转得好得多。
跟网站是同一个账号吗？
是，同一个账号同一份积分。网站上买的在这儿能用，反过来也一样，记录也都在同一处。
我发过去的图片会被怎么处理？
在 Image2PPT 的服务器上处理。上传的原图和转好的文件都会在保留期后自动删除，不会被用来训练任何模型。确切期限以隐私政策为准。
有免费试用吗？
有。新账号第一次登录会拿到免费积分，够你转几张、看看效果再决定要不要买。没有订阅制，积分也不会按月清零。
字体和颜色能保住吗？
颜色照着原图还原。字体会映射到 PowerPoint 自带的那几款，所以即使原来那款没有，层级关系也不会乱；打开之后换成你自己的品牌字体只要几秒。
支持哪些语言？
中文、英文、日文、韩文和主要的欧洲语言。插件本身也会跟着你说的语言用中文或英文回话，付款页同样跟着走。