查询MCP工具集中的工具。

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：ListMCPToolsetTools

要执行的操作，取值：ListMCPToolsetTools。

Version string 必选示例值：2025-10-30

API的版本，取值：2025-10-30。

MCPToolsetId string 必选示例值：m-ye7f6gd7nktv3gi6c***

MCP工具集服务ID。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

MCPService object[] 示例值：--

MCP工具集详情。

IsAllTool boolean 示例值：true

是否全量返回工具。

MCPServiceId string 示例值：m-ye7f6gd7nktv3gi6c****

MCP服务ID。

MCPTools object[] 示例值：-

工具的标签。

Description string 示例值：add comments

MCP服务的工具描述。

Name string 示例值：add-comments

MCP工具的名称。

Tags string[] 示例值：Version1

工具的标签。

Name string 示例值：add-comments

MCP工具的名称。

MCPToolsetId string 示例值：mt-yefjsz5s0054ppxu****

MCP工具集的ID。

请求示例

返回示例

{​
  "ResponseMetadata": {​
    "RequestId": "20260212221805CB3871ABF16839****",​
    "Action": "ListMCPToolsetTools",​
    "Version": "2025-10-30",​
    "Service": "agentkit",​
    "Region": "cn-beijing"​
  },​
  "Result": {​
    "MCPToolsetId": "mt-yefjsz5s0054ppxu****",​
    "MCPService": [​
      {​
        "MCPServiceId": "m-yefgecdo8wntl8dn****",​
        "Name": "mcp_service_test_liutao",​
        "IsAllTool": true,​
        "MCPTools": [​
          {​
            "Name": "update-doc",​
            "Description": "更新飞书云文档内容。支持 7 种模式：overwrite(覆盖)、append(追加)、replace_range(定位替换)、replace_all(全文替换)、insert_before(前插入)、insert_after(后插入)、delete_range(删除内容)。\n\n# 概述\n\n更新飞书云文档内容，支持 7 种模式。优先使用局部更新（append/replace_range/insert），慎用 overwrite。支持异步：大文档超时返回 task_id。\n\n# 定位方式\n\n定位模式支持两种方式，二选一。replace_range/insert 要求匹配唯一，replace_all 允许多处。\n\n## selection_with_ellipsis - 内容定位\n\n- **范围匹配**：`开头内容...结尾内容`（匹配中间所有内容，建议 10-20 字符确保唯一）\n- **精确匹配**：`完整内容`（不含 `...`，适合短文本/关键词）\n- **转义**：内容本身含 `...` 时用 `\\.\\.\\.`\n\n示例：\n- `你好...世界` → 匹配从\"你好\"到\"世界\"之间的任意内容\n- `你好\\.\\.\\.世界` → 匹配字面量 \"你好...世界\"\n\n\n## selection_by_title - 标题定位\n\n格式：`## 章节标题`（可带或不带 # 前缀）\n\n自动定位整个章节（从该标题到下一个同级或更高级标题之前）。\n\n# 返回值\n\n- **成功**：doc_id, mode, message, warnings(可选), replace_count(replace_all 模式)\n- **异步**：task_id（用于查询状态，再次调用 update-doc 仅传 task_id）\n- **错误**：error + Suggestion + Context\n\n# 示例\n\n## append - 追加到末尾\n\n```json\n{\n  \"doc_id\": \"文档ID或URL\",\n  \"mode\": \"append\",\n  \"markdown\": \"## 新章节\\n\\n追加的内容...\"\n}\n```\n\n## replace_range - 按标题替换章节\n\n```json\n{\n  \"doc_id\": \"文档ID或URL\",\n  \"mode\": \"replace_range\",\n  \"selection_by_title\": \"## 功能说明\",\n  \"markdown\": \"## 功能说明\\n\\n更新后的内容...\"\n}\n```\n\n## insert_before / insert_after - 插入内容\n\n```json\n{\n  \"doc_id\": \"文档ID或URL\",\n  \"mode\": \"insert_after\",\n  \"selection_with_ellipsis\": \"```python...```\",\n  \"markdown\": \"**输出示例**：\\n```\\nresult = 42\\n```\"\n}\n```\n\n## overwrite - 完全覆盖\n\n⚠️ 会清空文档后重写，可能丢失图片、评论等，仅在需要完全重建文档时使用。\n\n```json\n{\n  \"doc_id\": \"文档ID或URL\",\n  \"mode\": \"overwrite\",\n  \"markdown\": \"# 新文档\\n\\n全新的内容...\"\n}\n```\n\n# 最佳实践\n\n## 小粒度精确替换\n\n修改文档内容时，**定位范围越小越安全**。尤其是表格、分栏等嵌套块，应精确定位到需要修改的文本。图片/画板/电子表格等 token 内容无法重建，替换时应避开。\n\n**示例**：表格单元格中有图片和文字，只需修改文字\n- ❌ 替换整个表格或整行 → 可能破坏图片引用\n- ✅ 只定位需要修改的文本 → 图片等其他内容不受影响\n\n不确定定位时，先用 fetch-doc 确认内容。\n\n修改多处内容时，优先使用多次小范围更新（replace_range/insert），而非 overwrite 重写整篇。分步更新保留原有媒体内容、评论、协作历史，更安全可靠。\n\n## insert 模式注意插入位置\n\n扩大定位范围来唯一定位时，插入位置基于匹配范围的**边界**：\n- `insert_after` → 插入在匹配范围的**结尾**之后\n- `insert_before` → 插入在匹配范围的**开头**之前\n\n扩大范围时，确保边界仍然是期望的插入点。\n\n## 修复画板语法错误\n\n当 create-doc 或 update-doc 返回画板写入失败的 warning 时：\n1. warning 中包含 whiteboard 标签（如 `<whiteboard token=\"xxx\"/>`）\n2. 分析错误信息，修正 Mermaid/PlantUML 语法\n3. 用 `replace_range` 替换：`selection_with_ellipsis` 使用 warning 中的 whiteboard 标签，`markdown` 提供修正后的代码块\n4. 重新提交验证\n\n## 注意事项\n\n- ** Markdown 语法**：支持飞书扩展语法，详见 create-doc 工具描述\n",​
            "Tags": [​
              "22"​
            ]​
          }​
        ]​
      }​
    ]​
  }​
}​

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	MissingParameter.MCPToolsetId	The required parameter MCPToolsetId is not supplied.	参数MCPToolsetId不能为空。

AgentKit