团队AI洞察
团队AI洞察 MCP Server (Team AI Insight) 是一个专门用于团队管理和 AI 使用情况分析的 MCP 服务器。它帮助团队管理者了解成员信息和 AI 使用情况,支持成员管理和会话记录查询功能。
功能概述
| 功能模块 | 描述 |
|---|---|
| 成员管理 | 获取团队成员列表,支持分页和搜索 |
| 会话分析 | 查询成员的 AI 会话记录和使用情况 |
| 智能识别 | 自动识别当前用户所在团队 |
| 权限控制 | 基于角色的访问权限管理 |
核心特性
- 智能团队识别 - 自动识别当前用户所在的团队,无需手动指定
- 角色权限管理 - 区分创建者、管理员和普通成员的权限
- 多维度分析 - 支持按时间、模型类型等维度分析使用情况
- 安全可靠 - Token 认证和敏感信息脱敏
MCP 工具列表
1. get_team_members
功能: 获取当前团队的成员列表
自动获取当前用户所在团队的成员信息,支持分页和搜索功能。返回成员的基本信息、角色、加入时间和积分余额等数据。
智能团队识别: 系统会自动识别当前用户所在的团队。如果用户属于多个团队,优先选择用户是创建者或管理员的团队。
权限要求: 调用者需要是该团队的成员
参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
page_num | int | 否 | 页码,默认为 1 |
page_size | int | 否 | 每页数量,默认为 10 |
phonenumber | string | 否 | 按手机号搜索,支持模糊匹配 |
member_nickname | string | 否 | 按团队内备注名搜索,支持模糊匹配 |
返回字段:
| 字段名 | 类型 | 说明 |
|---|---|---|
team_id | Long | 当前使用的团队 ID |
memberId | Long | 成员记录 ID |
userId | Long | 用户 ID(查询会话记录时需要此 ID) |
nickName | String | 用户昵称 |
phonenumber | String | 手机号 |
avatar | String | 头像 URL |
memberRole | String | 成员角色 |
memberNickname | String | 团队内备注名 |
credits | Integer | 当前积分余额 |
joinTime | Date | 加入时间 |
使用方式:
在 AI 对话中,您可以直接说:
- "帮我查看团队成员列表"
- "搜索手机号包含138的成员"
- "查找备注名是张三的成员"
2. get_team_member_conversations
功能: 获取团队成员的 AI 会话记录
查询当前团队中指定成员在时间范围内的 AI 对话会话列表。可用于分析成员的 AI 使用情况、模型偏好和使用频率等。
智能团队识别: 系统会自动使用当前用户所在的团队,无需手动指定团队 ID。
使用流程:
- 先调用
get_team_members获取团队成员列表 - 从返回结果中获取目标成员的
userId - 使用该
userId调用本接口查询会话记录
权限要求:
- 调用者必须是团队的创建者(角色0)或管理员(角色1)
- 被查询的用户必须是该团队的成员
参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
user_id | int | 是 | 要查询的成员用户 ID |
start_time | string | 是 | 查询开始时间,格式: yyyy-MM-dd HH:mm:ss |
end_time | string | 是 | 查询结束时间,格式: yyyy-MM-dd HH:mm:ss |
endpoint_type | string | 否 | AI 端点类型过滤 |
支持的 AI 端点类型:
| 类型 | 说明 |
|---|---|
claude | Claude 系列模型 |
codex | Codex/GPT 系列模型 |
gemini | Gemini 系列模型 |
返回字段:
| 字段名 | 类型 | 说明 |
|---|---|---|
team_id | Long | 当前使用的团队 ID |
id | String | 会话 ID |
aid | String | 用户代理 ID |
userId | Long | 用户 ID |
endpointType | String | 使用的 AI 端点类型 |
model | String | 使用的具体模型名称 |
messageCount | Integer | 会话中的消息总数 |
userMessageCount | Integer | 用户发送的消息数 |
createdAt | Date | 会话创建时间 |
updatedAt | Date | 会话最后更新时间 |
使用方式:
在 AI 对话中,您可以直接说:
- "查看张三这个月的AI使用记录"
- "帮我统计小王1月份用了多少次Claude"
- "查看团队成员最近7天的AI使用情况"
成员角色说明
| 角色值 | 角色名称 | 权限说明 |
|---|---|---|
| 0 | 创建者 | 团队所有者,拥有所有权限 |
| 1 | 管理员 | 可查看成员会话记录 |
| 2 | 普通成员 | 仅可查看成员列表 |
使用场景
1. 团队管理者分析成员 AI 使用情况
在 AI 对话中说:"帮我看看团队成员这个月的AI使用情况"
2. 统计特定时间段内的会话数量
在 AI 对话中说:"统计小王过去7天的Claude使用次数"
3. 按手机号或备注名搜索成员
在 AI 对话中说:"帮我找一下手机号138开头的团队成员"
权限控制
| 功能 | 创建者 | 管理员 | 普通成员 |
|---|---|---|---|
| 查看成员列表 | ✅ | ✅ | ✅ |
| 查看会话记录 | ✅ | ✅ | ❌ |
安全特性
| 特性 | 说明 |
|---|---|
| Token 认证 | 所有请求需携带有效 Token |
| 身份验证 | 自动验证用户团队成员身份 |
| 信息脱敏 | 敏感信息(如 API 密钥)部分脱敏 |
| 权限检查 | 基于角色的访问控制 |
提示
团队 AI 洞察 MCP 服务随 Evol 应用自动启动,无需手动配置。团队管理者可以通过 AI 对话自然地查询团队成员信息和使用情况。
