# TiMEM Space

> TiMEM 长期记忆与知识管理平台。通过 MCP 协议提供 21 个工具：记忆召回/创建/删除、
> 经验规则学习与召回、知识库检索与写入、对话管理、额度查询、通知管理。
> 鉴权方式：X-API-Key 请求头。Agent 连接前需用户通过 connect 端点获取 API Key。

## MCP 连接

- [MCP Server](https://api.space.timem.cloud/mcp/): StreamableHTTP transport，连接时需 X-API-Key 头
- [获取 API Key](https://api.space.timem.cloud/api/v1/connections/agents/{agent_id}/connect): POST，用户 JWT 鉴权后调用，返回 api_key 和 mcp_config
- [验证连接配置](https://api.space.timem.cloud/api/v1/connections/mcp-config?agent_id={agent_id}): GET，用 JWT 或已有 API Key 鉴权，返回 MCP 配置
- [OpenAPI Schema](https://api.space.timem.cloud/openapi.json): 完整 REST API 定义
- [API 文档](https://api.space.timem.cloud/docs): Swagger UI 交互式文档

## 工具清单

- search_memories: 语义/关键词召回记忆。当可能需要历史偏好、事实或上下文时使用
- create_memory: 从 1-4 轮对话创建记忆。仅在用户明确要求记住/保存，或确认了跨会话事实时调用
- delete_memory: 按 ID 软删除记忆。删除前需搜索并确认
- classify_memory_scene: 将对话分类为 general/coding/writing 域。域不明确时在 search/create 前调用
- ready: 验证 MCP 鉴权和本地 DB 连通性。安装/升级后或其他工具报鉴权/网络错误时使用
- learn_rule: 从确认的场景及其结果创建或合并经验规则。规则向量化存储，可后续召回
- recall_rules: 为当前查询召回候选经验规则。用户询问如何处理某情况且历史规则可能有帮助时使用
- record_rule_outcome: 记录召回的规则是否有帮助。反馈用于改进未来规则排序
- list_rules: 列出 TiMEM Cloud 上存储的经验规则，支持状态过滤
- search_knowledge: 语义检索知识库。用户问题可能由知识库文档回答时使用
- write_knowledge: 写入文本片段到知识库并触发向量化。用户明确要求保存知识时使用
- list_knowledge_bases: 列出当前用户可访问的知识库
- create_knowledge_base: 创建新知识库用于组织文档
- list_conversations: 分页列出用户对话。需要查找或回顾现有对话时使用
- create_conversation: 创建新对话。无合适对话时在 send_message 前调用
- send_message: 在对话中发送消息并等待完整回复（非流式）。响应含助手回复和费用信息
- get_messages: 获取对话所有消息。用于读取历史或验证 send_message 结果
- get_credits_balance: 查询用户额度余额和月度用量。send_message 前检查余额，或用户询问余额时使用
- get_credits_usage: 分页查询用户 AI 用量/费用历史。用户询问消费或用量详情时使用
- list_notifications: 列出用户最近通知和未读数。用户询问更新，或定期检查重要提醒时使用
- mark_notification_read: 标记特定通知为已读。用户确认提醒后调用