---
docType: mcp
---

# 云文档

支持搜索和查询云文档。

## 更新记录

| 日期 | 更新内容 |
|------|----------|
| 2026/01/08 | 更新到版本 2.0.0 |
| 2025/09/04 | 工具第一次上线 |

## 概况

| Tool Name | 工具名称 |
|----------|----------|
| kso_yundoc_search_yundoc | 搜索云文档 |
| kso_yundoc_extract_yundoc_content | 查询云文档内容 |
| kso_yundoc_extract_yundoc_comment | 查询云文档的评论内容 |
| kso_yundoc_get_file_meta | 获取文件信息 |
| kso_yundoc_open_link | 开启文件分享 |
| kso_yundoc_permissions_batch_create | 单个文件批量授权 |
| kso_yundoc_permissions_batch_delete | 单个文件批量移除权限 |

## 权限依赖
`delegated:kso.mcp_yundoc.readwrite`
## 地址
服务URL: https://openapi.wps.cn/mcp/v2/kso-yundoc/message

## Tools
本MCP Server提供以下tools:

### 1. 搜索云文档（kso_yundoc_search_yundoc）

#### 工具描述
根据关键字和类型搜索云文档，返回匹配的文档信息列表

#### 输入说明
```
keyword：string类型，必填（搜索关键字，用于在云文档中搜索相关内容）
page_size：number类型，可选（每页返回的文档数量，范围1-10，默认为1）
type：string类型，可选（文档搜索类型：file_name(文件名)、content(正文)、all(全部)，默认为all）
```

### 2. 查询云文档内容（kso_yundoc_extract_yundoc_content）

#### 工具描述
提取指定云文档内容，以markdown形式返回文档内容

#### 输入说明
```
file_id：string类型，可选（文档ID，用于标识要提取内容的文档）
file_url：string类型，可选（文档URL，用于解析出文档ID）
drive_id：string类型，必填（驱动器ID，用于标识文档所在的驱动器）
```

### 3. 查询云文档的评论内容（kso_yundoc_extract_yundoc_comment）

#### 工具描述
提取指定云文档的评论内容，仅适用于docx格式的文档

#### 输入说明
```
file_id：string类型，必填（文件ID）
drive_id：string类型，必填（驱动器ID）
```

### 4. 获取文件信息（kso_yundoc_get_file_meta）

#### 工具描述
通过文件id获取文件相关信息如文件创建者信息、驱动盘信息、文件信息

#### 输入说明
```
file_id：string类型，必填（文件ID）
```

### 5. 开启文件分享（kso_yundoc_open_link）

#### 工具描述
打开文件分享，支持设置权限范围、权限角色、过期时长等

#### 输入说明
```
file_id：string类型，必填（文件ID）
```

### 6. 单个文件批量授权（kso_yundoc_permissions_batch_create）

#### 工具描述
支持给用户授权权限角色

#### 输入说明
```
file_id：string类型，必填（文件ID）
```

### 7. 单个文件批量移除权限（kso_yundoc_permissions_batch_delete）

#### 工具描述
批量移除文件的用户权限

#### 输入说明
```
file_id：string类型，必填（文件ID）
```