文档 AI MCP 使用指南

1. MCP 说明

trustdecision_docs_cn 是面向 TrustDecision 中文开发者文档的只读 MCP 服务，可通过标准 MCP 协议为 AI Agent 提供文档检索、页面读取和来源上下文能力。

该 MCP 适用于：

检索 TrustDecision 中文技术文档
定位产品、接口、字段或 SDK 相关说明
为 AI Agent 回答技术接入问题提供可追溯来源
提升 TrustDecision 产品接入效率

该 MCP 不用于：

调用真实业务 API
执行 SDK 初始化或终端数据采集
代替业务系统进行风险决策

2. 安装与接入

2.1 服务地址

https://docs.trustdecision.com/cn/mcp

2.2 配置示例

适用于支持远程 HTTP MCP 的 AI Agent：

{
  "mcpServers": {
    "trustdecision_docs_cn": {
      "url": "https://docs.trustdecision.com/cn/mcp"
    }
  }
}

完成配置后，请按客户端要求重启或重新加载配置。

2.3 接入验证

完成接入后，可让 AI Agent 执行一次简单检索，确认 MCP 已正确加载并可返回文档结果：

请使用 trustdecision_docs_cn 搜索“设备信息查询”，并返回文档信息。

如能返回相关页面信息，说明 MCP 已可正常使用。

3. 提供的方法

方法	作用	推荐场景
`search_reference`	搜索中文开发文档	已知关键词，需要定位相关页面
`get_reference_page`	读取指定文档页	已知 `slug`，需要获取页面正文
`answer_reference_question`	根据问题组装来源上下文	用户提出明确技术问题，需要 AI Agent 基于文档回答

3.1 `search_reference`

按关键词搜索 TrustDecision 中文开发文档。

主要参数：

query：搜索关键词，建议包含产品名、接口名、字段名或业务场景
limit：返回结果数量，建议取值 3-5

主要返回：

命中文档标题
文档 slug
文档链接
摘要、关键词或正文片段

适合用于文档召回、页面定位和获取标准 slug。

3.2 `get_reference_page`

按 slug 读取指定文档页面。

主要参数：

slug：文档页面标识
reduce：是否返回精简后的页面内容；面向 AI Agent 问答场景时建议设为 true

主要返回：

页面标题
页面正文
页面链接
更新时间及其他元信息

适合用于读取目标 API、SDK 或产品说明页。

3.3 `answer_reference_question`

根据自然语言问题匹配相关文档，并返回可用于回答问题的来源上下文（grounded context）。

主要参数：

question：自然语言问题
topK：用于组装上下文的候选页面数量，建议取值 3-5

主要返回：

命中的文档页面
可用于回答的来源上下文
回答时应遵循的来源约束

适合用于 AI Agent 对明确技术问题进行文档辅助问答。

4. AI Agent 使用指南

4.1 推荐调用策略

对于需要准确定位文档的问题，推荐：

search_reference -> get_reference_page -> AI Agent 基于文档回答

对于用户已经提出明确自然语言问题的场景，推荐：

answer_reference_question -> 必要时补充 get_reference_page -> AI Agent 基于上下文回答

如果 answer_reference_question 返回结果不足或上下文不完整，建议回退到 search_reference + get_reference_page。

AI Agent 输出时应遵循以下原则：

基于 MCP 返回的页面内容或来源上下文回答
保留页面标题、slug 或链接作为来源依据
当上下文不足时，明确说明信息不足，不应脱离文档内容推断

4.2 AI Agent 示例：查询接口文档

用户问题：

请说明设备信息查询接口的调用方式。

AI Agent 建议流程：

调用 search_reference 搜索 设备信息查询
从结果中识别目标页面，例如 devicefingerprint-api-1
调用 get_reference_page 读取页面详情
基于文档回答接口地址、认证参数、请求字段、响应字段和状态码
在回答中保留页面标题或 slug，便于追溯来源

4.3 AI Agent 示例：解释字段含义

用户问题：

请解释设备信息查询接口中的 black_box 字段含义。

AI Agent 建议流程：

调用 answer_reference_question 获取相关上下文
检查命中页面是否与设备指纹或设备信息查询相关
如果上下文不足，再调用 search_reference 搜索 black_box 设备信息查询
基于文档解释字段含义、来源和使用位置

4.4 AI Agent 示例：梳理产品接入

用户问题：

请说明身份反欺诈标准版的接入流程。

AI Agent 建议流程：

调用 answer_reference_question 查询 身份反欺诈标准版
读取命中的概述页和风险验证 API 页
按接入步骤整理终端 SDK、后端 API、必要字段和返回结果
如文档上下文不足，应明确说明需要补充确认

5. 使用建议

查询词应尽量具体，建议包含产品线、接口名、字段名或业务场景
需要稳定定位文档时，优先使用 search_reference
需要读取完整页面时，使用 get_reference_page
需要快速回答明确问题时，可使用 answer_reference_question
如问答结果不足，建议回退到 search_reference + get_reference_page
对正式输出内容，应保留文档标题、slug 或链接作为来源依据

6. 返回结果处理

各方法返回的业务结果为 JSON 文本。不同 MCP 客户端的外层封装可能不同；如结果位于 content[0].text，调用方应先解析 JSON，再使用其中的文档字段。

建议重点使用以下字段：

result_type：结果类型
title：页面标题
slug：页面标识
url：页面链接
body 或 grounded_context：文档正文或问答上下文

当返回中包含多个页面时，建议优先选择标题、slug、正文内容与用户问题最匹配的页面作为回答依据。

7. 能力边界

MCP 返回的是文档检索和文档上下文，不代表业务接口的实时调用结果
AI Agent 不应使用 MCP 结果代替客户系统中的真实 API 请求、SDK 调用或风控决策
如文档内容与客户实际开通能力、环境配置或合同约定存在差异，应以双方确认的正式接入信息为准

1. MCP 说明

2. 安装与接入

2.1 服务地址

2.2 配置示例

2.3 接入验证

3. 提供的方法

3.1 search_reference

3.2 get_reference_page

3.3 answer_reference_question

4. AI Agent 使用指南

4.1 推荐调用策略

4.2 AI Agent 示例：查询接口文档

4.3 AI Agent 示例：解释字段含义

4.4 AI Agent 示例：梳理产品接入

5. 使用建议

6. 返回结果处理

7. 能力边界

3.1 `search_reference`

3.2 `get_reference_page`

3.3 `answer_reference_question`