AI MCP 使用指南
连接 AI 客户端，查询 TrustDecision 文档。
连接 AI 客户端，查询 TrustDecision 文档。
TrustDecision 文档 MCP 是基于模型上下文协议（Model Context Protocol，MCP）的只读服务，供 AI Agent 检索和读取公开文档。
https://docs.trustdecision.com/mcptrustdecision_docs 为示例名称，可自定义。所有客户端使用同一服务地址，无需追加语言路径。
按客户端和使用方式选择一种配置方式即可。桌面端可通过设置或配置文件接入，无需额外安装命令行工具（CLI）。
菜单名称可能因客户端版本而异。编辑已有配置文件时，请合并本服务的配置，保留原有内容。文中的 ~ 表示用户主目录。
桌面端（本地项目）
在项目根目录的 .mcp.json 中添加以下配置：
{
"mcpServers": {
"trustdecision_docs": {
"type": "http",
"url": "https://docs.trustdecision.com/mcp"
}
}
}在 Claude Code 桌面端打开该项目并启动本地会话，按提示启用项目 MCP 配置。此配置也适用于从同一项目目录启动的 CLI。
CLI
执行以下命令，将服务添加到用户配置：
claude mcp add --transport http --scope user trustdecision_docs https://docs.trustdecision.com/mcp执行 claude mcp list 查看配置，在 Claude Code CLI 会话中输入 /mcp 确认连接状态。仅供当前项目使用时，将 --scope user 改为 --scope project。
使用支持 Streamable HTTP 的 MCP 客户端，填写本页服务地址。具体配置格式以客户端说明为准。
企业自建 Agent 可通过 MCP 客户端 SDK 完成初始化、工具发现和工具调用，并按下文处理返回结果。
在 AI Agent 中发送：
请使用 trustdecision_docs 查询“设备信息查询”文档，
读取相关接口文档，说明调用地址、必填参数，并附上文档链接。
如果文档不足以确认，请明确指出缺少的信息。确认 Agent 实际调用了文档工具，并返回相关内容和来源链接。若修改了配置名称，请同步替换示例中的名称。
连接后可发现以下三个工具：
提问时说明产品、平台和使用场景；涉及特定版本或部署区域时，一并提供。
请使用 trustdecision_docs 查询设备指纹 Android SDK 接入文档，
梳理初始化、获取 blackBox、后端查询的步骤和前置条件。
请引用相关文档，并区分 SDK 操作与服务端 API 调用。请使用 trustdecision_docs 解释设备信息查询接口中的 black_box 字段：
它从哪里获取、在哪一步传入、有哪些使用要求？请附上来源。我在设备指纹 Android SDK 接入时遇到 blackBox 为空的问题。
请使用 trustdecision_docs 查找相关初始化要求、注意事项和排查说明。
如果需要 SDK 版本或其他信息才能判断，请先列出需要补充的条件。本节供 Agent 开发者参考。下列 JSON 是工具调用参数，由 MCP 客户端封装并发送。
先调用 search_reference 定位页面，例如：
{
"query": "设备信息查询 black_box",
"locale": "cn",
"limit": 3
}从 data.results[].document.doc_id 取得页面标识，再调用 get_reference_page；同时传入返回结果顶层的 content_revision，校验搜索与读取是否使用同一内容版本。若该版本已不可用，应重新搜索。搜索摘要用于定位页面，回答参数要求等细节前应读取相关正文。
get_reference_page 默认按 mode: "full" 读取正文；mode: "outline" 返回章节目录；mode: "sections" 读取指定章节及其必要前置说明，需要传入 section_ids 和对应的 content_revision。页面与章节标识应使用工具返回值。
明确的技术问题可以直接交给 get_reference_context：
{
"question": "如何初始化设备指纹 Android SDK 并获取 blackBox？",
"locale": "cn",
"intent": "integration",
"top_k": 5
}该工具返回 data.evidence、data.sources、data.missing_requirements 和 data.follow_up_reads，由调用方的 AI Agent 基于这些依据组织回答。来源不足时，可补充调用 search_reference 和 get_reference_page，不应自行补全未被文档证实的接口行为。
search_reference 和 get_reference_context 可通过 locale 指定 cn（中文）、en（英文）或 all（两种语言，默认值）。读取页面时，get_reference_page 使用搜索结果中的 doc_id。
文档语言不代表业务部署区域。搜索和上下文工具的 filters 可限定产品、平台、区域等条件；只在已知条件时传入筛选值，并使用文档目录中列出的标准值。
可通过 get_reference_page 读取目录 td:overview:cn:v3 或 td:overview:en:v3，查看产品和筛选值。filter_match: "unknown" 表示筛选条件的适用性尚未确认；source_facts 记录原文出现的版本、区域等信息，不等同于完整的支持范围。
get_reference_context 按完整章节及其必要前置说明组织证据。它的 max_chars 按 Unicode 码点计数，控制证据正文预算，不包括响应中的元数据，也不等于模型的 token 数；未设置时使用默认预算。各工具的参数范围以客户端发现的工具定义为准。
预算不足时，仅返回能容纳的完整章节及其必要前置说明，并在 data.follow_up_reads 中列出需要补充读取的章节。Agent 应调用 get_reference_page，使用 mode: "sections"，并传入对应条目中的 doc_id、section_ids 和 content_revision。预算非常小时，data.evidence 可能为空，仍可按续读提示获取正文。
搜索或页面读取结果的顶层 next_cursor 非空时，将其作为下一次调用的 cursor，保持原查询或读取参数不变，并保留 content_revision。需要完整结果时，持续读取到 next_cursor 为空；分页过程中不要修改 limit、max_chars 或筛选条件。
data.content 是本次返回的文档正文片段。展示时可组合 data.presentation.prefix、data.content 和 data.presentation.suffix，补充代码围栏、表头等阅读辅助内容；合并分页正文时，仅按偏移顺序拼接各页的 data.content。未读完的代码或表格片段不能视为完整示例。
优先读取 MCP 返回的 structuredContent；若客户端仅提供文本内容，可解析 content 中相应文本块的 JSON。业务结果位于其中的 data，并通过顶层 status、issues、truncated、next_cursor 和 error 判断后续动作。
回答应保留来源链接，并说明仍需确认的条件。
不需要。本 MCP 面向公开文档，连接时无需提供 TrustDecision 业务 API 的密钥或客户凭据。业务接口的鉴权仍按各产品文档执行。
/mcp 是供 MCP 客户端连接的协议入口，不是普通网页。直接在浏览器打开可能返回 405；请通过客户端配置和实际工具调用验证服务。
检查服务和工具是否已启用，当前会话是否已加载该配置，再明确要求“使用 trustdecision_docs 查询”。桌面应用应检查当前会话的连接器或 MCP 列表；CLI 应检查实际运行目录和配置作用域。若客户端提示工具调用需要许可，按其提示处理。
先确认当前版本支持自定义远程 MCP，再按对应官方文档查找入口。企业工作区可能需要管理员添加或批准服务。桌面、CLI 与云端会话的配置作用域可能不同，应以当前会话实际发现的工具为准。
部分客户端从云端连接远程 MCP。请使用本页的公开 HTTPS 地址，并检查 Agent 所在环境的网络是否允许访问。
收到 HTTP 429 时，按 Retry-After 提示等待后再试，并减少并发或重复查询。收到 CONTENT_REVISION_UNAVAILABLE 时，重新搜索获取当前内容版本，丢弃旧游标。收到 INVALID_CURSOR 时，从第一页重新开始，不要自行修改或复用其他请求的游标。
无需因文档内容更新而重新配置服务地址。MCP 与文档站在构建发布时同步更新，提供本次已发布的文档内容。
本服务用于文档检索与阅读，不会执行真实业务 API、运行 SDK 或代替业务系统作出风控决策。AI Agent 的接入建议应有文档依据；涉及实际开通的产品、环境或权限时，以双方确认的正式接入信息为准。