DeepFOS 文档 MCP 安装与使用

安装方式

可以复制下方“智能体安装指南”，交给当前客户端中的智能体完成配置；也可以选择对应客户端，复制完整配置并手工安装。

准备连接信息

开始前，只需要准备以下两项信息：

客户端通过以下请求头传递令牌：

Authorization: Bearer <DOC_MCP_TOKEN>

令牌属于访问凭证。不要把真实令牌写入公开文档、项目仓库、聊天记录或截图。能够使用环境变量的客户端，应优先从环境变量读取令牌。

客户端手工配置

选择客户端后，按照对应说明添加配置。服务地址会根据当前打开的文档站自动生成。

{
  "mcpServers": {
    "deepfos-docs": {
      "type": "http",
      "url": "当前文档站地址/api/mcp",
      "headers": {
        "Authorization": "Bearer <DOC_MCP_TOKEN>"
      }
    }
  }
}

安装验证

连接成功后，应能看到以下四个只读工具：

可以让客户端执行以下验证：

1. 调用 docs_catalog，确认能够返回文档来源和目录。

2. 使用 docs_search 搜索“平台对象与数据隔离”。

3. 对搜索结果调用 docs_read，确认正文非空且包含公开文档地址。

4. 涉及界面或操作说明时，调用 docs_images 获取相关图片。

建议使用顺序

1. 不确定文档范围时，先使用 docs_catalog 浏览目录。

2. 使用 docs_search 定位候选文档和章节。

3. 使用 docs_read 核对原文，并引用工具返回的文档地址。

4. 涉及界面、配置或操作步骤时，再使用 docs_images 查询相关图片。

默认情况下，目录和搜索只使用当前版本文档。只有明确需要查询旧版资料时，才应在 docs_catalog 或 docs_search 中设置 include_legacy=true。已知历史文档的 document_id 仍可直接用于读取正文和图片。

连接配置与常见问题

使用边界

文档 MCP 只提供目录、搜索、正文和图片引用，不会修改平台配置、业务数据或文档内容。回答业务问题时应以工具返回的原文和公开地址为依据；文档没有说明的内容，不应由客户端自行推测。