协作消息与会话(用户授权)
提供完整的即时通讯功能,包括会话管理、成员管理、消息管理。支持单聊、群聊等多种会话类型,满足不同场景下的消息管理需求。
更新记录
| 日期 | 更新内容 |
|---|---|
| 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及会话类型创建会话
输入说明
txt
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、标题、状态、类型等,支持分页查询
输入说明
txt
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获取会话群成员列表,支持分页查询
输入说明
txt
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)
工具描述
搜索会话成员,支持分页查询
输入说明
txt
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、标题、类型等,支持分页查询
输入说明
txt
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)
工具描述
搜索会话消息详情信息,支持分页查询
输入说明
txt
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)
工具描述
支持按时间段查询会话历史消息列表
输入说明
txt
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)