Textira MCP 的工具与参数手册（权威）。如何挂到百炼 / 写 Node 示例，见 千问 MCP（对接）。
服务内两层：
- 原始层：上传的 PDF 等（列表路径形如
/文件.pdf） - 整理层
/wiki/：Markdown（知识库称「知识页面」，任务文献库称「编译文稿」）
| 工具 | 作用 |
|---|---|
guide | 按锁定空间 kind 返回专用操作规则 + 文件数；全局入口返回分类规则 + 空间列表 |
search | 浏览或关键词检索（path / tags；list 默认不含 overview/log 等脚手架） |
read | 读文件（路径 / 页码） |
write | 创建或改整理页 |
delete | 删除（overview / log 受保护） |
建议：先 guide（知识库与任务文献库规则分开）。「有什么/讲什么」用 search(mode=list) → read，答完即停。任务文献主业是问答/辅助写作/结构化摘录，勿推销编译；仅用户明确要求写入 wiki 时再 write。勿主动 delete。overview/log 为结构页。
path="/" / /* 表示只滤原始层，不是打开名为 / 的文件夹；找文件用默认 *。
入口
| 路径 | knowledge_base |
|---|---|
/{slug}/mcp | 推荐。可省略；若传必须等于路径中的 slug |
/mcp | 必传 slug（留空只列空间）；勿传 UUID |
鉴权：Authorization: Bearer sv_…。挂载方式见 千问 MCP（对接）。
search：按科目用 tags（知识库推荐）
知识库中，为资料设置科目后会写入文档字段：
tags：[一级, 二级, 三级]，例如["生命医学", "医学", "临床医学"]- 目录路径：
/一级/二级/三级/（随文档移动；无需依赖预建空文件夹）
按学科缩小检索范围时，工具参数请传 tags（AND：须同时包含所列标签），不要靠浏览空目录树，也不要把科目路径塞进 path。
推荐调用（模型侧 tool call）
# 某学科下的关键词检索
search(mode="search", query="免疫治疗", tags=["生命医学", "医学"])
# 精确到三级科目
search(mode="search", query="临床试验", tags=["生命医学", "医学", "临床医学"])
# 只列出某科目下的文件
search(mode="list", tags=["公共经管", "经济财政与金融"])
# 仅在整理结果里搜
search(mode="search", query="关键概念", path="/wiki/**")
# 全局 /mcp 时须带 slug
search(
knowledge_base="your-space-slug",
mode="search",
query="临床试验",
tags=["生命医学", "医学"]
)
业务代码如何通过 input 引导模型填 tags，见 千问 MCP · 按学科缩小范围。
参数说明
| 参数 | 说明 | 取值 / 示例 |
|---|---|---|
knowledge_base | 空间 slug | /{slug}/mcp 可省略；全局 /mcp 必填 |
mode | 浏览或关键词检索 | list（默认，不含 overview/log/index.json/.keep）；search |
query | 检索关键词 | search 时必填 |
path | 限定原始文件或整理结果；按学科用 tags | 见下表 |
tags | 文档须包含所列全部标签（AND） | 如 ["生命医学", "医学"] |
limit | 返回条数上限 | 默认 10 |
path 在 mode=list 与 mode=search 中语义一致：
| 取值 | 含义 |
|---|---|
*（默认） | 不限 |
以 /wiki 开头（如 /wiki/**） | 只含整理结果 |
/ 或 /* | 只含原始文件（不含 /wiki/） |
| 其它 | list 按 glob 过滤；search 等同不限 |
注意：list 时传 path="/" 表示「原始层」，不是字面匹配路径恰好为 / 的文件。
任务文献库通常不按科目目录组织；仍以 query + 可选 path 为主，tags 有则可用。
相关
千问 MCP（对接） · 概念说明 · 典型流程