dochost-mcp 是 dochost 的官方 MCP 服务器，目标是把 AI 助手生成的 Markdown 或 HTML 直接发布为可分享的网页链接，省去截图或发送原始 .md 文件的麻烦。
用途 当 LLM 产出报告、README 或 HTML 工件时，dochost 通过一次工具调用将其变成拥有独立 URL 的正常网页，Markdown 和 HTML 均实时渲染。
主要能力 服务器提供六个工具：
- publish：将 Markdown 或 HTML 发布为托管页面并返回可分享 URL，同时返回 url、slug、expiresAt 和 editToken。
- update_page：原地替换页面内容，URL、浏览/点赞数和过期时间均保留，仅 body、format 和 title 变化。修订已发布内容时应优先使用它，避免二次发布产生新链接而使读者手中的旧链接失效；重复发送相同内容为空操作。
- list_my_pages：按最新优先列出已发布页面，支持分页（limit、offset），返回不含页面正文的紧凑记录。
- get_page：按 slug 查询单个页面，返回标题、格式、状态、浏览/点赞数、过期时间以及是否受密码保护，不返回正文或密码。
- get_account：返回计划、页面配额使用情况和权益标志（大小上限、自定义 slug、密码、品牌标识），建议在发布前调用以提前了解限制。
- delete_page：按 slug 永久删除页面，链接立即失效并释放 slug；删除已删除页面为安全空操作。 所有权和权益来自已认证账户，而非工具输入。
使用方式 Claude Code 可通过一行命令安装，然后在 Claude Code 内运行 /mcp 并在浏览器中批准；添加 --scope user 可在所有项目中使用。Claude Desktop、Cursor、VS Code、Windsurf 等客户端可添加远程 HTTP 服务器，通过 OAuth 在浏览器中授权一次，助手即以你的身份发布，输出遵循 dochost 计划的权益。 MCP 服务器地址为 https://dochost.io/mcp，端点为 https://dochost.io/api/mcp（Streamable HTTP，OAuth）。 对于需要本地 stdio 进程的客户端或目录评估器，仓库包含连接到同一托管 MCP 端点的桥接，也可在 Docker 中运行。需要 Node.js 22 或更高版本。桥接转发实时工具和 schema，并非 dochost 应用的自托管副本。初始化和工具发现是公开的；交互式客户端可使用 OAuth，无头工具执行需要已有的 DOCHOST_API_KEY 运行时密钥（Docker：docker run --rm -i -e DOCHOST_API_KEY dochost-mcp）。 无头代理（OpenClaw、Hermes）使用 API 密钥认证：在 dochost.io → Settings → API keys 创建，导出为 DOCHOST_API_KEY，然后可安装技能（skills/dochost-publish/，适用于任何能发起 HTTP 请求的代理）或将 MCP 指向 https://dochost.io/api/mcp 并以 Bearer 头携带密钥（examples/mcporter.config.json）。各主机安装指南见 clients/openclaw.md 和 clients/hermes.md，shell 一次性发布示例见 examples/publish.sh。 API 密钥应像机密一样保存为环境变量或主机密钥，切勿提交；若泄露，可在 Settings → API keys 中撤销或轮换。
适用场景 适合需要将 AI 生成的报告、README、HTML 工件快速转为可分享网页的用户，以及希望助手持续维护已发布页面而非每次修订都产生新链接的场景。
限制 发布页面托管在 dochost.co，这是独立的无 Cookie 内容源，而非应用源 dochost.io；dochost.io/d/… 会永久重定向到 dochost.co/d/…，旧链接继续有效。免费链接有效期为 7 天；永久链接、密码、自定义 slug、自定义子域和去除品牌标识属于付费计划，详见 dochost.io。项目采用 MIT 许可。
