Unplain

Unplain MCP

你的助手撰写电子书或报告。Unplain 为其设计版式，并交付可直接发布的 PDF。

Unplain 是托管式的 Model Context Protocol 服务。提出文档需求后，你的助手会撰写内容、选择设计（或应用你保存的品牌主题）、生成封面，并导出完成的 PDF，其中包含经过排版的封面、根据标题生成的目录、真实页码，以及结尾的行动号召页面。你无需离开聊天，也无需打开设计工具。

由此带来两点优势，也是你选择它而不是直接让模型生成 PDF 的原因：

• 每次生成的效果都一致。 品牌主题会保存下来，因此第十份文档也能与第一份保持一致。你的助手可以创建主题并重复使用。
• 修改无需消耗令牌。 每份文档都是你 Unplain 账户中的实际项目，工具会返回编辑器链接。点击即可修改句子，无需让模型重新生成文件。

Unplain 不会撰写你的内容，而且通过 MCP 也不接受文件上传：你的助手会以 Markdown 形式提供文字。上传 .docx 或 .txt 是 web app 的功能，不属于 MCP。

• 端点： https://app.unplain.io/api/mcp
• 传输方式： Streamable HTTP
• 身份验证： Authorization: Bearer <api-key>（也接受不带 Bearer 的 Authorization: <api-key>）
• 安装： 无需安装
• 文档： https://unplain.io/mcp
• 定价： 所有套餐均包含，包括免费版和 Pro。https://unplain.io/pricing

本仓库仅提供文档。服务由托管方运行，因此无需安装软件包，也没有可运行的源代码。欢迎在此提交问题和疑问。

发布到官方 MCP Registry：请参阅 PUBLISHING.md。 清单文件位于 server.json。

---

快速开始

1. 获取 API 密钥

前往账户设置创建密钥。密钥只会显示一次。免费账户即可完成以下所有操作。

2. 添加服务

Claude Code

claude mcp add --transport http unplain https://app.unplain.io/api/mcp \
  --header "Authorization: Bearer unp_your_key_here"

完整指南：https://unplain.io/mcp/claude-code

Codex

export UNPLAIN_API_KEY="unp_your_key_here"

codex mcp add unplain \
  --url https://app.unplain.io/api/mcp \
  --bearer-token-env-var UNPLAIN_API_KEY

完整指南：https://unplain.io/mcp/codex

其他客户端

任何能够添加远程 MCP 服务并发送 Authorization 标头的客户端都可以使用。你需要两个值：

Server URL:  https://app.unplain.io/api/mcp
Header:      Authorization: Bearer unp_your_key_here

目前，只有支持连接在本机运行的服务的客户端还无法连接。

3. 打个招呼

List the Brand Themes in my Unplain account and tell me which one is the default.

列表为空也表示成功：连接正常，只是你还没有保存任何主题。

4. 开始创作

Write a short ebook called "The Email Welcome Sequence Playbook" with an intro
and five chapters. Use my default Brand Theme, then export the PDF.

---

工具

共 12 个工具。工具名称和行为以 CHANGELOG.md 中所列版本为准。

工具	功能
get_account	报告此密钥所属的套餐及适用限制。撰写长文档前值得调用。
get_design_options	提供字体目录、内置预设，以及各项排版和间距设置的允许范围。
list_brand_themes	列出已保存的品牌主题。
create_brand_theme	保存新的品牌主题，包括颜色、字体和链接。
update_brand_theme	修改主题的名称、颜色、字体或链接。
create_ebook	根据标题和 Markdown 创建项目。
list_ebooks	查找调用者的项目。
get_ebook	以结构化大纲的形式读取项目。
update_ebook	重写段落、标题和列表，修改封面文案和样式、应用主题，或替换正文。
generate_cover_image	根据章节标题或你的指示生成 AI 封面图片。
export_ebook	渲染经过设计的 PDF。
get_export_status	轮询正在进行的导出，并获取下载链接。

实际使用中需要注意的事项

• 编辑操作是原子的，并会进行版本检查。 助手不会覆盖你此时在 Web 应用中所做的更改；过时的写入会被拒绝，而不会覆盖你的工作。
• 设计可以用描述来表达，而不必逐项指定。 “简约的黑白报告”或“优雅的独立文学期刊”会解析为实际设置，这些设置取自 Unplain 真正支持的选项，而非凭空猜测。
• 目录之外的字体会被拒绝，而不会替换。 你在应用中看到的，就是最终生成到 PDF 中的效果。
• 封面生成会使用你现有的额度，与应用中按钮使用的额度相同。MCP 没有单独的额度。覆盖现有封面需要明确确认，因此重复请求不会在不知情的情况下消耗第二次生成额度。
• 下载链接经过签名且会过期。 项目已保存，因此需要时重新导出，不要囤积 URL。

---

套餐与限制

MCP 是一种接口，而不是套餐等级。密钥具有其所属账户的全部功能，同样的限制适用于 Web 应用和助手。

	免费版	Pro
每个导出 PDF 的内容页数	5	无限制
已保存的项目	5	无限制
品牌主题	1	25
AI 封面	终身 1 个	每个周期 30 个
“Made with Unplain”徽章	始终显示	可移除

封面、目录和行动号召页面不计入页数限制。 当前定价：https://unplain.io/pricing

---

提示词示例

更多示例请参阅 examples/prompts.md。以下是一些入门示例：

Take the Markdown in notes.md and create an Unplain ebook called "Q3 Growth
Report". Use my default Brand Theme, then wait for the export and give me the
PDF link.

Open my Unplain ebook "Q3 Growth Report", read the outline, rewrite the
introduction so it opens with a concrete number instead of a general claim,
then export a fresh PDF.

Analyse the churn data in ./data, write it up as a report with an executive
summary, three findings and a recommendation, then create it in Unplain using
my "Acme" theme and export the PDF.

---

保护好你的密钥

请像保护密码一样保护它。

• Codex 从环境变量中读取密钥，因此密钥不会写入配置文件。
• Claude Code 的 -s project 会在项目根目录中写入 .mcp.json。**不要在其中提交真实密钥。**请使用占位符，并让每个人提供自己的密钥；密钥仅对其所属账户有效。
• 在账户设置中撤销密钥。撤销会立即生效。每个客户端使用一个密钥，这样你就能单独撤销某个密钥，而不影响其他客户端。

---

故障排除

现象	原因
所有工具调用都失败	密钥未传送到服务端。请求头必须是 Bearer （末尾带空格）后接密钥，URL 必须以 /api/mcp 结尾，且末尾不能有斜杠。密钥无效时会返回 401，大多数客户端会将其报告为连接失败。
工具未显示	重启客户端。新服务会在会话启动时加载。
Codex 找不到密钥	Codex 会在启动时读取环境变量。请在 shell 配置文件中导出密钥，并从包含该环境变量的 shell 启动 Codex。
“没有品牌主题”	连接正常，只是你还没有保存主题。助手可以创建主题，也可以使用内置预设进行设计。
导出时提示电子书过长	免费版最多可导出 5 个内容页。请缩短内容或升级套餐。无论如何，项目都会保存。
请求过多	创建和导出操作受账户级速率限制。请等待一分钟。

更多信息：https://unplain.io/mcp

---

支持

• 文档：https://unplain.io/mcp
• 电子邮件：[email protected]
• 问题：请使用此代码库

许可证

此代码库中的文档和示例采用 MIT 许可证。Unplain 服务本身受其服务条款和隐私政策约束。