Unplain MCP

你的助手负责撰写电子书或报告。Unplain 负责设计，并交回一份可发布的 PDF。

Unplain 是一个托管的 Model Context Protocol 服务器。你提出文档需求，你的助手负责撰写，选择设计（或应用你已保存的品牌），生成封面，并导出包含合成封面、根据标题构建的目录、真实分页和结尾行动号召页的成品 PDF。你无需离开聊天，也无需打开设计工具。

由此产生两点，这也是使用本服务而非直接让模型生成 PDF 的原因：

• 每次输出都一致。 品牌主题会被保存，因此第十份文档与第一份完全一致。你的助手可以创建并复用主题。

• 修订不消耗 token。 每份文档都是你 Unplain 账户中的真实项目，工具会返回编辑器链接。点击链接修改句子，而不是让模型重新生成文件。

Unplain 不撰写你的内容，通过 MCP 也不接受文件上传：你的助手以 Markdown 形式提供文字。上传 .docx 或 .txt 是 Web 应用 的功能，而非 MCP 功能。

• 端点： https://app.unplain.io/api/mcp

• 传输方式： Streamable HTTP

• 认证： Authorization: Bearer <api-key>（也接受裸的 Authorization: <api-key>）

• 安装： 无需安装

• 文档： https://unplain.io/mcp

• 定价： 所有套餐均包含，免费版和专业版。 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.

Related MCP server: MCP MD2PDF Server

工具

共十二个工具。名称和行为以 CHANGELOG.md 中的版本为准。

实际使用中的注意事项

• 编辑是原子性的且带版本检查。 助手无法覆盖你同时在 Web 应用中所做的更改；过期的写入会被拒绝，而不是覆盖你的工作。

• 设计可以用描述而非指定。 “一份冷峻的单色报告”或“一本优雅的独立文学期刊”会解析为真实设置，这些设置是从 Unplain 实际支持的范围中选取的，而非猜测。

• 目录之外的字体会被拒绝，而不是替换。 你在应用中看到的就是 PDF 中呈现的。

• 封面生成使用你现有的配额，与应用中按钮使用的配额相同。没有单独的 MCP 配额。覆盖现有封面需要明确确认，因此重复请求不会静默消耗第二次生成。

• 下载链接是签名且过期的。 项目已保存，因此请重新导出，而不是囤积 URL。

套餐与限制

MCP 是接口，不是层级。密钥携带的权限与账户完全一致，无论你在 Web 应用还是通过助手操作，适用的限制都相同。

封面、目录和行动号召页不计入页数限制。当前定价：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。不要在其中提交真实密钥。 使用占位符，让每个人提供自己的密钥；密钥在其所属账户中生效。

• 从 账户设置 撤销。撤销立即生效。每个客户端使用一个密钥，这样你可以撤销一个而不影响其他。

故障排除

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

支持

• 文档：https://unplain.io/mcp

• 邮箱：info@unplain.io

• 问题：使用本仓库

许可证

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