MCP 快速入门——为你的 AI 智能体提供忠于品牌的文档
把 Claude Desktop、Claude Code 或任何支持 MCP 的 copilot 指向 DocMark，它就获得了一个文档生产工具：它负责撰写，DocMark 负责渲染、套用品牌并校验，并返回它可以修正的问题——都在同一个会话中完成。
大多数"AI + PowerPoint"工具止步于生成一个文件。DocMark 的 MCP 服务器给你的智能体的是另一种东西：一个忠于品牌、经过校验的文档能力。智能体撰写实质内容；DocMark 以确定性方式套用你的企业品牌，运行它的校验关卡，然后交回完成的成果，或者需要修正的问题清单——让你的智能体自己闭合这个循环。
可用性：现已可用，并包含在所有套餐中——MCP 是同一个
/v1API 的轻量客户端，使用同一份每月渲染额度。已登录的客户可以在门户的 API tokens 页面下载服务器；如有问题请联系 hello@docmark.md。也可以自管理运行——本地部署或你自己的云租户。
1. 获取服务器及其运行环境
在使用下面的配置之前，需要准备两样东西：
docmark_mcp.py——在门户的 API tokens 页面下载（app.docmark.md → API tokens → Connect your AI assistant，页面为英文），那里还有一个单文件的 Claude Desktop 扩展。工作空间管理员在同一页面创建 API token；其他人请向管理员或我们索取。它只是一个文件；放在任何位置，并记下它的绝对路径。PATH 中有 Python 3.10+，以及 MCP 运行时：
pip install "mcp<2"请固定主版本号。直接运行
pip install mcp会安装 2.0.0，服务器将无法启动。Claude Desktop 自带的是 Node，而不是 Python——你需要自己的 Python。
2. 连接服务器
DocMark 运行的是一个标准的 MCP stdio 服务器。把它加入你的 MCP 客户端配置——以 Claude Desktop / Claude Code 为例：
{
"mcpServers": {
"docmark": {
"command": "python",
"args": ["/absolute/path/to/docmark_mcp.py"],
"env": { "DOCMARK_API_TOKEN": "dmk_xxxxxxxx.xxxxxxxx" }
}
}
}
在 macOS 上请用 python3 而不是 python——macOS 自带的环境中 PATH 上没有 python。
这个服务器是 /v1 API（英文）的轻量客户端——token 就是同一个按租户划分的 bearer token，保存在控制端（绝不会进入模型的上下文）。
3. 你的智能体获得的工具
list_themes——你的租户可用的品牌与外观。generate_deck/generate_document——提交一个文档任务（工具的说明文字会教给智能体严格的规格和一个示例，让它第一次就把格式写对）。job_status——轮询一个任务；失败的任务会返回它的问题清单。fetch_result——把经过校验的成果下载到一个路径。
4. 让它可靠的循环
agent authors content -> generate_deck -> job_status
|
done? -> fetch_result | failed? -> findings
| |
<---- fix & resubmit
当校验关卡扣下交付物时，智能体会收到原因（问题清单），并重新提交一个修正后的任务——机械性的修正不需要人参与。这正是 DocMark 每一份输出背后"先渲染、再校验"的同一套纪律，以工具的形式开放出来。
为什么让你的智能体经由 DocMark
- 真正忠于品牌，而不是"看起来像"——你（或你客户）真实的企业颜色、字体与模板，以确定性方式套用。按客户区分的品牌内置其中。
- 交付前经过校验——关卡会扣下空白或没有任何内容的幻灯片、以及结构损坏的文件，你的智能体会拿到问题清单去修正并重新提交。
- 多格式——不只是幻灯片：Word、Excel、宣传册、简报，以及带旁白的视频，都出自同一个入口。（大多数 MCP 文档工具只支持 PPTX。）
- 契约有版本——底层 API 已固定版本（
1.18.0），因此你的智能体集成是稳定的。
下一步：完整 API 参考（英文） · 部署方式 · 申请访问