MCP 开放集成
巴克励步
MCP（Model Context Protocol）开放集成指：通过 Baklib 官方 MCP Server（
@baklib/baklib-mcp-server，v1.34.0 起支持读写），让 Cursor、Claude Desktop、VS Code 等 AI 客户端以标准协议 查询与修改 组织内的知识库文章、站点页面、资源库（DAM）等线上数据，而无需人工复制粘贴。是什么
MCP 是 AI 工具与外部数据源之间的 通用连接层。Baklib 侧提供：
- 读取：列举知识库/站点/资源、获取文章正文与元数据，供 Agent 分析、摘要或改写建议。
- 写入：创建或更新页面与文章（具体工具以当前 Server 版本为准）；任何写入线上 Baklib 的操作仍须用户在对话中明确确认，符合内容安全要求。
鉴权使用与个人中心 API 密钥 相同的
<key>:<secret> 格式，通过环境变量 BAKLIB_MCP_TOKEN 或配置文件注入。可与 SKILLS（baklib-tools/skills 中的 baklib-mcp、baklib-bke-markdown 等）组合，规范 Markdown 写法与主题开发任务。为什么需要
- 运营与开发同屏：内容同事在 IDE 里用自然语言查「某站有哪些页面」「这篇文档上次改了什么」，减少切换后台。
- 批量与自动化衔接：MCP 适合交互式任务；更大规模同步可叠加 CLI 或 Open API。
- 与 AI Ready 互补：
llms.txt/.md供外部只读抓取；MCP 供已授权 Agent 读写 组织真实数据。
边界与限制
| 维度 | MCP | 其他通道 |
|---|---|---|
| 典型场景 | IDE 内对话式查改 | CLI 脚本化、API 系统对接 |
| 鉴权 | API 密钥 | 同左 |
| 写入风险 | 须人工确认后执行 | 由调用方自行管控 |
| 私有化 | API 基址与 SaaS 不同 | 见私有化部署文档 |
MCP 不是 Baklib 后台的替代品：成员权限、审核流程、域名与发布仍须在控制台完成。MCP 不能 绕过组织访问控制——密钥持有者的权限边界与 API 一致。
通过 MCP 写入 Markdown 正文时，须声明
body_type: markdown（或工具 schema 中的等价参数），否则 文档编辑器 块级语法可能被当作纯文本存储。与谁组合
- API 密钥：创建与管理入口在个人中心。
- SKILLS / CLI：
npx skills add baklib-tools/skills安装技能包；@baklib/baklib-cli用于脚本化。 - Open API：与内部系统、第三方 LLM 应用对接时的 REST 通道。
- 文档编辑器：MCP 改写的正文须符合 文档编辑器 规范，以便前台与
.md端点正确渲染。 - AI Ready：结构化知识 + MCP 读写，构成「人机协作维护 → Agent 消费」闭环。