---
docType: mcp
---

# 协作消息与会话（用户授权）

提供完整的即时通讯功能，包括会话管理、成员管理、消息管理。支持单聊、群聊等多种会话类型，满足不同场景下的消息管理需求。

## 更新记录

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

## 概况

| Tool Name | 工具名称 |
|----------|----------|
| kso_message_create_chat | 创建会话 |
| kso_message_get_chat_list | 获取用户会话列表 |
| kso_message_list_chat_members | 获取会话成员列表 |
| kso_message_search_chat_members | 搜索会话成员 |
| kso_message_search_chats | 搜索会话 |
| kso_message_search_messages | 搜索消息 |
| kso_message_get_chat_messages | 会话历史消息列表 |

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

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

### 1. 创建会话（kso_message_create_chat）

#### 工具描述
基于用户id及会话类型创建会话

#### 输入说明
```
type：string类型，必填（会话类型：p2p(一对一) 或 group(群聊)）
member_names：array类型，可选（会话成员姓名/邮箱等关键字列表，字符串数组，与member_ids二选一使用；创建p2p会话时只需传入对方姓名，系统会自动添加当前用户；创建群聊时长度1-100，例如：[\"张三\", \"李四\"]）
member_ids：array类型，可选（会话成员ID列表，字符串数组，与member_names二选一使用；创建p2p会话时只需传入对方成员ID，系统会自动添加当前用户；创建群聊时长度1-100，例如：[\"user1\", \"user2\"]）
owner_name：string类型，可选（群主姓名/邮箱等关键字，与owner_id二选一使用，当type为群聊时必填）
owner_id：string类型，可选（群主成员ID，与owner_name二选一使用，当type为群聊时必填）
name：string类型，可选（群聊名称，仅当type为群聊时需要，未填写则默认用成员名称拼接）
avatar：string类型，可选（群聊头像对应的资源存储key，仅当type为群聊需要）
is_join_approve：string类型，可选（是否开启【群主所属企业的人员进群需审核】，true/false）
is_owner_admin_modify：string类型，可选（是否开启【仅群主和管理员可修改群信息】，true/false）
is_owner_admin_at_all：string类型，可选（是否开启【仅群主和管理员可@所有人】，true/false）
is_enable_nickname：string类型，可选（是否开启【群昵称优先展示】，true/false）
```

### 2. 获取用户会话列表（kso_message_get_chat_list）

#### 工具描述
获取用户的会话列表包括会话id、标题、状态、类型等，支持分页查询

#### 输入说明
```
page_size：number类型，可选（每页返回的记录数量，默认为20，最大值为100）
page_token：string类型，可选（分页token，用于获取下一页数据，不传入时表示获取第一页）
start_time：string类型，可选（起始时间，RFC3339格式(如：2024-01-01T00:00:00Z)，过滤指定时间之后的会话）
end_time：string类型，可选（结束时间，RFC3339格式(如：2024-01-02T23:59:59Z)，过滤指定时间之前的会话）
```

### 3. 获取会话成员列表（kso_message_list_chat_members）

#### 工具描述
基于会话id获取会话群成员列表，支持分页查询

#### 输入说明
```
chat_id：string类型，必填（会话ID）
page_size：number类型，可选（每页返回的记录数量，默认为20，最大值为100）
page_token：string类型，可选（分页token，用于获取下一页数据）
type：string类型，可选（成员类型，默认值为用户）
with_total：string类型，可选（是否返回total字段，true/false，默认false）
with_group_ext_attrs：string类型，可选（是否返回群聊成员扩展字段，true/false，默认false）
with_ext_attrs：string类型，可选（是否返回自定义扩展字段，true/false，默认false）
```

### 4. 搜索会话成员（kso_message_search_chat_members）

#### 工具描述
搜索会话成员，支持分页查询

#### 输入说明
```
page_size：number类型，必填（分页大小，范围[1,50]）
chat_id_list：array类型，必填（会话ID列表，字符串数组，最多50个会话，例如：[\"chat1\", \"chat2\"]）
page_token：string类型，可选（分页token，用于获取下一页数据）
keyword：string类型，可选（搜索关键字，用于搜索成员名称等）
with_member_detail：string类型，可选（是否返回成员详情（用户名称，头像等），true/false）
```

### 5. 搜索会话（kso_message_search_chats）

#### 工具描述
搜索会话id、标题、类型等，支持分页查询

#### 输入说明
```
page_size：number类型，必填（分页大小，范围[1,50]）
keyword：string类型，必填（搜索关键字，用于搜索会话名称等）
page_token：string类型，可选（分页token，用于获取下一页数据）
filter_chat_type_list：array类型，可选（会话类型过滤，字符串数组，支持p2p(单聊)、group(群聊)等，例如：[\"p2p\", \"group\"]）
with_total：string类型，可选（是否返回搜索到的总条数，支持\"true\"/\"false\"字符串）
with_group_ext_attrs：string类型，可选（是否返回群聊额外信息，支持\"true\"/\"false\"字符串）
```

### 6. 搜索消息（kso_message_search_messages）

#### 工具描述
搜索会话消息详情信息，支持分页查询

#### 输入说明
```
page_size：number类型，必填（分页大小，范围[1,50]）
keyword：string类型，可选（搜索关键字，与chat_id_list、sender_id_list、时间范围四者必传其一）
chat_id_list：array类型，可选（会话ID列表，字符串数组，最多50个会话，例如：[\"chat1\", \"chat2\"]）
page_token：string类型，可选（分页token，用于获取下一页数据）
filter_chat_type_list：array类型，可选（会话类型过滤，字符串数组，支持p2p、group等，例如：[\"p2p\", \"group\"]）
msg_type_list：array类型，可选（消息类型过滤，字符串数组，默认为all，例如：[\"text\", \"image\"]）
filter_msg_tag_list：array类型，可选（消息内容标签过滤，字符串数组）
start_time：number类型，可选（起始时间（秒级时间戳））
end_time：number类型，可选（结束时间（秒级时间戳））
sender_id_list：array类型，可选（消息发送者ID列表，字符串数组，最多50个，例如：[\"user1\", \"user2\"]）
order：string类型，可选（按时间排序方式，asc(升序)或desc(降序)，默认desc）
filter_unread：string类型，可选（是否只返回未读消息，支持\"true\"/\"false\"字符串）
with_chat：string类型，可选（是否展开会话信息，支持\"true\"/\"false\"字符串）
```

### 7. 会话历史消息列表（kso_message_get_chat_messages）

#### 工具描述
支持按时间段查询会话历史消息列表

#### 输入说明
```
chat_id：string类型，必填（会话ID）
page_size：number类型，必填（每页返回的记录数量，范围[1,50]，默认为20）
page_token：string类型，可选（分页token，用于获取下一页数据）
start_time：number类型，可选（历史消息的起始时间（秒级时间戳））
end_time：number类型，可选（历史消息的结束时间（秒级时间戳））
order：string类型，可选（按时间排序方式，asc(升序)或desc(降序)，默认desc）
filter_unread：string类型，可选（是否只返回未读消息，true/false）
filter_mention_me：string类型，可选（是否只返回@我消息，true/false）
```