---
docType: mcp
---

# 多维表格（用户授权）

支持用户对企业内WPS多维表格创建、检索和更新（仅支持多维表格，暂不支持智能表格等其他格式）。

## 更新记录

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

## 概况

| Tool Name | 工具名称 |
|----------|----------|
| kso_dbsheet_get_file_schema | 获取文件信息 |
| kso_dbsheet_create_sheet | 创建工作表sheet |
| kso_dbsheet_update_sheet | 更新工作表名称 |
| kso_dbsheet_list_sheet_records | 获取工作表记录 |
| kso_dbsheet_create_sheet_records | 创建记录 |
| kso_dbsheet_update_sheet_records | 更新记录 |

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

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

### 1. 获取文件信息（kso_dbsheet_get_file_schema）

#### 工具描述
根据文件ID获取数据表文件的基础信息，返回信息：文件基本信息（名称、创建时间等）、所有工作表信息（名称、ID、字段信息等）

#### 输入说明
```
keyword：string类型，可选（文件搜索关键字，用于查询所有符合的文件）
fileID：string类型，可选（文件ID，用于标识要获取结构的数据表文件）
fileURL：string类型，可选（文件URL，用于解析出文件ID）
```

### 2. 创建工作表sheet（kso_dbsheet_create_sheet）

#### 工具描述
在指定的多维表格中创建新的sheet表（仅支持多维表格，暂不支持智能表格等其他格式）

#### 输入说明
```
keyword：string类型，可选（文件搜索关键字，用于查询所有符合的文件）
fileID：string类型，可选（文件ID，要在其中创建工作表的数据表文件）
fileURL：string类型，可选（文件URL，用于解析出文件ID）
sheetName：string类型，必填（工作表名称，在同一文件中必须唯一）
fieldNames：array类型，必填（工作表字段名称列表，字符串数组，定义工作表的列结构，例如：[\"姓名\", \"年龄\", \"邮箱\"]）
```

### 3. 更新工作表名称（kso_dbsheet_update_sheet）

#### 工具描述
修改指定工作表的名称，需要指定新表的名称（仅支持多维表格，暂不支持智能表格等其他格式）

#### 输入说明
```
keyword：string类型，可选（文件搜索关键字，用于查询所有符合的文件）
fileID：string类型，可选（文件ID，包含要更新工作表的数据表文件）
fileURL：string类型，可选（文件URL，用于解析出文件ID）
sheetID：string类型，可选（工作表ID，要更新的工作表的唯一标识）
sheetName：string类型，可选（旧的工作表名称，在同一文件中是唯一的）
newSheetName：string类型，必填（新的工作表名称，在同一文件中必须唯一）
```

### 4. 获取工作表记录（kso_dbsheet_list_sheet_records）

#### 工具描述
获取指定工作表中的所有数据内容（仅支持多维表格，暂不支持智能表格等其他格式），支持按分页查询以及按照字段筛选对应列输出

#### 输入说明
```
fileID：string类型，可选（文件ID，包含要查询记录的工作表的数据表文件）
fileURL：string类型，可选（文件URL，用于解析出文件ID）
sheetID：string类型，可选（工作表ID，要查询记录的工作表的唯一标识）
sheetName：string类型，可选（工作表名称，要查询记录的工作表的名称，在同一文件中是唯一的）
fieldNames：array类型，可选（列名称数组，字符串数组，要返回的字段名称数组。每个元素为工作表中的列名，仅返回指定列的数据。若不传则返回全部字段，与fieldIDs二选一，例如：[\"姓名\", \"年龄\"]）
fieldIDs：array类型，可选（列ID数组，字符串数组，要返回的字段ID数组。每个元素为工作表中的列ID，仅返回指定列的数据。若不传则返回全部字段，与fieldNames二选一，例如：[\"fld123\", \"fld456\"]）
pageSize：number类型，可选（每页数量，分页获取记录时的每页大小，默认值为100，最大值为1000）
pageToken：string类型，可选（分页起始位置，是上次响应返回的游标，用于继续拉取下一页数据（首页调用时可省略）。每次返回结果中会包含下次调用时的pageToken，如果没有更多数据则不返回。如果调用返回pageToken，下次调用必须携带）
```

### 5. 创建记录（kso_dbsheet_create_sheet_records）

#### 工具描述
在指定工作表中批量创建新的数据记录（仅支持多维表格，暂不支持智能表格等其他格式）

#### 输入说明
```
keyword：string类型，可选（文件搜索关键字，用于查询所有符合的文件）
fileID：string类型，可选（文件ID，包含目标工作表的数据表文件）
fileURL：string类型，可选（文件URL，用于解析出文件ID）
sheetID：string类型，可选（工作表ID，要创建记录的工作表的唯一标识）
sheetName：string类型，可选（工作表名称，在同一文件中必须唯一）
records：array类型，必填（记录数组，每个元素为对象，包含：
  - fields_value：string类型，必填（JSON格式的字段值映射，是JSON字符串，实际结构体是map，key是单元格名称或id，value是需要填入单元格的值。自动类型仅可自动生成，不允许填入或手动更新。自动类型包含auto_number、created_by、created_time、last_modified_by、last_modified_time、formula、look_up）
  示例：[{\"fields_value\":\"{\\\"姓名\\\":\\\"张三\\\",\\\"年龄\\\":25}\"}, {\"fields_value\":\"{\\\"姓名\\\":\\\"李四\\\",\\\"年龄\\\":30}\"}]）
```

### 6. 更新记录（kso_dbsheet_update_sheet_records）

#### 工具描述
指定工作表中批量更新数据记录（仅支持多维表格，暂不支持智能表格等其他格式）

#### 输入说明
```
fileID：string类型，可选（文件ID，包含目标工作表的数据表文件）
fileURL：string类型，可选（文件URL，用于解析出文件ID）
sheetID：string类型，可选（工作表ID，要更新记录的工作表的唯一标识）
sheetName：string类型，可选（工作表名称，要更新记录的工作表的名称，在同一文件中是唯一的）
records：array类型，必填（记录数组，每个元素为对象，包含：
  - id：string类型，必填（记录ID，例如：\"G\"）
  - fields_value：string类型，必填（JSON格式的字段值映射，是JSON字符串而不是JSON对象，实际结构体是map，key是单元格名称或id，value是需要填入单元格的值。例如：\"{\\\"文本\\\":\\\"新的文本\\\",\\\"日期\\\":\\\"2024/12/21\\\"}\"）
  示例：[{\"id\":\"G\", \"fields_value\":\"{\\\"文本\\\":\\\"新的文本\\\",\\\"日期\\\":\\\"2024/12/21\\\"}\"}]）
```